tool-notes/andrej-karpathy-skills-notes.md

Andrej Karpathy Skills 安裝與使用筆記

基本資訊

• 專案: https://github.com/forrestchang/andrej-karpathy-skills
• 作者: Forrest Chang（forrestchang）
• 授權: MIT
• 類型: Claude Code 外掛（plugin/skill）＋ 可貼到 CLAUDE.md 的規則集
• 靈感來源: Andrej Karpathy 對 LLM coding 缺陷的觀察
• 安裝日期: 2026-04-19

是什麼

一份讓 Claude Code（以及 Cursor）寫 code 時更「克制、精準、以目標為導向」的行為準則。核心觀點：LLM 擅長為了達成目標而反覆迭代，所以把「目標」定義清楚，比教它怎麼寫 code 更重要。

四大原則

1. Think Before Coding（先思考再動手）

   • 明確說出假設；不確定就問
   • 看到多種詮釋時攤開來，不要偷偷選
   • 有更簡單的做法就直說，該推回時推回

2. Simplicity First（簡單優先）

   • 只寫能解決問題的最小程式碼
   • 不做沒要求的功能、抽象、彈性、錯誤處理
   • 200 行能壓到 50 行就重寫

3. Surgical Changes（外科手術式修改）

   • 只動必要的部分，別順手「改進」相鄰程式碼
   • 不要 refactor 沒壞的東西；維持原有風格
   • 每一行變更都要能對應到使用者的請求

4. Goal-Driven Execution（目標驅動執行）

   • 把任務轉成可驗證的成功條件，例如：
     • 「加驗證」→「寫失敗測試，讓它通過」
     • 「修 bug」→「寫能重現 bug 的測試，讓它通過」
   • 多步驟任務先列計畫，每步附 verify 檢查項

安裝方式

方法 A：Claude Code Plugin（推薦）

在 Claude Code 對話中執行：

/plugin marketplace add forrestchang/andrej-karpathy-skills
/plugin install andrej-karpathy-skills@karpathy-skills
/reload-plugins

方法 B：直接放到專案 CLAUDE.md

# 新專案
curl -o CLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md

# 既有 CLAUDE.md 附加
echo "" >> CLAUDE.md
curl https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md >> CLAUDE.md

方法 C：Cursor

專案 repo 內附 .cursor/rules/karpathy-guidelines.mdc，放進你的專案即可。詳見原 repo 的 CURSOR.md。

與現有 karpathy-guidelines skill 的差異

本機 ~/.claude/skills/karpathy-guidelines/SKILL.md 已存在一份同概念 skill（Anthropic / 預設安裝），內容涵蓋完全相同的四大原則。

比較項	本機既有 skill	forrestchang plugin
位置	~/.claude/skills/karpathy-guidelines/	plugin marketplace
格式	單檔 SKILL.md	plugin 套件
可更新	手動	/plugin update
內容	四原則 + trade-off 說明	四原則 + Cursor 支援

實務建議：兩者任擇其一即可，重複安裝會讓 skill 名稱衝突。

• 若只想在 Claude Code 使用並保持簡單：維持現有 skill。
• 若要跨 Cursor / 多機器同步並接受 plugin 更新機制：改裝 plugin 版本。
• 若要在特定專案強制執行：方法 B 把 CLAUDE.md 放進 repo，團隊成員都會讀到。

成功指標（來自原作者）

• 不必要的 diff 變動變少
• 第一次嘗試就產出更簡潔的程式碼
• 實作前會先提釐清問題
• PR 更小、更聚焦

常用檢查

# 既有 skill
cat ~/.claude/skills/karpathy-guidelines/SKILL.md

# Plugin 安裝後
ls ~/.claude/plugins/marketplaces/ | grep -i karpathy
cat ~/.claude/plugins/known_marketplaces.json

# 在 Claude Code 查看 skill 列表
/skill list   # 或直接輸入 / 查看建議

備註

• Karpathy 原推文提醒的幾個 LLM 缺陷：過度抽象、加非必要功能、改到不該改的地方、沒問就猜。這份 skill 就是針對這些的反制。
• 文件開頭已聲明 trade-off：偏向「謹慎優先於速度」；瑣碎任務自行拿捏。