Claude Code Insights｜公開的 AI 開發工具知識庫

The Brief — 為自己（也為社群）建立一份可被查閱的 Claude Code 指南

Claude Code 是 Anthropic 推出的命令列 AI 開發助理。它跟 ChatGPT 式的對話工具不一樣——可以直接讀寫檔案、跑指令、整合進 CI 管線，更像是「一個可被你訓練成熟悉你專案的隊友」。

但這個工具的能力比官方文件更新得快。當你開始大量使用，會發現很多「該不該這樣做」的問題散落在 GitHub issues、Discord 頻道、別人的 dotfiles、Reddit、Hacker News 的零散分享裡——沒有一個地方統一整理。

於是我開了這個公開儲存庫：claude-code-insights。

The Challenge — 不是原創研究，而是知識架構

這個專案的難點不在「寫內容」，而在「建立可被反覆查閱的結構」。挑戰有三：

1. 資訊來源太碎、更新太快

Anthropic 的官方 docs、社群貢獻的 skills、Discord 裡的 thread、GitHub issues 的討論——每天都有新的。怎麼在不變成日誌流水帳的前提下持續吸收，是第一個要解決的問題。

2. 避免「又一份 awesome-list」的陷阱

市面上有太多 awesome-claude-code 類的連結清單。這種清單有大量連結但沒有洞察，使用者讀完還是不知道該怎麼開始。這份筆記必須給出觀點與實作建議，而不只是蒐集連結。

3. 對不同熟練度的讀者都要有用

第一次打開 Claude Code 的人、已經用了一段時間想進階的人、想把 Claude Code 帶進團隊的人——這三種讀者的需求不同，內容結構必須能兼顧。

Our Approach — 以 Anthropic 官方三核心為主幹

整個倉庫圍繞 Claude Code 最關鍵的三塊建立目錄結構：

CLAUDE.md — agent 的長期記憶與行為憲章

每次對話開始時自動讀取的檔案，等於 agent 的「工作手冊」。這份筆記涵蓋：

• 什麼該寫進 CLAUDE.md、什麼不該
• 反模式（當待辦清單用、當開發日誌用）
• 跟 .cursor/rules、.windsurfrules 的關係
• 團隊共享 vs 個人專屬的分層設計

Skills — 把重複工作模板化

把反覆執行的工作流程打包成可被召喚的能力，例如「每次寫完 feature 就跑 security review」、「每次開新 branch 就更新 changelog」。筆記包含：

• Skills 的觸發機制（明確指令 vs 自動判定）
• Skill 檔案結構（metadata、prompt、resources）
• 範例 Skills：write-prd、write-a-skill、skill-eval-toolkit、security-review

Subagents — 讓主對話保持乾淨的隔離工作區

處理「搜尋整個 codebase」、「跑一組測試並歸納錯誤」這類會吃掉大量 context 的任務。筆記拆解：

• 何時該起 subagent、何時不該
• subagent 與主 agent 的 context 界線
• 回傳格式的設計原則（摘要 vs 完整 log）

Execution — 倉庫結構與實作工具

主目錄結構

claude-code-insights/
├── core/              三大核心主題的深度指南
│   ├── claude-md/
│   ├── skills/
│   └── subagents/
├── workflows/         典型工作流範例
├── skills/            開箱即用的 Skills
│   ├── security-review/
│   ├── write-prd/
│   └── write-a-skill/
├── mcp/              常用 MCP server 設定範例
└── references/       官方文件與社群資源索引

附帶的開箱即用工具

除了三份核心指南之外，倉庫也收錄了幾組可以直接 git clone 下來使用的工具：

• 安全審查 skill：針對常見 OWASP 漏洞的自動化 code review 模板
• npm 供應鏈防禦系統：偵測可疑套件、鎖定版本、防止未授權升級
• Skills 開發工作流：write-prd → write-a-skill → skill-eval-toolkit，從需求到驗證的一整套
• MCP 設定範例：GitHub、Linear、Slack、Notion 的連接方式與 token 管理建議

更新節奏

每當有重要的官方更新、社群發現新的最佳實踐、或自己在專案中踩到值得記錄的坑，就會 commit 一次。目標是保持內容新鮮但不破壞既有結構。

Outcome — 目前為止

• 公開可被 star / fork 的 GitHub 儲存庫：任何人都可以直接使用、貢獻
• 三份核心主題指南：CLAUDE.md、Skills、Subagents 的完整拆解
• 多組開箱即用工具：security-review skill、npm 供應鏈防禦、Skills 開發工作流
• 社群可識別性：成為典億創研工作室的 AI 能力名片

Lessons — 公開建構比私藏筆記有動力

公開約束自己的品質

寫給自己看的 notes 可以很草。公開的文件必須邏輯自洽、別人看得懂、錯了會被指正。這個壓力反而讓內容品質更高。

知識密度的甜蜜點

每一段文字都應該有「如果這段被刪掉，讀者是否會錯過重要資訊」的測試。太短的篇章（20 行）內容單薄，太長的篇章（5000 字）讀者會跳過。每個主題以 1000–2000 字收斂，能讓讀者在午休時讀完一篇。

AI 工具的使用經驗是應該被分享的知識

我從很多人公開的 gist、dotfiles、openly-shared prompts 裡學到東西。這個倉庫是把我的版本也丟回去——希望能幫到下一個剛開始用 Claude Code 的人。

Next Steps — 長期計畫

• 加入更多 MCP server 的實戰設定範例
• 整理 Claude Agent SDK 的對照使用經驗
• 為團隊導入 Claude Code 寫一份 onboarding 手冊
• 開放中文版（目前主要以中英混合）

/ GITHUB / REPO

查看 GitHub 儲存庫 claude-code-insights

https://github.com/dianyike/claude-code-insights

→