本文へスキップ
hdknr blog
戻る

cc-sdd とは? Claude Code・Codex で Kiro 式の仕様駆動開発を回すスキルと使い方

cc-sdd は、Claude Code や Codex などの AI コーディングエージェントに、仕様駆動開発(SDD)の進め方を持ち込むオープンソース(MIT ライセンス)のツールです。AWS の AI 開発環境 Kiro に着想を得ており、requirements.md / design.md / tasks.md を作ってから実装する Kiro と同じ流れを、手元のエージェントで回せます。

リポジトリの説明(description)は、cc-sdd を「承認した仕様を、長時間の自律的な実装に変える。最小限で適応しやすい SDD のハーネス」としています。仕様を人間と AI の間の約束として段階ごとに承認し、承認した仕様にもとづいて AI に実装させる、という考え方です。

要点は次の 3 つです。

この記事では、cc-sdd のリポジトリ(gotalab/cc-sdd)とドキュメントをもとに、次の内容を整理します。内容は 2026 年 11 月 13 日時点のもので、最新のリリースは v3.1.0 です。

あわせて読みたい関連記事です。

cc-sdd の概要

項目内容
作者Gota 氏(GitHub の gotalab)
ライセンスMIT
公開2025 年 7 月にリポジトリを作成
最新リリースv3.1.0(2026 年 9 月 23 日)
配布形態Agent Skills(v3.0 から)。どのエージェントにも同じ 17 個のスキルを入れる
対応エージェントClaude Code、Codex、Cursor、GitHub Copilot、Devin、OpenCode、Gemini CLI、Antigravity
生成する文書の言語日本語・英語を含む 14 言語

README には「Kiro-inspired(Kiro に着想を得た)」とあり、「既存の Kiro の仕様は互換性があり、持ち運べる」とも書かれています。日本語の README では「Kiro スタイル」と表現されています。

cc-sdd のインストール(npx cc-sdd)と対応エージェント

プロジェクトのディレクトリで npx を実行します。既定では Claude Code 用のスキルが入り、生成される文書は英語になります。

cd your-project
npx cc-sdd@latest

エージェントと文書の言語は、オプションで指定します。

# Claude Code 用、文書は日本語
npx cc-sdd@latest --claude-skills --lang ja

# Codex 用、文書は日本語
npx cc-sdd@latest --codex-skills --lang ja

何が作られるかを事前に確かめたいときは --dry-run を、仕様の置き場所を .kiro 以外に変えたいときは --kiro-dir を使います。

# 作られるファイルを確かめるだけで、書き込まない
npx cc-sdd@latest --claude-skills --lang ja --dry-run

# 仕様の置き場所を docs/ にする
npx cc-sdd@latest --claude-skills --lang ja --kiro-dir docs

エージェントごとのオプションと安定度は次のとおりです(Agent Compatibility)。

エージェントオプション安定度
Claude Code--claude-skills安定版
Codex--codex-skills安定版
Cursor--cursor-skillsベータ
GitHub Copilot--copilot-skillsベータ
Devin--devinベータ
OpenCode--opencode-skillsベータ
Gemini CLI--gemini-skillsベータ
Antigravity--antigravityベータ

README によると、この安定度は統合の成熟度を表すものです。スキルを入れただけで、自律的な実装のループが最後まで回るとは限りません。

cc-sdd のスキル(/kiro-*)の使い方

基本の流れ

新しい機能を作るときは、エージェントのチャット欄で次の順にスキルを呼び出します(README の「Common workflows」)。

/kiro-discovery 写真アルバム(アップロード・タグ付け・共有)
/kiro-spec-init photo-albums
/kiro-spec-requirements photo-albums
/kiro-spec-design photo-albums
/kiro-spec-tasks photo-albums
/kiro-impl photo-albums
スキル役割
/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承認したタスクを実装する

各段階は人間のレビューのために止まり、承認してから次に進みます。

目的別の流れ

README は、作業の種類や大きさに応じて、次の流れを示しています。

既存のシステムを拡張する

  1. /kiro-steering
  2. /kiro-discovery か /kiro-spec-init
  3. (任意)/kiro-validate-gap
  4. /kiro-spec-design → /kiro-spec-tasks → /kiro-impl

大きな取り組み:/kiro-discovery → /kiro-spec-batch(依存関係の順に複数の仕様をまとめて作る)

小さな変更:/kiro-discovery → そのまま実装

そのほかのスキル

17 個のスキルのうち、主なものを紹介します。全体は Skill Reference を参照してください。

