Superpowers解剖

Transcript

1. Superpowers解剖 AI Agentに開発規律をインストールする LayerX バクラク事業部 SWE/EM tiger
2. 自己紹介 tiger / タイガー Yahoo!(PayPayカード) → Shippio(貿易系スタートアップ) → LayerX 自己紹介 LayerX バクラク事業部 SWE/EM 筋トレ グミ日記 バクラク Engineering Team Deck https://speakerdeck.com/layerx/bakuraku-engineering-team-deck © LayerX Inc. 2
3. Agentはすぐ実装したがる
4. AI Agentの典型的な失敗 AI Agentの怖さは、速くそれっぽく間違えること。 © LayerX Inc. 問題提起 要件確認を飛ばす 既存コードの流儀を見ない テストを後回しにする それっぽいbugfixを連打する 検証を実行せずに完了宣言する 4
5. でも、 、 、 skillとかAGENT.mdとか 整えるのめんどくさい
6. そこで！！ Superpowers！
7. Superpowers = 開発規律エンジン Superpowersは便利なSkill集というより、Agentが雑に開発できないようにするゲート列。 © LayerX Inc. Superpowersとは何か 設計合意なしに実装しない 曖昧なplanをAgent実行可能な粒度に落とす production codeを失敗テストで縛る root causeなしのbugfixを禁止する 完了宣言を実行結果に接続する PR作成・merge・片付けまで管理する 7
8. using-superpowers : Skillを使わせるSkill "If you think there is even a 1% chance a skill might apply" 訳: Skillが関係する可能性が1%でもあるなら、そのSkillを使う。 ⚠️ よくある落とし穴 「簡単だからSkillはいらない」 と判断する 🛠️ Superpowersの介入 回答前、調査前、質問前に Skill適用を確認する ✅ 守らせるルール Skillを知識ではなく、実行時 のゲートにする © LayerX Inc. Meta Gate 8
9. brainstorming / writing-plans : 即実装を止める "Do NOT invoke any implementation skill" "Each step is one action (2-5 minutes)" 訳: 実装Skillを呼び出すな。各ステップは1アクション、2〜5分で終わる粒度にする。 ⚠️ よくある落とし穴 曖昧な依頼を勝手に補完して 進める 🛠️ Superpowersの介入 合意前の実装を止め、planを 小さな手順へ分解する ✅ 守らせるルール 設計をAgentが迷わず実行でき る仕様に変換する © LayerX Inc. Design / Plan Gate 9
10. subagent-driven-development : 役割を分ける "Fresh subagent per task + two-stage review" 訳: タスクごとに新しいsubagentを使い、2段階レビューを挟む。 ⚠️ よくある落とし穴 1つのAgentが自分の実装を正 当化する 🛠️ Superpowersの介入 実装者、仕様レビュアー、品 質レビュアーを分ける ✅ 守らせるルール 仕様通りか、良い実装かを 別々に見る © LayerX Inc. Subagent Gate 10
11. test-driven-development : 実装力をREDで縛る "NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST" 訳: 先に失敗するテストなしでproduction codeを書いてはいけない。 ⚠️ よくある落とし穴 先にそれっぽい実装を作る 🛠️ Superpowersの介入 失敗テストを見るまで production codeを禁止する ✅ 守らせるルール 実装を要求に接続してからコ ードを書く © LayerX Inc. TDD Gate 11
12. systematic-debugging : 推測修正を止める "NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST" 訳: root cause調査なしに修正してはいけない。 ⚠️ よくある落とし穴 候補修正を高速に試して症状 だけ隠す 🛠️ Superpowersの介入 再現、recent changes、data flow、仮説検証を順に進める ✅ 守らせるルール bugfixをguess-and-checkでは なく原因調査に戻す © LayerX Inc. Debug Gate 12
13. 完了宣言を実行結果に接続する "Evidence before claims, always." 訳: 完了と言う前に、必ず検証結果を出す。 © LayerX Inc. Verify / Review / Finish Gate verification-before-completion : 今実行したcommand outputとexit codeを読む requesting-code-review : 途中でreviewerを呼び、merge可能性まで見る receiving-code-review : feedbackを盲従せず、コードベースで検証する finishing-a-development-branch : test、環境確認、PR作成、merge、片付けを順序立てる 13
14. writing-skills : Skill自体にもTDDをかける "NO SKILL WITHOUT A FAILING TEST FIRST" 訳: 先に失敗するテストなしでSkillを書いてはいけない。 ⚠️ よくある落とし穴 Skillを書けばAgentが従うと思 い込む 🛠️ Superpowersの介入 pressure scenarioでSkillなし の失敗を先に観測する ✅ 守らせるルール 開発規律を、検証しながら自 己増殖させる © LayerX Inc. Self-improvement Gate 14
15. 全Skillをライフサイクルで見る © LayerX Inc. 全体像 1 🧭 起動 / 合意 Skill適用と設計合意 using-superpowers / brainstorming 2 🗺️ 計画 / 作業場 実行仕様と作業場所 writing-plans / using-git-worktrees 3 🛠️ 実行 計画実行と責務分離 executing-plans / subagent-driven-development / dispatching-parallel-agents 4 🧪 品質 TDD、debug、検証 test-driven-development / systematic-debugging / verification-before-completion 5 🚢 終了 / 改善 レビュー、完了、自己増殖 requesting-code-review / receiving-code-review / finishing-a-development-branch / writing-skills 15 ↓ ↓ ↓ ↓
16. Superpowers / feature-dev / GSD Core 観点 Superpowers feature-dev GSD Core 一言 開発規律エンジン feature実装ランナー context管理OS 起動 Skillが場面ごとに発火 /feature-dev project / phase開始 中心 TDD / debug / verify / review DiscoveryからSummaryまで Discuss → Plan → Execute → Verify → Ship subagent implementer / spec reviewer / quality reviewer explorer / architect / reviewer fresh-context executor 得意 雑な実装を防ぐ 1機能を迷わず作る 長い作業をcontext劣化させず進める © LayerX Inc. 比較 16
17. まとめ
18. Stripe Minionsも「壁」の設計 1,300+ PR/week Stripeのunattended coding agent。人間がレビュ ーするが、PR内のコードはMinionが生成。 Slackから起動し、devbox上で実装、lint/CIを通 し、レビュー可能なPRまで進む。 🧱 Devbox 標準化・並列化・本番隔離された開発環境 🗺️ Blueprint Agentノードと決定的ノードを混ぜる状態機械 🔧 Rules / MCP 必要な文脈と道具だけを、小さく curated に渡す ✅ Feedback left lint、autofix、CIを早い段階で返して収束させる モデルの性能より、Agentが通る「壁」をどう設計するか。 Source: Stripe Dev Blog, “Minions: Stripe’s one-shot, end-to-end coding agents” Part 1/2, 2026 © LayerX Inc. Stripe Minions 18
19. Superpowersから学べること 強いAIコーディング環境は、良いプロンプトではなく、良い開発規律をAgentに実行させている。 © LayerX Inc. まとめ Skillは知識ではなく、行動ゲートとして使える Subagentは並列化だけでなく、責務分離に使える TDD、debug、verifyはAgentにも強制できる 完了宣言は検証結果とセットにする 良い開発プロセスはSkillとして自己増殖できる 19