新增 Superpowers、Claude HUD、Karpathy Skills 安裝筆記

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

andrej-karpathy-skills-notes.md

@@ -0,0 +1,107 @@
+# Andrej Karpathy Skills 安裝與使用筆記
+
+## 基本資訊
+
+- **專案**: https://github.com/forrestchang/andrej-karpathy-skills
+- **作者**: Forrest Chang（forrestchang）
+- **授權**: MIT
+- **類型**: Claude Code 外掛（plugin/skill）＋ 可貼到 CLAUDE.md 的規則集
+- **靈感來源**: [Andrej Karpathy 對 LLM coding 缺陷的觀察](https://x.com/karpathy/status/2015883857489522876)
+- **安裝日期**: 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 對話中執行：
+
+```text
+/plugin marketplace add forrestchang/andrej-karpathy-skills
+/plugin install andrej-karpathy-skills@karpathy-skills
+/reload-plugins
+```
+
+### 方法 B：直接放到專案 CLAUDE.md
+
+```bash
+# 新專案
+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 更小、更聚焦
+
+## 常用檢查
+
+```bash
+# 既有 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：偏向「謹慎優先於速度」；瑣碎任務自行拿捏。