Autonomous Engineer

日本語

English

日本語

English

Appearance

cc-sdd ​

cc-sddは、Autonomous Engineerに最初に統合されるSDDフレームワークです。

CLIを通じて仕様ワークフローを提供し、実装前に構造化されたアーティファクト（要件、設計、タスク）を生成します。

Install cc-sdd ​

sh
npx cc-sdd@latest --claude --lang en
# As custom slash command
/kiro:steering

カスタムスラッシュコマンド ​

コマンドフェーズ説明
spec-init "description"初期化仕様ディレクトリと初期メタデータを作成
spec-requirements <feature>要件requirements.md を生成
validate-gap <feature>オプション要件と既存コードベースの差分を確認
spec-design <feature> -y設計design.md を生成
validate-design <feature>オプション設計品質と整合性を検証
spec-tasks <feature> -yタスクtasks.md を生成
spec-impl <feature> [task-ids]実装実装ループを実行
validate-impl <feature>オプション要件に対して実装を検証
spec-status <feature>任意現在のフェーズとタスク進捗を表示

アーティファクト ​

すべてのアーティファクトは .kiro/specs/<feature-name>/ 以下に格納されます。

アーティファクトフェーズ説明
spec.json初期化仕様メタデータ（名前、言語、作成日）
requirements.md要件チェックボックス付きEARS形式の要件
design.md設計技術アーキテクチャ、データモデル、図
validation-report.md設計検証（オプション）設計レビューの合否レポート
tasks.mdタスク受け入れ基準付きの順序付き実装タスク

フェーズ構造 ​

cc-sddは8つの順次フェーズに従います：

SPEC_INIT
    ↓
SPEC_REQUIREMENTS
    ↓
VALIDATE_GAP  (optional)
    ↓
SPEC_DESIGN
    ↓
VALIDATE_DESIGN  (optional)
    ↓
SPEC_TASKS (TASK_GENERATION)
    ↓
SPEC_IMPL (IMPLEMENTATION)
    ↓
VALIDATE_IMPL  (optional)

人間によるレビューゲート ​

cc-sddは3つのポイントでレビューゲートを設けます：

ゲートフェーズ後必要なアクション
要件承認要件requirements.md をレビューし、スコープを確認
設計承認設計design.md をレビューし、アーキテクチャを確認
タスクリスト承認タスクtasks.md をレビューし、実装計画を確認

ゲートは -y でバイパスできますが、人間によるレビューが推奨デフォルトです。

要件フォーマット ​

要件はEARS（Easy Approach to Requirements Syntax）形式のチェックボックスで記述します：

markdown
- [ ] システムは...しなければならない
- [ ] Xが発生した場合、システムは...しなければならない

タスクフォーマット ​

タスクにはタイトル、説明、依存関係、要件に紐づいた受け入れ基準が含まれます：

markdown
## タスク1: ツールインターフェースの実装

**依存関係**: なし

`Tool<Input, Output>` インターフェースと `ToolContext` 型を実装する。

**受け入れ基準**:
- [ ] ツールインターフェースが正しいジェネリクスで定義されている
- [ ] ToolContextにworkspaceRoot、permissions、memory、loggerが含まれている
- [ ] ユニットテストがインターフェース仕様を網羅している

並列タスク分析 ​

tasks.md のタスクには (P) マークを付けることで、並列実行（または単一の spec-impl 呼び出しへのバッチ処理）が安全であることを示せます。

(P) マークの条件 ​

以下のすべてが真のときのみ並列可能としてマークします：

  1. 保留中のタスクへのデータ依存がない。
  2. 競合するファイルや共有の可変リソースに触れない。
  3. 他のタスクからの前提レビュー/承認が不要。
  4. このタスクに必要な環境/セットアップ作業がすでに満たされているか、タスク自体の中でカバーされている。

マーキング規則 ​

  • 数値識別子の直後に (P) を追加：- [ ] 2.1 (P) メール用バックグラウンドワーカーの構築
  • 主要タスクとサブタスクの両方に (P) を適用可能。
  • 独自のアクション可能な詳細ブレットを持たないコンテナのみの主要タスクへのマークはスキップし、サブタスクレベルで評価する。

グループ化ガイドライン ​

  • 同じテーマに属する作業は同じ親の下に並列タスクをグループ化する。
  • 似ているが並列安全でない2つのタスクについては、ブロッキング依存関係を明示的に記述する。

品質チェックリスト ​

(P) マークを付ける前に確認：

  • このタスクを同時実行してもマージや展開の競合が生じない。
  • 共有状態の期待値が詳細ブレットに記載されている。
  • 実装が独立してテスト可能。

いずれかのチェックが失敗した場合は (P) マークを付けず、タスク詳細に依存関係を説明する。

出典: tasks-parallel-analysis.md

設定 ​

cc-sddは各仕様ディレクトリのルートにある spec.json にメタデータを格納します：

json
{
  "name": "feature-name",
  "language": "en",
  "created": "2026-03-10"
}

language フィールドは、生成されるアーティファクトコンテンツの言語を制御します。

Autonomous Engineer Documentation