`resources/` 索引¶

这是本 repo 的 reference 区：不在主路线里、需要时再查的补充材料。每份文件都有明确角色，不重复。

7 份 reference + 各自的“什么时候看”¶

文件	角色	什么时候看	行数
`glossary.zh-Hans.md`	30 秒查词典	看 stage 内容时遇到 LLM / RAG / token / agent / vector DB / streaming / batch API 不知道什么意思	~210
`cli-agents-guide.zh-Hans.md`	7 个 CLI agent 比较	第一次选 CLI agent（Claude Code / Codex / OpenCode / Gemini CLI / goose / Aider / Hermes Agent）不知道挑哪个	~134
`mcp-skills-catalog.zh-Hans.md`	62 个集成 catalog	想把 Claude Code 接 Notion / Obsidian / Excel / Postgres / Slack / 等实际工具	~775
`schema-design-cheatsheet.zh-Hans.md`	function schema 设计 5 规则 + 5 anti-pattern	写 tool schema / MCP server schema / function calling，发现 LLM 选错 tool / 传错参数	~159
`cookbook.zh-Hans.md`	6 个 step-by-step recipe	想 30-50 分钟做出第一个 Skill / MCP server / 接 Office / 接 NotebookLM / 接 Zotero / 接本机 LLM	~620
`setup-guide.zh-Hans.md`	从零开始的 setup 指南	完全没有 dev 背景、第一次申请 API key / 装 Python / 用 Claude Code	~400
`style-guide.zh-Hans.md`	送 PR 前的格式 / 用词规范	要对 repo 贡献、写 entry / 翻译	~338

合计约 ~2500 行 reference。看起来不少，但每份文件阅读的时机不同——你不会一次全读，只在对应场景查 30 秒到 45 分钟。

→ setup-guide.zh-Hans.md（30-45 分钟从零装好）

不需要先读任何 reference。直接从主路线 README → Stage 0 开始。遇到不懂的词回来查 glossary.zh-Hans.md 就好。

→ cli-agents-guide.zh-Hans.md（CLI 比较 + 按 use case 推荐）

→ mcp-skills-catalog.zh-Hans.md（62 个集成分 14 类）

→ cookbook.zh-Hans.md（6 个 step-by-step recipe）

→ glossary.zh-Hans.md（每个词 30-80 字解释 + 哪个 stage 讲细）

只在有助于导航时保留少量重叠，各文件角色仍然分开：

glossary 是“30 秒查”，stage 内容是“3-5 分钟读”，cookbook 是“30-50 分钟做”。
schema-design-cheatsheet 跟 cookbook 2 有交集，但 cheatsheet 讲 schema 规则，cookbook 讲怎么把 server 跑起来。
cli-agents-guide 是比较 reference；mcp-skills-catalog 是工具集成目录。
setup-guide 给从零开始的人；Stage 0 默认你已经准备好进入学习路线。

文件	zh-TW（canonical）	zh-Hans	English
glossary	✅	✅	✅
cli-agents-guide	✅	✅	✅
mcp-skills-catalog	✅	✅	✅
schema-design-cheatsheet	✅	✅	✅
cookbook	✅	✅	✅
setup-guide	✅	✅	✅
style-guide	✅	✅	✅

不是随便加。新文件必须：

近期考虑过但没加的：