本文へスキップ
hdknr blog

cc-sdd

Kiro に着想を得た MIT ライセンスの仕様駆動開発ツール。Claude Code・Codex などに 17 個の /kiro-* スキルを入れ、requirements.md・design.md・tasks.md を作ってから、実装役とレビュー役のサブエージェントで TDD を回す

概要

cc-sdd(gotalab/cc-sdd)は、AI コーディングエージェントに 仕様駆動開発 の進め方を持ち込む MIT ライセンスのツールである。Kiro に着想を得ており、Kiro と同じ requirements.md / design.md / tasks.md を作ってから実装する流れを、IDE を替えずに Claude Code や Codex で回せる(既存の Kiro の仕様とも互換)。リポジトリは自らを「承認した仕様を長時間の自律的な実装に変える、最小限で適応しやすい SDD のハーネス」と説明する。

v3.0 から Agent Skills として配布され、どのエージェントにも同じ 17 個のスキルを入れる。文書は日本語を含む 14 言語で生成できる。

詳細

導入

npx cc-sdd@latest --claude-skills --lang ja            # Claude Code 用・日本語
npx cc-sdd@latest --codex-skills --lang ja             # Codex 用
npx cc-sdd@latest --claude-skills --lang ja --dry-run  # 書き込まずに確認
npx cc-sdd@latest --claude-skills --kiro-dir docs      # 仕様の置き場所を変える

安定版は Claude Code(--claude-skills)と Codex(--codex-skills)だけで、Cursor・GitHub Copilot・Devin・OpenCode・Gemini CLI・Antigravity はベータ。安定度は統合の成熟度で、ベータでは自律実装のループが最後まで回るとは限らないので、小さな機能で確かめてから使う。

スキルの流れ

基本は /kiro-discovery → /kiro-spec-init → /kiro-spec-requirements → /kiro-spec-design → /kiro-spec-tasks → /kiro-impl で、各段階は人間のレビューのために止まる。

スキル役割
/kiro-discovery入口。作業の種類を見分けて brief.md(必要なら roadmap.md)を書き、次のスキルを示して止まる
/kiro-spec-init.kiro/specs/<機能名>/ を作る
/kiro-spec-requirements確認の質問を集めて requirements.md を作る
/kiro-spec-design必要なら research.md で調べ、design.md を作る
/kiro-spec-taskstasks.md を作る。並行可能なタスクに (P)
/kiro-impl承認したタスクを実装する
/kiro-steeringプロジェクト全体の規約・構成を .kiro/steering/ に
/kiro-validate-gap既存コードと要件の差を分析(任意)
/kiro-validate-implタスクをまたぐ結合検証。GO / NO-GO / MANUAL_VERIFY_REQUIRED
/kiro-spec-batch大きな取り組みで、依存順に複数の仕様をまとめて作る

目的別には、既存システムの拡張は /kiro-steering から、大きな取り組みは /kiro-discovery → /kiro-spec-batch、小さな変更は /kiro-discovery からそのまま実装する。discovery が依頼の規模や既存仕様の有無で「直接実装」「既存の仕様を拡張」「新しい仕様を作る」に振り分ける点が、重いループに小さな依頼まで乗せないための入口になっている。

文書の書き方

テンプレートと生成ルール(EARS の書式・設計の原則・タスクの作り方)は .kiro/settings/ にあり、チームの書き方に合わせて編集できる。

/kiro-impl の進め方

サブエージェントを持つツールでは、タスクごとに新しい実装役を立て、別のレビュー役が確かめる(v3.0 以前は外部の Ralph Loop に頼っていた)。

役すること
実装役TDD(RED → GREEN)で実装する
レビュー役git diff、TODO の残り、テスト実行、タスク範囲の逸脱を確かめる
デバッグ役実装役が行き詰まるか、レビュー役が 2 回差し戻したときに呼ばれる(1 タスク最大 2 回)

1 回に 1 タスクずつ進めて進捗を tasks.md に記録し、学びは「Implementation Notes」に残して後のタスクに渡す。完了報告の前に内部スキル kiro-verify-completion がテスト結果などの根拠を確かめ直す。(P) のタスクに _Boundary:_ を書いておくと、レビュー役が範囲外の変更を見つけられる。

開発フローに組み込んだ事例

非エンジニアの社長が Claude Code で作った巨大 PR を受け止めるため、cc-sdd を軸に全員が同じプロセスを通るようにした事例がある。要件定義・設計・レビュアー・実装を別エージェントにし、計画が終わった時点で PR を作って CTO がレビューしてから実装に入る。PR では CodeRabbit が別系統でレビューし、Takumi Guard が悪性パッケージを止め、司令塔エージェントが作業とレビューのループを回す。仕様を「エージェントへの命令書」ではなく部品同士の契約として扱い、人間はフェーズごとのゲートで承認する。ドメイン知識はあってもアーキテクチャの前提を知らない人のコードも、仕様と設計のフェーズを通せば「Google Cloud 前提なのに AWS 前提」のようなずれを実装前に見つけられる。

hdknr 版 spec-loop / dev-loop との比較は 要求仕様書作成ループ にまとめた。

関連ページ

ソース記事