agentskills.codes
SP

spec-sweep

by ousiassSource

複数の仕様追加を事前計画で一括ヒアリングし、Issue/ブランチごとに spec-gen を順次実行する。複数機能のまとめ追記、複数仕様の連続生成、追加項目のキュー処理を依頼されたときに使う。

Install

mkdir -p .claude/skills/spec-sweep && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/13358" && unzip -o skill.zip -d .claude/skills/spec-sweep && rm skill.zip

Installs to .claude/skills/spec-sweep

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

複数の仕様追加を事前計画で一括ヒアリングし、Issue/ブランチごとに spec-gen を順次実行する。複数機能のまとめ追記、複数仕様の連続生成、追加項目のキュー処理を依頼されたときに使う。
96 charsno explicit “when” trigger

About this skill

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 回あたり 4 問以内:

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

続けて、項目ごとに以下を選択式で収集する（項目数だけ繰り返す）:

  • 項目名（実装する機能名。例: 「ユーザー通知機能」）
  • 概要（1〜2文）
  • 影響する仕様書（既存マップから複数選択 + 新規追加候補）
  • 依存関係（他の項目の完了に先行/後続する必要があるか）

ヒアリングは項目ごとに 1 回の選択式質問にまとめる。

1-2: 計画確定

収集情報を整理して提示し、選択式で承認を取る:

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

承認後、各項目を 1 タスクとしてキュー化する。

フェーズ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 回あたり 4 問以内にまとめる
  • 既存仕様書ディレクトリを最優先（新規ディレクトリを勝手に作らない）
  • 各 Issue は open のまま残す（後で impl #N がそのまま使える）
  • spec-gen 本体のロジックは複製せず参照する（~/.codex/skills/spec-gen/SKILL.md）
  • 計画フェーズで集めた情報を活用し、執筆中の追加質問は極力控える
  • コミットメッセージは <type>: <説明> 形式（CLAUDE.md 準拠）
  • git commit / git push で --no-verify を使わない
  • タスクを起こして進捗を管理する

Search skills

Search the agent skills registry