跳轉到

Superpowers：把「資深工程師紀律」編碼成 Markdown 的 Claude Code Skill 框架

整理自官方 repo 與外部解析（見文末），2026-06-19。Superpowers 是 2026 年最紅的 Claude Code skills 框架之一,核心主張:AI coding agent 缺的不是能力,而是紀律,而紀律可以用純文字散佈。

一句話

由 Jesse Vincent（GitHub obra）與 Prime Radiant 團隊開發的 agentic skills 框架 + 軟體開發方法論。MIT 授權,GitHub 約 233k★(2026-06),自 2026-01-15 起被收進 Anthropic 官方 Claude Code plugin marketplace。相容 Claude Code、Cursor、Codex、Copilot CLI、Gemini CLI、OpenCode 等。

解決什麼痛點

它針對 agent 反覆出現的失敗:

  • 先寫 code 才補測試
  • 沒驗證就宣稱 bug 修好
  • 沒真的跑就說「build passed」

作者點出關鍵:這些不是知識缺口（模型訓練裡早有正確概念），而是紀律缺口——所以解法是用 checklist 與「鐵律」強制不抄捷徑。

七階段強制工作流

每個任務跑一輪:

  1. Brainstorm — 先問清楚、提設計方案,未被接受前不准寫 code
  2. Git Worktree — 開隔離分支工作區、建立測試 baseline
  3. Plan — 拆成 2–5 分鐘的小任務,寫死檔案路徑與驗證步驟
  4. Subagent-Driven Dev — 派全新 subagent,只給它 plan 與 tests
  5. TDD — 強制 red → green → refactor
  6. Code Review — 第二個 agent 依 plan 審查,按嚴重度回報
  7. Finish Branch — 要求 agent 真的跑指令、讀輸出才能宣稱完成,再給 merge/PR 選項

機制:skill 就是 Markdown

  • 14 個 skill,各是一個 SKILL.md（YAML frontmatter + 內文）。
  • 每個 skill 有:
  • Iron Law（鐵律）:大寫、不可妥協的規則,例如 NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST
  • Red flags 表:agent 常用來「合理化跳過規則」的藉口清單
  • session-start hook 注入一份 < 2000 token 的 bootstrap,叫 agent 動作前先載相關 skill。
  • 不需要 fine-tune、不需要專屬 SDK,純文字觸發行為。

Subagent 隔離為什麼重要

把實作派給只拿到 plan + tests 的全新 subagent,再派第二個 agent 審查結果。這種隔離讓 agent 無法把前面累積的捷徑帶下去。

已知限制

作者坦言:規模放大後浮現「agentic slop PR 問題」——單一任務層級的紀律已成立,但協調大量 subagent 成了下一個難題,需要額外的編排層。

為什麼對你的工作流有用

  • 它的 plan → subagent dev → review 三段,幾乎就是「規劃 → 寫 code → 獨立驗收」的制度化版本。
  • 「鐵律:跑了、讀了輸出才能說 done」正好對應不採信 agent 自我驗證這條教訓。
  • 相容 Codex,可直接套進現有 Claude + Codex 分工。

參考來源