总序
这套书的最大野心：让你看完之后，再也不用问"这个任务该用哪个 AI 工具"。
这套书是什么
这不是 9 本工具说明书，也不是一篇又一篇博客拼起来的合订本。
它是把 ai-coding-guide 仓库里两年沉淀的 10 款主流 AI 编程工具教程 + 7 套通用方法论 + 多个端到端实战脚本，按 读者画像 而不是按工具，重新编排成的渐进式读物。
工具会换代，方法论永生。所以这套书的结构是：先教你方法，再用工具佐证。
三卷分别给谁
| 卷 | 适合谁 | 看完能做什么 |
|---|---|---|
| 卷一 · 入门 | AI 编程零基础 / 只用过 Tab 补全 | 从命令行 Agent 到 IDE 集成，4 款主流工具任选其一独立完成日常任务 |
| 卷二 · 工作流 | 已经会用 1-2 款工具，想把效率往上拔 | 多工具组合、Skill / Hook / Subagent 编排、典型场景的端到端剧本 |
| 卷三 · 架构 | 团队 lead / 平台工程师 / CTO | 把 AI 编程接进 CI、安全策略、企业治理；MCP 生态选型 |
别册 是一页 cheatsheet.md——所有工具关键命令、配置文件、组合方案的横向速查。案头放一份，每天翻两眼。
怎么读最高效
- 顺读：按卷一→卷二→卷三的顺序——是为完全新手设计的
- 挑章读：每章互相独立，目录里看到顺眼的就跳进去——卷二/卷三尤其如此
- 遇到工具不熟：随时退回卷一对应章节补课
- 别册当字典：写代码时遇到"那个命令叫啥来着"，直接搜别册
信息源与可信度
每条工具的 CLI flag、配置字段、子命令、模型名都对照过相应仓库的源码（特别是 Codex CLI 那章，6 轮源码核实）。社区博客里常见的过期信息（如 --full-auto、bubblewrap 等）已修正——任何被否决的"常识"都附了源码出处链接。
工具迭代快，每一版的"信息核实截止日期"在对应章节末尾标注。如果你看的版本距今超过 6 个月，建议先扫一眼 项目更新日志 看有没有 breaking change。
上游仓库
GitHub: jnMetaCode/ai-coding-guide — 欢迎 issue 和 PR。