doc-spec-autopilot

doc-spec-autopilot

目的

自動化された SPEC 生成パイプラインです。上流の BDD／ADR ドキュメント、ユーザープロンプト、または実装計画（IPLAN-*）を基に、ソースを分析し、完全なコンポーネント SPEC を生成して、準備状況を検証し、SPEC-00_index.md を維持しながら、合格スコアに達するまで監査↔修正サイクルを実行します。単一の SPEC にも、バッチにも対応します。

レイヤー：6。 上流：BDD／ADR（および EARS／PRD／BRD の連鎖）、またはプロンプト／IPLAN 入力。 下流：検証済み SPEC とインデックス項目。

スキルの依存関係

スキル	役割
../doc-spec/SKILL.md	SPEC の構造と作成ルール（生成）
../doc-spec-audit/SKILL.md	品質ゲート（スコアリング＋指摘事項）
../doc-spec-fixer/SKILL.md	監査レポートに基づいて修正を適用
../doc-naming/SKILL.md	ID 標準（ハイフン形式の SPEC-NN）

入力仕様

対象の SPEC ID／パス、上流の BDD／ADR ID またはパス、自由形式のテキストプロンプト、または IPLAN パスを受け付けます。オプション：スコアのしきい値（デフォルトは 90）、修正の最大反復回数（デフォルトは 3）、バッチリスト。明示的な入力がない場合は、リクエストをプロンプトとして扱います。

ドキュメントの自動判定

対象ごとに、SPEC がすでに存在するか（ネストされたフォルダー docs/06_SPEC/SPEC-NN_{slug}/）を確認します。

• なし → 生成モード（BDD／ADR、プロンプト、または IPLAN から生成）。
• あり → レビュー＆修正モード（監査し、しきい値未満なら修正）。

SPEC-NN 入力は自身を対象とするタイプ（レビュー）として扱います。BDD-NN／ADR-NN 入力は上流ソースとして扱い、対応する SPEC がなければ生成し、あればレビューします。

モデルの事前確認

参考情報として、ベストエフォートで表示します。このレイヤーに推奨されるモデルを示しますが、セッションのモデルは切り替えられません。ドライバーを呼び出す前に、次の手順を実行します。

1. .claude/aidoc-flow.config.yaml が存在しない場合、または model.* キーがない場合は、このセクションを完全にスキップします（出力なし）。
2. 推奨モデルを解決します。model.per_layer.SPEC が設定されていればそれを使用し、そうでなければ model.default を使用します。
3. model.precheck（warn | silent | block）に従って処理します。
   • warn（デフォルト）— 1 行表示してから、ドライバーに進みます。 ℹ SPEC recommends model '<rec>'. If you're not on it, run /model <rec> (or set model.precheck: silent to hide this).
   • silent — 何も表示せず、続行します。
   • block — 上記の行に加えて precheck=block: confirm you want to draft on the current model, or run /model <rec> first. を表示し、続行する前にユーザーの確認を待ちます。

ワークフロー

Saga 駆動の生成ループ（review_mode: team）

ステップ 1 — ドライバーを呼び出します。それだけです。 ハーネスは、この SKILL を呼び出す前に PREV_OUTPUT、 ARTIFACT_ID、ARTIFACT_PATH の環境変数を設定します。 最初のオーケストレーションアクションでは、必ず Bash ツールを使い（上記のモデル事前チェックが先に実行されます）、次をそのまま実行してください。

python3 "${CLAUDE_PLUGIN_ROOT}/tools/saga_driver.py" \
  --layer 06_SPEC \
  --allow-skip-permissions

--allow-skip-permissions を指定すると、ドライバーがディスパッチする各フェーズで、許可を求めることなくファイルを書き込めます。無人の自動実行にはこのオプションが必要です。 オプションを外せば、Claude Code の通常のプロンプトを有効にしたまま、同じループを実行できます。

十分に長いタイムアウト（≥1800s）を設定してください。入力を事前分析しないでください。上流を読まないでください。タイプやスコープを分類しないでください。ドライバーと、ドライバーがディスパッチするサブプロセス（ドラフト作成用の /aidoc-flow:doc-spec、レビュー用の /aidoc-flow:doc-spec-audit、修正用の /aidoc-flow:doc-spec-fixer）が、これらすべてを処理します。ドライバーは ${CLAUDE_PLUGIN_ROOT}/framework/governance/REVIEW_SAGA.md に従い、状態マシンを先回りして適用します。この SKILL の役割は、ドライバーを呼び出して結果を報告することです。

