resources/ 工具櫃¶
這裡像一個工具櫃。你卡住時，只拿現在需要的那張說明卡；不用從第一份讀到最後一份。
🧭 你現在卡在哪裡？¶
| 你現在想做什麼 | 先打開這一份 |
|---|---|
| 我完全沒寫過 code，不知道怎麼開始 | setup-guide.md |
| 我想照完整學習地圖開始 | 主頁 → Stage 0 |
| 我看到一個詞，但不知道意思 | 查詞卡 |
| 我分不清這四個名字：OpenRouter＝統一模型 API／router；Ollama＝本機模型 runtime；OpenCode／Pi＝coding agent／toolkit | cli-agents-guide.md |
| 我想做出第一個操作卡（Skill）、工具接頭（MCP server）或文件流程 | 實作食譜 |
| 我寫了工具說明（tool schema），但模型一直選錯工具 | schema-design-cheatsheet.md |
| 我想找能接 Notion、Office、資料庫或瀏覽器的工具 | mcp-skills-catalog.md |
| 我想選一門課，或先看證書有沒有用 | courses.md |
| 我想知道 agent 是在終端機、編輯器、雲端或自己的裝置裡工作 | agent-paradigms.md |
| 我想直接複製一個小幫手 agent（subagent）派遣範例 | subagent-cookbook.md |
| 我想自己設計、組合或排查小幫手 agent（subagent） | subagent-advanced.md |
| 我想替這個專案寫內容或送 PR | style-guide.md |
🧩 先分清楚五個詞¶
- Reference（參考資料）：卡住時回來查的補充資料，不是另一條要從頭讀完的必修課。
- Guide（指南）：帶你沿著一條清楚路線做選擇，告訴你先做什麼、下一步去哪裡。
- Cookbook（食譜）：像食譜一樣給你可照著做的完整小範例，目標是先做出成果。
- Catalog（目錄）：把很多工具放在同一處，方便搜尋和比較。
- Glossary（詞典）：先給短定義，再把你送到講得更完整的章節。
📚 全部 11 份參考資料¶
同一類型已合併在左欄。表格全部保持展開，因為讀者要先看得見有哪些入口。
| 類型 | 檔案 | 最適合什麼時候看 | 它不負責什麼 |
|---|---|---|---|
| 開始與選擇 | setup-guide.md | 第一次選 Web、Desktop、IDE、CLI 或 API | 不取代每個產品的最新官方安裝頁 |
| glossary.md | 30 秒查一個名詞 | 不取代完整章節與實作 | |
| cli-agents-guide.md | 分清模型、模型入口（router）、執行環境（runtime）與 coding agent | 不替你自動開權限或選付費方案 | |
| courses.md | 比較課程、練習深度與證書限制 | 不保證證書能換到工作 | |
| 動手與排錯 | cookbook.md | 做 Skill、MCP、Office、Gemini Notebook、Zotero 或本機 CLI 工作流 | 不把每個主題寫成一本長教材 |
| schema-design-cheatsheet.md | 工具選錯或參數常常傳錯 | 不教完整 MCP server 安裝 | |
| 搜尋與定位 | mcp-skills-catalog.md | 依工作類型找工具接頭（MCP server）或操作卡（Skill） | 收錄不代表零風險或永遠可用 |
| agent-paradigms.md | 分清 agent 跑在終端機、編輯器、雲端或自己的裝置 | 不是產品排行榜 | |
| Subagent 進階 | subagent-cookbook.md | 先複製一個小幫手 agent 的派遣範例 | 不解釋全部設計原理 |
| subagent-advanced.md | 自己設計、組合與排查小幫手 agent | 不適合第一次使用 CLI agent 時先讀 | |
| 維護專案 | style-guide.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。