Superpowers 是一套給 coding agent 用的軟體開發方法論,由一組可組合的 skills 加上開場指令組成,讓 agent 在對話一開始就自動套用。它把流程固定成先問清需求、寫設計、拆計畫、再進 TDD 實作與程式碼審查,而不是一看到需求就直接寫程式。與單純的規則檔不同,這些 skills 會依情境自動觸發,並支援 Claude Code、Codex、Cursor、Gemini CLI、OpenCode 等多個 harness。
multica-ai/andrej-karpathy-skills
專案簡介
以上內容由 AI 根據官方 README 整理,未經實測;指令以官方文件為準。
原始描述
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
AI 規格
主要功能
- 以四條原則約束 Claude Code 的假設、複雜度與改動範圍
- 提供 Claude Code plugin,安裝後跨專案套用
- 附 Cursor 專案規則檔,同一組指引在 Cursor 生效
- 把「新增驗證」「修 bug」等工作改寫成可驗證的成功條件
- 限制只改與需求相關的程式行,不動相鄰程式與註解
- 可與專案既有的 CLAUDE.md 指示合併使用
安裝方式
在 Claude Code 內加入 marketplace(外掛方式第一步)
/plugin marketplace add forrestchang/andrej-karpathy-skills安裝外掛,讓指引跨專案可用
/plugin install andrej-karpathy-skills@karpathy-skills在新專案下載 CLAUDE.md(逐專案方式)
curl -o CLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md在既有專案的 CLAUDE.md 後加一個空行
echo "" >> CLAUDE.md把指引內容附加到既有 CLAUDE.md
curl https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md >> CLAUDE.md
快速開始
/plugin marketplace add forrestchang/andrej-karpathy-skills設定教學
採外掛形式時在 Claude Code 內加入 marketplace 再安裝即可;採 CLAUDE.md 形式時把檔案放進專案根目錄或附加到既有 CLAUDE.md,不需要環境變數或 API 金鑰。
主要設定檔
CLAUDE.md— 四條原則的正文,可整份放進專案或與專案既有指示合併,也可在後面追加專案專屬規則.cursor/rules/karpathy-guidelines.mdc— Cursor 專案規則檔,開啟此專案時套用同一組指引skills/karpathy-guidelines/SKILL.md— 外掛形式的 skill 定義,安裝 Claude Code plugin 後由它提供指引內容.claude-plugin/plugin.json— Claude Code plugin 的中繼資料,定義外掛名稱與內容.claude-plugin/marketplace.json— marketplace 清單,讓 /plugin marketplace add 能找到並安裝這個外掛
設定內容整理自 repository 內的設定檔與文件,未經實測;變數名稱與指令以官方檔案為準。
適合用途
- 想讓 Claude Code 在動手前先講清楚假設與取捨的開發者
- 常遇到 agent 把簡單需求寫成上千行程式的團隊
- 希望在 Cursor 與 Claude Code 套用同一組規則的人
- 想用測試與成功條件驅動 agent 反覆驗證的人
常見問題
這是可執行的軟體嗎?
不是程式或服務,而是一份 CLAUDE.md 指引,加上 Claude Code plugin 與 Cursor 規則檔的包裝。它靠 Claude Code 或 Cursor 讀取這些規則來改變行為。
外掛安裝和放 CLAUDE.md 有什麼差別?
外掛形式安裝後可用於所有專案;CLAUDE.md 形式則只對放進該檔案的專案生效。兩種方式在 README 都列為安裝選項。
能跟專案自己的規則一起用嗎?
可以。README 說明這些指引設計成可與專案專屬指示合併,在既有 CLAUDE.md 追加內容,或新增「Project-Specific Guidelines」段落。
Cursor 也能用嗎?
可以。倉庫內有 .cursor/rules/karpathy-guidelines.mdc,在 Cursor 開啟此專案時會套用同一組指引,CURSOR.md 說明如何用在其他專案。
需要設定 API 金鑰或環境變數嗎?
不需要。安裝步驟只有加入 marketplace、安裝外掛或下載 CLAUDE.md,檔案中沒有出現任何環境變數或 API 金鑰設定。
小型修改也要照這四條原則走嗎?
README 建議對瑣碎任務自行判斷,不必每件事都套完整流程。這份指引偏向謹慎而非速度,目的是減少非簡單工作上的錯誤。