scartill-sdd-lite

コマンド

• Save Spec - 永続的な仕様を保存します（プロンプト：sc.save.spec.md）
• Split Tasks - 独立したタスクを作成します（プロンプト：sc.split.tasks.md）
• Implement - 実装を実行します（プロンプト：sc.implement.tasks.md）
• Finalize - 実装後のアクションを実行します：ドキュメントを更新し、先送りされた項目を docs/feedback/ に記録し、可能であれば PR にプロダクトマネージャー向けのガイダンスを投稿します（プロンプト：sc.finalize.md）
• Critique - 仕様を批評します（プロンプト：sc.critique.spec.md、批評するファイルをパラメーターとして指定）
• Code Review - 実装をレビューします（プロンプト：sc.code.review.md）
• Archive - 古いプロジェクトドキュメントをアーカイブします（プロンプト：sc.archive.md）
• Brainstorm - 拡張ブレインストーミングを行います（プロンプト：sc.brainstorm.md、検討する問題をパラメーターとして指定）
• Seed - ブレインストーミングの最終結果をシードに変換します（プロンプト：sc.brainstorm.to.seed.md）
• Gate Input - 生の入力をサニタイズし、整理されたシード仕様を抽出して、PM フィードバックレポートを生成します（プロンプト：sc.gate.input.md、入力ドキュメントのパスをパラメーターとして指定）

高度なコマンド（Orca 依存）

これらのコマンドには、/orchestration スキルと利用可能な敵対的エージェントが必要です。

• Handoff Critique - 新しい Orca ターミナルで実行されている敵対的エージェント（Antigravity）に批評を引き継ぎ、その批評の結果を適用します（プロンプト：sc.handoff.critique.md、許可される引数：--auto）
• Handoff Code Review - 新しい Orca ターミナルで実行されている敵対的エージェント（Antigravity）にコードレビューを引き継ぎ、そのレビューの結果に対応します（プロンプト：sc.handoff.code.review.md、許可される引数：--auto）
• Autoflow - 全パイプラインを最初から最後まで自律的に多態的に進行します。利用可能な最も初期の成果物、つまりフェーズ 3〜4 を待つ記入済みブレインストーミング、シードのない完了済みブレインストーミング、シード（複数可）、または完全な仕様から開始し、必要に応じてブレインストーミングを完了および／またはシードを導出し、完全な仕様を計画します。その後、批評を引き継ぎ（--auto）、タスクを分割し、実装し、コードレビューを引き継ぎ（--auto）、最終処理を行い、各段階でコミットします（プロンプト：sc.autoflow.md、引数：自由形式のユーザーによる詳細化メモ）

すべてのプロンプトは <skill-dir>/prompts/ にあります。

有効化時にこれらのコマンドを覚えておきますが、ユーザーから明示的に依頼されるまで実行しないでください。

ガイダンス

仕様ワークフロー：シードと完全な仕様

このプロジェクトでは、2 段階の仕様策定プロセスを採用しています。どちらも docs/ 配下にあります。

シード仕様（docs/seed/）

シード仕様は、簡潔で人が書いた意図を示すドキュメントです。以下を記述します。

• ユーザーが求めていること（機能の意図、望ましい動作）
• 重要な例と期待される出力形式
• 大まかな CLI インターフェースまたは設定の形式
• 後続タスク（README の修正、例の追加など）

シード仕様は非形式的で、ユーザーの口調で書かれ、誤字や略記が含まれることがあります。以下は含みません。

• 詳細な実装ガイダンス
• 内部データモデルやコード構造
• テスト要件を伴う明示的なタスク分割
• Mermaid 図やアーキテクチャ上の決定
• 既存のコードベース内部に関する背景情報

シード仕様は設計フェーズへの入力です。

完全な仕様（docs/specs/）

完全な仕様は、シード仕様から導かれる詳細な実装設計書です。以下を含みます。

• 問題の説明：要件を正確に言い換えたもの
• 要件：受け入れ基準の網羅的な一覧
• 背景：関連するコードベース内部の情報（既存のパターン、モジュール、データ構造）
• 提案する解決策：Mermaid 図、データモデル、コードスケッチを含むアーキテクチャ
• タスク分割：番号付きの実装タスク。それぞれに以下を含みます。
  • 目的
  • 実装ガイダンス（対象ファイル、従うべきパターン）
  • テスト要件（検証する内容、使用するフィクスチャ）
  • 検証用デモコマンド

完全な仕様は、追加の確認を必要とせずに実行できるよう、人間または AI の実装者に向けて作成されます。

ワークフロー

1. ユーザーは意図を記録するために、docs/seed/ にシード仕様を作成します。
2. シードを実行可能な計画へと展開した完全な仕様を、docs/specs/ に作成します（ユーザー自身が作成するか、AI の支援を受けて作成します）。
3. 実装は、完全な仕様に記載されたタスクの内訳に沿って進めます。

機能の実装を依頼された場合は、意図を把握するためにシードを、実装の詳細を把握するために完全な仕様を確認してください。シードしかない場合は、まず完全な仕様を作成することを提案してください。