ステップ 2 — ドライバーの処理が戻ったら報告します。 .aidoc/review/06_SPEC/${ARTIFACT_ID}/saga.json を読み込みます。最終ステータスは、CLOSED（PASS）、ESCALATED（最終 FAIL）、PARTIAL_TIMEOUT（ソフト期限切れ。再開可能）のいずれかでなければなりません。ステータス、verdict.json がある場合は最終スコア、そして 1 行の要約を出力します。

ステップ 3 — インデックスを更新します（CLOSED の場合のみ）。 新しい SPEC を参照する行を docs/06_SPEC/SPEC-00_index.md に追加し、上流成果物の下流エントリーを更新します。

これが team モードでのワークフローのすべてです。ここでほかのこと（文章のドラフト作成、Task サブエージェントのディスパッチ、ほかのスラッシュコマンドの呼び出しなど）をしようとしていることに気づいたら、そこで停止してください。ドライバーを迂回していることを認識し、上記の Bash コマンドを実行してください。

直線型パイプライン（review_mode: single_pass）

従来の動作を変更せずに使用します。プロファイルで指定されている場合、Task サブエージェントのディスパッチを利用できない場合、または書き込み時（on_author）にコストを最優先する場合に適用されます。以下のセッション内 5 ステップの手順では saga.json を生成しません。そのため、ハーネスの saga-journal チェックでこのレイヤーは失敗します。このモードは手動のドライランにのみ適しています。

1. 入力分析 — 入力（BDD／ADR／プロンプト／IPLAN）を分類し、上流の資料を特定して、生成するかレビューして修正するかを判断します。
2. 上流の準備状況 — 上流の ADR／BDD が存在し、準備完了であることを確認し、次の SPEC-NN を確保します。
3. 生成 — ../doc-spec/SKILL.md に従って SPEC を作成します。最初に Document Control を記載し、YAML ですべての 8 セクションを作成し、インターフェース／データモデル／振る舞いを C4-L3 で記述し、累積タグ（@brd @prd @ears @bdd @adr）を付け、数値には @threshold 参照を付け、下流の @tdd: TDD-NN 契約を記載し、../charts-flow/SKILL.md に従って図のタグを付けます。
4. 検証 — ../doc-spec-audit/SKILL.md を最初から実行します。
5. 監査と修正のサイクル — スコアがしきい値未満で、反復回数が上限未満の間は、../doc-spec-fixer/SKILL.md を実行してから再監査します。合格したら docs/06_SPEC/SPEC-00_index.md を更新します。反復回数が上限に達したら、手動レビュー対象としてフラグを設定します。

実行モード

• 単一 — 1 つの SPEC（生成またはレビューと修正）。
• バッチ — 複数の SPEC を、コンテキストを制限するため3 件ずつ処理します。
• ドライラン — ファイルを書き込まずに、予定するアクション（セクション、ID、上流タグ）を報告します。

品質ゲート

• 監査に合格する（TDD-Ready スコアがしきい値以上、Tier-1 エラーが 0 件）か、反復回数の上限に達する（その場合は手動レビュー対象のフラグを設定する）まで、生成は完了しません。
• SPEC インデックスを更新するのは、SPEC の合格後のみです。
• サイクルごとに新規監査を実施します。スコアはキャッシュしません。

エラー処理

状況	対応
参照された上流の ADR／BDD が見つからない	停止し、不足している依存関係を報告します
しきい値未満のまま最大反復回数に到達	レポートを書き込み、手動レビュー対象のフラグを設定して、バッチを続行します
入力ソースが曖昧	プロンプトモードにフォールバックし、前提を SPEC に記録します
書き込み／権限エラー	ログに記録し、その項目をスキップして、バッチを続行します

適応

デフォルトを適用する前に、プロジェクトの適応プロファイル （.aidoc/profile.yaml）を読み込み、生成フェーズと内部監査・修正フェーズの両方で適用してください。 section_toggles、active_layers、audit_threshold（引き上げのみ。より厳しくする場合に限る）、および glossaryを尊重してください。不明なキーや対象範囲外のキーは無視してください。 プロファイルがない場合は、フレームワークのデフォルトを使用してください。 権威ある情報源：${CLAUDE_PLUGIN_ROOT}/framework/governance/ADAPTATION.md。

関連リソース

• 作成：../doc-spec/SKILL.md · 監査：../doc-spec-audit/SKILL.md · 修正： ../doc-spec-fixer/SKILL.md
• 権威ある情報源：${CLAUDE_PLUGIN_ROOT}/framework/layers/06_SPEC/SPEC-TEMPLATE.yaml、 ${CLAUDE_PLUGIN_ROOT}/framework/layers/06_SPEC/README.md、 ${CLAUDE_PLUGIN_ROOT}/framework/layers/06_SPEC/SPEC-00_index.TEMPLATE.md