|
1 | | -# AI不止语 |
| 1 | +# 总序 |
2 | 2 |
|
3 | | -> AI 编程工具迭代很快,方法论永生。 |
4 | | -> 这里是过滤后的精华——**读源码、做核实、写指南**。 |
| 3 | +> 这套书的最大野心:让你看完之后,再也不用问"这个任务该用哪个 AI 工具"。 |
5 | 4 |
|
6 | | ---- |
| 5 | +## 这套书是什么 |
7 | 6 |
|
8 | | -## 📚 内容矩阵 |
| 7 | +这不是 9 本工具说明书,也不是一篇又一篇博客拼起来的合订本。 |
9 | 8 |
|
10 | | -### 📖 三卷书:AI 编程实战 |
| 9 | +它是把 [ai-coding-guide](https://github.com/jnMetaCode/ai-coding-guide) 仓库里两年沉淀的 **10 款主流 AI 编程工具教程 + 7 套通用方法论 + 多个端到端实战脚本**,按 **读者画像** 而不是按工具,重新编排成的渐进式读物。 |
11 | 10 |
|
12 | | -把 10 款主流 AI 编程工具教程 + 7 套通用方法论 + 多个实战脚本,按读者画像重组的渐进式读本。 |
| 11 | +工具会换代,方法论永生。所以这套书的结构是:**先教你方法,再用工具佐证**。 |
13 | 12 |
|
14 | | -| 卷 | 适合 | 入口 | |
15 | | -|---|------|------| |
16 | | -| **卷一 · 入门** | AI 编程零基础 / 只用过 Tab 补全 | [开始读 →](./v1-intro.md) | |
17 | | -| **卷二 · 工作流** | 已经会用 1-2 款工具,想把效率往上拔 | [开始读 →](./v2-intro.md) | |
18 | | -| **卷三 · 架构** | 团队 lead / 平台工程师 / CTO | [开始读 →](./v3-intro.md) | |
19 | | -| **别册 · 速查手册** | 案头字典 / 30 秒选工具 | [打开 →](./cheatsheet.md) | |
| 13 | +## 三卷分别给谁 |
20 | 14 |
|
21 | | -> 想要 PDF 版?去[书的发布仓](https://github.com/jnMetaCode/ai-coding-trilogy)(即将上线)。 |
| 15 | +| 卷 | 适合谁 | 看完能做什么 | |
| 16 | +|---|--------|------------| |
| 17 | +| **卷一 · 入门** | AI 编程零基础 / 只用过 Tab 补全 | 从命令行 Agent 到 IDE 集成,4 款主流工具任选其一独立完成日常任务 | |
| 18 | +| **卷二 · 工作流** | 已经会用 1-2 款工具,想把效率往上拔 | 多工具组合、Skill / Hook / Subagent 编排、典型场景的端到端剧本 | |
| 19 | +| **卷三 · 架构** | 团队 lead / 平台工程师 / CTO | 把 AI 编程接进 CI、安全策略、企业治理;MCP 生态选型 | |
22 | 20 |
|
23 | | -### 📝 公众号「AI不止语」 |
| 21 | +**别册** 是一页 `cheatsheet.md`——所有工具关键命令、配置文件、组合方案的横向速查。案头放一份,每天翻两眼。 |
24 | 22 |
|
25 | | -技术问答 · 项目更新 · 实战长文。微信搜索 `AI_BuZhiYu`。 |
| 23 | +## 怎么读最高效 |
26 | 24 |
|
27 | | ---- |
| 25 | +- **顺读**:按卷一→卷二→卷三的顺序——是为完全新手设计的 |
| 26 | +- **挑章读**:每章互相独立,目录里看到顺眼的就跳进去——卷二/卷三尤其如此 |
| 27 | +- **遇到工具不熟**:随时退回卷一对应章节补课 |
| 28 | +- **别册当字典**:写代码时遇到"那个命令叫啥来着",直接搜别册 |
28 | 29 |
|
29 | | -## 🛠 开源项目矩阵 |
| 30 | +## 信息源与可信度 |
30 | 31 |
|
31 | | -完整 AI 编程链路——**学会用工具 → 注入方法论 → 加载专家 → 多角色编排 → 安全防护** |
| 32 | +每条工具的 CLI flag、配置字段、子命令、模型名都对照过相应仓库的源码(特别是 Codex CLI 那章,6 轮源码核实)。社区博客里常见的过期信息(如 `--full-auto`、`bubblewrap` 等)已修正——任何被否决的"常识"都附了源码出处链接。 |
32 | 33 |
|
33 | | -| 项目 | 定位 | 一句话 | |
34 | | -|------|------|------| |
35 | | -| [**ai-coding-guide**](https://github.com/jnMetaCode/ai-coding-guide) | 📖 教程主仓 | 10 工具最佳实践 + 66 Claude Code 技巧 + 7 方法论 + 配置模板 | |
36 | | -| [**ai-coding-trilogy**](https://github.com/jnMetaCode/ai-coding-trilogy) | 📚 三卷书发布仓 | 本站内容的 PDF 产品形态(CC BY-NC-SA 4.0) | |
37 | | -| [**superpowers-zh**](https://github.com/jnMetaCode/superpowers-zh) | 🧠 工作方法论 | 20 个 skills 教 AI 怎么干活(TDD / 调试 / 代码审查等) | |
38 | | -| [**agency-agents-zh**](https://github.com/jnMetaCode/agency-agents-zh) | 🎭 专家角色库 | 211 个即插即用 AI 专家(含 46 中国原创) | |
39 | | -| [**agency-orchestrator**](https://github.com/jnMetaCode/agency-orchestrator) | 🚀 编排引擎 | 一句话 → 211 专家协作出方案(9 家 LLM / 6 免费) | |
40 | | -| [**shellward**](https://github.com/jnMetaCode/shellward) | 🛡️ 安全中间件 | 8 层防御 + DLP 数据流 + 注入检测(含 MCP Server) | |
| 34 | +工具迭代快,每一版的"信息核实截止日期"在对应章节末尾标注。如果你看的版本距今超过 6 个月,建议先扫一眼 [项目更新日志](./changelog.md) 看有没有 breaking change。 |
41 | 35 |
|
42 | | ---- |
| 36 | +## 上游仓库 |
43 | 37 |
|
44 | | -## 🔬 内容标准 |
45 | | - |
46 | | -每条 CLI flag、配置字段、子命令、模型名都对照过相应仓库的源码——特别是 Codex CLI 那章,**6 轮源码核实**。社区博客里常见的过期信息(如 `--full-auto`、`bubblewrap` 等)已修正,任何被否决的"常识"都附了源码出处链接。 |
47 | | - |
48 | | -工具迭代快,每章末尾标注"信息核实截止日期"。 |
49 | | - |
50 | | ---- |
51 | | - |
52 | | -## 💼 商业合作 |
53 | | - |
54 | | -出版社 / 企业内训(10 人以上)/ 付费课程 / 演讲分享 / 咨询,请通过: |
55 | | - |
56 | | -- 公众号 **「AI不止语」** 后台留言「合作」 |
57 | | -- GitHub Issue 标题加 `[BUSINESS]` 前缀:[提交咨询](https://github.com/jnMetaCode/ai-coding-guide/issues/new?title=%5BBUSINESS%5D+) |
58 | | - |
59 | | -> License:本书内容 CC BY-NC-SA 4.0(个人免费 / 商业用途请先联系)。 |
60 | | -> 教程主仓 Apache-2.0 永久免费。 |
61 | | -> [详细 license 说明 →](https://github.com/jnMetaCode/ai-coding-guide/blob/main/book/LICENSE.zh-CN.md) |
62 | | -
|
63 | | ---- |
64 | | - |
65 | | -## 💬 渠道 |
66 | | - |
67 | | -| 平台 | 链接 | |
68 | | -|------|------| |
69 | | -| 公众号 | 「AI不止语」(搜索 `AI_BuZhiYu`) | |
70 | | -| GitHub | [@jnMetaCode](https://github.com/jnMetaCode) | |
71 | | -| X (Twitter) | [@aibuzhiyu](https://twitter.com/aibuzhiyu) | |
72 | | -| QQ 群 | [点击加入](https://qm.qq.com/q/EeNQA9xCxy)(群号 1071280067) | |
73 | | -| 微信群 | 关注公众号后回复「群」 | |
74 | | - |
75 | | ---- |
76 | | - |
77 | | -> **新读者建议** ↓ |
78 | | -> |
79 | | -> 不知道从哪开始?先读 → [**别册速查表**](./cheatsheet.md)(30 秒选工具),决定看哪一卷。 |
| 38 | +GitHub: [jnMetaCode/ai-coding-guide](https://github.com/jnMetaCode/ai-coding-guide) — 欢迎 issue 和 PR。 |
0 commit comments