スキル役割
/kiro-steeringプロジェクト全体の知識(規約や構成)を .kiro/steering/ に作る・更新する
/kiro-steering-custom特定の領域についての知識を追加する
/kiro-validate-gap既存のコードと要件の差を分析する(任意)
/kiro-validate-implタスクをまたいだ結合の検証。結果は GO / NO-GO / MANUAL_VERIFY_REQUIRED のいずれか
/kiro-spec-quick仕様の 4 段階(init → requirements → design → tasks)を順に進め、段階ごとに承認を待つ(任意)
/kiro-spec-status進み具合と承認の状況をまとめる

.kiro/specs に作られるファイル(requirements.md・design.md・tasks.md)

置き場所内容
.kiro/specs/<機能名>/brief.md、requirements.md、research.md(必要なとき)、design.md、tasks.md
.kiro/steering/プロジェクト全体の知識
.kiro/settings/templates/仕様のテンプレート(requirements.md・design.md・tasks.md)
.kiro/settings/rules/生成の原則(EARS の書式、設計の原則、タスクの作り方など)
.claude/skills/ などエージェントごとのスキル(Codex は .agents/skills/、Cursor は .cursor/skills/ など)

各文書の書き方

requirements.md

要件と受け入れ基準を EARS 形式(決まった型で要件を書く記法。詳しくは「EARS 記法とは? 6 つのパターンと日本語での書き方・Kiro での使い方」)で書きます。文書を日本語で作る場合も、When・If・While・Where・The system shall といった EARS のキーワードは英語のまま残します。

design.md

Mermaid の図を含むアーキテクチャと、どのファイルをどう置くかの計画(File Structure Plan)を書きます。

tasks.md

- [ ] のチェックボックスでタスクを並べます。タスクには、次の注記を付けます。

テンプレートと原則は .kiro/settings/ の下にあるので、チームの書き方に合わせて編集できます。

/kiro-impl の進め方

/kiro-impl は、タスクを指定せずに実行すると、承認したタスクを順に自律的に進めます。タスクを指定すると、そのタスクだけを実装します。

サブエージェントの機能を持つツール(Claude Code など)では、タスクごとに新しい実装役のサブエージェントを立て、別のレビュー役のサブエージェントが確かめます(Skill Reference)。

役すること
実装役テスト駆動開発(先に失敗するテストを書く RED → 通す GREEN)で実装する
レビュー役git diff を確かめ、TODO が残っていないかを探し、テストを走らせ、タスクの範囲を守っているかを見る
デバッグ役実装役が行き詰まったとき、またはレビュー役が 2 回差し戻したときに呼ばれる。デバッグ役を呼べるのは 1 タスクにつき最大 2 回まで

進め方の特徴は次のとおりです。

v3.0 からは、この流れがエージェント自身のサブエージェントで動くようになりました。以前は Ralph Loop という外部のツールに頼っていました。

cc-sdd を使うときのポイント

Kiro・Spec Kit・OpenSpec との違い

cc-sddKiroSpec KitOpenSpec
形態既存のエージェントに追加するスキル専用の AI 開発環境既存のエージェントに追加するツールキット既存のエージェントに追加するスキル
進め方discovery → 要件 → 設計 → タスク → 実装要件 → 設計 → タスク → 実装原則 → 仕様 → 計画 → タスク → 実装提案 → 実装 → アーカイブ
特徴Kiro と同じ文書構成。サブエージェントによる実装とレビューIDE に統合された Spec・Steering・Hooks原則(constitution)で AI の判断を縛る変更を差分で扱う

Kiro の文書構成をそのまま使いたいが、IDE は替えずに Claude Code や Codex で進めたい、という場合に cc-sdd が合います。Spec Kit と OpenSpec については「GitHub Spec Kit とは?」と「OpenSpec とは?」で紹介しています。同じく Kiro とよく似た文書構成を MCP サーバーとして提供し、ダッシュボードで承認を記録するツールに Spec Workflow MCP があります(「Spec Workflow MCP とは?」)。

cc-sdd を軸に、レビューや依存パッケージのチェックまで組み込んだ開発フローの事例は、「非エンジニアの社長が出した巨大 PR をどう受け止めるか — cc-sdd・CodeRabbit・Takumi Guard で組む AI 駆動開発フロー」で紹介しています。

まとめ



前の記事
EARS 記法とは? 6 つのパターンと日本語での書き方・Kiro での使い方
次の記事
非エンジニアの社長が出した巨大 PR をどう受け止めるか — cc-sdd・CodeRabbit・Takumi Guard で組む AI 駆動開発フロー