[YannByte]

本书面向有无编程经验的读者，帮助他们使用现成 AI 编程助手做出、检查并维护需要的软件。当前大纲为五部分、二十章；正式书名、教学项目和工具组合待定。

中文正文使用「AI 编程助手」，英文首选 coding agent，术语按官方资料核对。写作方法借鉴 ASD-STE100 Issue 9；中文规范、术语、审稿和生产流程由普通规则文件维护。Python 检查词表、翻译版本与审阅记录一致性，将明确错误与需要语境判断的建议分开。写作规则要求交代助手实际执行的工作，以及执行反馈怎样影响下一步。

复杂或需要长期打磨的能力，优先调查有维护、测试和许可依据的开源项目与库，让助手配置、适配、验证并补齐具体需求。解释已有边界处理的价值，保留兼容性、当前用法与更新成本的检查，不宣称开源必然可靠。

加入三篇中文样章：

• 第 6 章《它现在知道什么，又会忘掉什么》：以同名 PDF 隐藏路径后无法区分来源的情境，解释上下文、按需读取、对话压缩、冲突约定与验证。说明过期文档怎样再次进入任务，以及用 Git 保留历史、从当前目录清理旧规则的方法。
• 第 9 章《先找成熟实现，再让 AI 补上需要的部分》：以 PDF 正文搜索为教学情境，区分模型生成、工具反馈和开源项目的测试积累。比较完整软件、库、项目扩展与必要自写，再展开候选验证和接入。pypdf 仅为调查候选；区分未匹配与未能检索、助手读图与程序输出。
• 第 13 章《反复改不好，怎样停下来重新判断》及完整英文译稿 When Repeated Fixes Don't Work：讨论任务说明、执行条件、证据、失败干预、验收与交接。明确助手结论与输出矛盾时怎样调整任务；中英文内容已同步复核。

三章均有材料卡、来源证据及绑定版本的 AI 结构、事实与语言审阅记录，状态为 revising。教学情境未实测，尚无作者试做、读者试读或读者试做结果。第 6、9 章尚无英文译稿；第 13 章英文稿待人工审阅。

从当前目录删除 9 份旧定位、案例和计划文件及 29 份旧版审阅报告，历史由 Git 保留。删除前逐一核对内容已提交；同步清理入口、引用和不再使用的证据条目，保留当前样章、10 份当前审阅记录及有效来源。生产流程明确后续清理与找回方法。案例检查不再硬编码三个已停用案例，改为核对案例标识和已纳入仓库的案例说明，并补充回归测试。

验证：统一仓库检查通过，含 55 项仓库、流程及写作检查测试与 83 项中文规则测试。写作检查无错误，保留需人工判断的语境与术语提示。git diff --check 通过；本次清理未修改中英文样章或版本清单。自动检查不能证明符合 STE、案例有效或读者验证完成。