spec-sweep

spec-sweep

複数の仕様追加（機能追加・拡張）を 1 セッションで連続実行する。spec-gen の薄いラッパーで、計画段階で全項目を確定 → 各項目ごとに Issue/ブランチを切って spec-gen 相当の作業を順次実行する。

いつ使うか

• 既存プロジェクトに複数の機能/仕様を追加したいとき
• 1 件ずつ spec-gen を起動する手間を省きたいとき
• 機能ごとに独立した Issue/ブランチで管理し、後で impl を流したいとき

新規プロジェクトの初期設計には使わない（spec-gen を直接呼ぶ）。

前提条件

• Codex CLI 環境
• gh CLI
• 既存の仕様書ディレクトリ（探索ロジックは spec-gen SKILL.md フェーズ1-0 参照）

フェーズ1: 計画

1-0: 既存仕様書の探索

spec-gen SKILL.md のフェーズ 1-0 と同じ手順で既存仕様書を探索し、ベースマップを把握する。見つからない場合は新規プロジェクトとして扱われるべきなので、spec-gen を直接使うよう案内して終了。

1-1: 運用方針の一括ヒアリング

選択式（自由入力を許容）で以下を 1 回にまとめて確認する。1 回あたり 4 問以内:

1. 追加項目の数（自由入力）
2. Issue モード: 推奨は「追加ごとに別 Issue / 別ブランチ」。ローカルのみも選択可
3. 執筆中のレビュー対話:
   • 「中断なく書く（推奨）」: spec-gen フェーズ 2-3 のレビュー対話はスキップし、完了後に spec-review で一括レビュー
   • 「項目ごとにレビュー」: 各項目で spec-gen の通常レビューサイクルを回す

1-2: 各項目の詳細を一括収集

項目ごとに 1 回の選択式質問で以下をまとめて集める（項目数だけ繰り返すが、1 項目 1 質問に厳守）:

• 項目名（実装する機能名。例: 「ユーザー通知機能」）
• 概要（1〜2文）
• 影響する仕様書（既存マップから複数選択 + 新規追加候補、複数選択可）
• 依存関係（他の項目の完了に先行/後続する必要があるか）
• CTO 確認事項（自由入力、任意。仕様策定前に潰しておきたい重要な論点があれば箇条書きで。spec-gen が読める形で spec に書き込まれる）

これ以降は原則追加質問しない。判断に迷うことは仕様書やコードを読んで自分で決める。

1-3: 計画確定と一括承認

収集情報を整理して提示し、同じ選択式質問で承認まで完結させる:

追加項目（実行順）:
1. ユーザー通知機能
   影響: requirements/functional.md, api/endpoints.md
   Issue: 新規作成 / ブランチ: feat/#N
2. 権限管理拡張
   影響: requirements/functional.md, components/overview.md
   依存: 1 の完了後 / ブランチ: feat/#N+1

「一括承認 / 修正指示 / 中止」を選ばせ、承認後は各項目を 1 タスクとしてキュー化し、フェーズ 2 は割り込みなしで最後まで走らせる（「項目ごとにレビュー」モードのみ、spec-gen 内部のレビュー対話が発生する）。

フェーズ2: 順次実行

依存関係順に、各項目について以下を実行:

1. ベースブランチに戻る（フェーズ 1 開始時に記録したブランチ）
2. 当該タスクを進行中に更新
3. プレースホルダー Issue 作成（Issue モードの場合）
   • タイトル: feat: <項目名>
   • 本文: 仕様策定中（spec-sweep 実行中）。完了後に実装内容を追記する。
4. feat/#<Issue番号> ブランチ作成
5. spec-gen の既存仕様書追記モードを実行
   • 計画段階で集めた 項目名 / 概要 / 影響仕様書 をコンテキストに含め、フェーズ 2-1 の追加ヒアリングは最小限にする
   • 「中断なく書く」モードの場合: フェーズ 2-3 のレビュー対話はスキップ（フィードバックなしで次に進む扱い）
   • 「項目ごとにレビュー」モードの場合: spec-gen の通常サイクル
6. spec-gen のフェーズ 3 を完了（push + Issue 本文を実装 Issue に書き換え）
7. 当該タスクを完了に更新
8. ベースブランチに戻る → 次項目へ

エラー時

• 当該項目で停止し、タスクの状態を明示する
• 完了済み項目はそのまま残す
• ユーザーに 項目N で失敗 / 完了済み: 1..N-1 / 未着手: N+1.. を報告し、再開可否を確認する

フェーズ3: 完了報告

サマリーをユーザーに提示:

• 全項目の Issue URL とブランチ名一覧
• スキップ/失敗があれば明記
• 「中断なく書く」を選んだ場合は spec-review <仕様書パス> の実行を推奨

ルール

• フェーズ 1 で全情報を一括収集。フェーズ 2 以降は原則追加ヒアリングしない（「項目ごとにレビュー」モード時の spec-gen 内部対話が唯一の例外）
• 質問は必ず選択式で提示する（自由入力を許容）。テキストだけで質問しない
• 1 回あたり 4 問以内にまとめる
• 既存仕様書ディレクトリを最優先（新規ディレクトリを勝手に作らない）
• 各 Issue は open のまま残す（後で impl #N がそのまま使える）
• spec-gen 本体のロジックは複製せず参照する（~/.codex/skills/spec-gen/SKILL.md）
• 計画フェーズで集めた 項目名 / 概要 / 影響仕様書 / CTO 確認事項 を渡し、spec-gen 内の追加ヒアリングは最小化
• コミットメッセージは <type>: <説明> 形式（CLAUDE.md 準拠）
• git commit / git push で --no-verify を使わない
• タスクを起こして進捗を管理する