AI 编程工程实践手册

一套面向初中级开发者的中文开源手册，帮助你在使用 Codex、Claude Code 等 AI 编程工具时，持续产出可理解、可验证、可维护的工程变更。

本项目不承诺某个模型或提示词能自动保证质量。它关注的是一套可重复的工程系统：清晰需求、可信上下文、小步实现、自动验证、独立审查和人工责任。

适合谁

• 已掌握一门编程语言，希望建立完整交付习惯的实习生和初级开发者。
• 已在使用 AI 编程工具，但经常遇到范围膨胀、脆弱测试或上下文丢失的开发者。
• 希望为团队建立统一质量门禁、审查和训练路径的工程负责人。

30 分钟入门

1. 正确认识 AI 编程助手
2. 用工具链建立质量护栏
3. 建立项目上下文与约束
4. 从需求澄清到实施计划
5. 小步实现与范围控制
6. 测试、验证与代码审查

按任务查阅

• 写清楚任务：高质量提示方法
• 开发或修复代码：计划工作流与范围控制
• 测试和 Review：测试、验证与代码审查
• 处理高风险变更：生产质量、安全与协作
• 排查常见问题：失败模式与恢复
• 查模板和提交清单：模板与检查清单
• 练习完整交付：端到端案例

按工具查阅

• Codex 实践索引
• Claude Code 实践索引

产品配置、权限和扩展能力会变化。工具专章中的事实应结合当前官方文档和本地版本核验。

阅读与下载

• 完整章节索引：适合按主题跳转和参与维护。
• 单文件发布版：适合下载、分享和全文搜索。

维护

docs/ 下的编号章节是唯一人工编辑源。不要直接修改 dist/ 中的生成文件。

bash scripts/build-handbook.sh
bash -n scripts/build-handbook.sh
bash -n scripts/check-handbook.sh
bash -n tests/check-handbook-test.sh
bash tests/check-handbook-test.sh
bash scripts/check-handbook.sh

构建顺序由 scripts/handbook-manifest.txt 统一维护。详细要求见 CONTRIBUTING.md。

许可与社区

手册及其他 Markdown 内容采用 Creative Commons Attribution 4.0 International 许可；构建、检查、测试和 GitHub 自动化代码采用 MIT License。详细边界见许可证范围。

参与贡献即表示同意遵守 Contributor Covenant，并按所修改路径对应的许可证发布贡献。