resources/ 工具柜¶
这里像一个工具柜。你卡住时，只拿现在需要的那张说明卡；不用从第一份读到最后一份。
🧭 你现在卡在哪里？¶
| 你现在想做什么 | 先打开这一份 |
|---|---|
| 我完全没写过 code，不知道怎么开始 | setup-guide.zh-Hans.md |
| 我想按完整学习地图开始 | 主页 → Stage 0 |
| 我看到一个词，但不知道意思 | 查词卡 |
| 我分不清这四个名字：OpenRouter＝统一模型 API／router；Ollama＝本地模型 runtime；OpenCode／Pi＝coding agent／toolkit | cli-agents-guide.zh-Hans.md |
| 我想做出第一个操作卡（Skill）、工具接头（MCP server）或文档流程 | 实践食谱 |
| 我写了工具说明（tool schema），但模型一直选错工具 | schema-design-cheatsheet.zh-Hans.md |
| 我想找能接 Notion、Office、数据库或浏览器的工具 | mcp-skills-catalog.zh-Hans.md |
| 我想选一门课，或先看证书有没有用 | courses.zh-Hans.md |
| 我想知道 agent 是在终端、编辑器、云端还是自己的设备里工作 | agent-paradigms.zh-Hans.md |
| 我想直接复制一个小助手 agent（subagent）派遣范例 | subagent-cookbook.zh-Hans.md |
| 我想自己设计、组合或排查小助手 agent（subagent） | subagent-advanced.zh-Hans.md |
| 我想替这个项目写内容或提交 PR | style-guide.zh-Hans.md |
🧩 先分清五个词¶
- Reference（参考资料）：卡住时回来查的补充资料，不是另一条要从头读完的必修课。
- Guide（指南）：带你沿着一条清楚路线做选择，告诉你先做什么、下一步去哪里。
- Cookbook（食谱）：像食谱一样给你可以跟着做的完整小范例，目标是先做出成果。
- Catalog（目录）：把很多工具放在同一处，方便搜索和比较。
- Glossary（词典）：先给短定义，再把你送到讲得更完整的章节。
📚 全部 11 份参考资料¶
同一类型已经合并在左栏。表格全部保持展开，因为读者要先看见有哪些入口。
| 类型 | 文件 | 最适合什么时候看 | 它不负责什么 |
|---|---|---|---|
| 开始与选择 | setup-guide.zh-Hans.md | 第一次选择 Web、Desktop、IDE、CLI 或 API | 不取代每个产品的最新官方安装页 |
| glossary.zh-Hans.md | 30 秒查一个名词 | 不取代完整章节与实践 | |
| cli-agents-guide.zh-Hans.md | 分清模型、模型入口（router）、运行环境（runtime）与 coding agent | 不替你自动开放权限或选择付费方案 | |
| courses.zh-Hans.md | 比较课程、实践深度与证书限制 | 不保证证书能换到工作 | |
| 动手与排错 | cookbook.zh-Hans.md | 制作 Skill、MCP、Office、Gemini Notebook、Zotero 或本地 CLI 工作流 | 不把每个主题写成一本长教材 |
| schema-design-cheatsheet.zh-Hans.md | 工具选错或参数经常传错 | 不教完整 MCP server 安装 | |
| 搜索与定位 | mcp-skills-catalog.zh-Hans.md | 按工作类型寻找工具接头（MCP server）或操作卡（Skill） | 收录不代表零风险或永远可用 |
| agent-paradigms.zh-Hans.md | 分清 agent 运行在终端、编辑器、云端还是自己的设备 | 不是产品排行榜 | |
| Subagent 进阶 | subagent-cookbook.zh-Hans.md | 先复制一个小助手 agent 的派遣范例 | 不解释全部设计原理 |
| subagent-advanced.zh-Hans.md | 自己设计、组合与排查小助手 agent | 不适合第一次使用 CLI agent 时先读 | |
| 维护项目 | style-guide.zh-Hans.md | 写 entry、翻译、表格或提交 PR | 不是普通读者的必读内容 |
🔁 看完要回哪里？¶
✅ 30 秒完成检查¶
- 我知道现在只要打开哪一份资料。
- 我没有把 catalog 当成从头读到尾的课本。
- 我看完后，知道要回主线的哪一站。
为什么不把 11 份资料合成一本书？
因为它们解决不同问题。Glossary 是 30 秒查词，Stage 是几分钟建立概念，Cookbook 是跟着做出成果，Catalog 则是需要时搜索工具。全部混成一本书，读者反而更难找到入口。
想读章节长度的中文教材，可以接着看 Hello-Agents。这个项目负责帮你找路，不重写另一套长教材。
Maintainer：三语覆盖与新增 reference 的规则
上表 11 份资料都有繁中、英文与简中版本。新增 reference 前要同时符合：
- 它有一个现有文件无法取代的工作。
- 至少三个 stage、track 或 branch 会需要它。
- 名词、URL、限制与安全规则能保持三语一致。
- 如果只服务一个章节，就留在那个章节，不另外开文件。
繁中是主版本：zh-TW 是 canonical。先用官方来源核实；找不到时明确写未知，不要猜。不要保存会不断变化的 GitHub stars、固定总数和行数。
提交修改前，再核对 MCP／Skills catalog、Cookbook、style guide 与 CONTRIBUTING。