一本正在写作的书，面向有无编程经验、希望借助 AI 做出、检查并维护自己所需软件的读者。正式书名待定。
从眼前的一项麻烦开始：说明想解决什么，让助手调查、执行和检查，再核对结果是否合用。遇到跑偏、卡住和返工时，学习怎样根据证据调整任务，把有效的做法留给下一次。
当前已有四篇中文样章讨论稿，均在修订中，教学情境尚未实测。尚无定稿章节、可运行练习或读者试做结果。
这本书使用 AI 参与写作，包括整理材料、起草和改写正文。如果你介意这种写作方式，可以选择不读。
书中许多观点、原则和需要注意的问题，来自我的日常实践。有时，我记下的只是一句判断或一段简短的经验。使用 AI，主要是希望把这些内容的来龙去脉和适用条件讲清楚，让读者更容易理解和使用。
内容取舍、事实核对与修订的责任由我承担。个人经验、教学设定和外部来源会分别说明，尚未验证的内容如实标注。具体分工见写作方法。
第一次接触 AI 编程助手，可以先读第 1 章；已有使用经验，可以从正在遇到的问题进入。
| 想弄清的问题 | 中文样章 |
|---|---|
| 不会编程，怎样开始请它帮忙？ | 第 1 章：把眼前的麻烦告诉它 |
| 说过的要求，为什么又没用上？ | 第 6 章：它现在知道什么，又会忘掉什么 |
| 已有开源实现，怎样判断能不能用？ | 第 9 章：先找成熟实现，再让 AI 补上需要的部分 |
| 改了几轮还是不对，怎样继续？ | 第 13 章：反复改不好，怎样停下来重新判断 |
第 13 章另有英文讨论稿：When Repeated Fixes Don't Work，待人工校对。本书以中文为主、英文为辅，完整英文版尚未完成；原文版本与审阅情况见翻译状态。
本书所说的 AI 编程助手，英文称为 coding agent，是能在授权范围内读取项目、修改代码、运行程序，并根据结果继续处理任务的 AI 工具，例如 Codex 和 Claude Code。具体能力取决于产品、版本和运行环境。本书围绕使用现成助手完成软件任务展开，开发 Agent 系统不在教学范围内。
暂定五部分、十九章：先做出并检查第一版，再理解助手的工作机制，随后学习项目组织、修改与交付，最后形成自己的协作方法。编程基础随任务需要解释，有经验的读者可以跳读。完整章节安排见全书脉络。
高效既看结果是否正确、改动是否便于维护，也看人工投入、等待、返工与模型用量。生成速度或 Token 数量只是其中一部分。
读者与目标已明确，大纲仍是编辑草案。教学项目和采用工具尚未确定，仓库暂保留现有名称。当前决定与待定事项以项目范围为准，章节修订情况见工作状态，练习材料见案例状态。
欢迎反馈难懂的段落、具体的使用困惑，以及能公开复现的问题。提交方式与材料要求见参与贡献。参与写作或核对内容时，可继续阅读：
原创书稿、文档、译文及非代码教学素材采用 CC BY-SA 4.0，原创代码采用 MIT，单独标明许可的文件除外。第三方内容保留原许可。转载或改编请署名、保留来源及许可链接，并说明修改；具体范围与署名要求见许可说明。