108 lines
3.9 KiB
Markdown
108 lines
3.9 KiB
Markdown
# 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：偏向「謹慎優先於速度」；瑣碎任務自行拿捏。
|