mcpField
O
openspec-ff

openspec-ff

github.com/full-stack-skillsエージェントワークフロー188 回インストール4 週間前に更新
リポジトリ

openspec-ff について

openspec-ff は、OpenSpec の変更計画ドキュメントを一括生成するスキルです。機能の内容が明確で、段階的なレビューが不要な場合に、提案、仕様、設計、タスクを依存順に作成します。

主な機能

  1. 01計画ドキュメントの一括生成
  2. 02依存関係に沿った作成
  3. 03変更の指定に対応

活用シーン

  1. 01範囲が明確な機能の計画作成
  2. 02段階的なレビューなしで計画文書を一式作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/full-stack-skills/openspec-skills --skill openspec-ff

インストール後、Claude Code で/openspec-ffを入力して読み込まれたか確認します。

同梱ファイルagents/openai.yaml

詳細

OpenSpec ファストフォワードスキル

/opsx:ff を使用すると、計画アーティファクトの作成を一度にすべてファストフォワードできます。依存関係の順序に従って(proposal -> specs -> design -> tasks)、すべてのアーティファクトを1回の処理で作成します。

使用するタイミング

  • ユーザーが構築するものを明確に把握しており、段階的なレビューが不要な場合。
  • ユーザーが「ファストフォワード」「すべて作成」「計画ドキュメントをすべて生成」と指示した場合。
  • 手順ごとのレビューが不要な、小規模から中規模の機能。

前提条件

  • アクティブな変更が存在すること(openspec-new または /opsx:new で作成)。
  • または、/opsx:ff <change-name> を使用して、1つのステップで作成とファストフォワードを実行します。

ワークフロー

  1. ファストフォワードを実行

    • /opsx:ff — 現在の変更、または推定された変更をファストフォワードします。
    • /opsx:ff <change-name> — 指定した変更をファストフォワードします。
  2. 依存関係の順序に従ってアーティファクトを作成

    • デフォルトの spec-driven スキーマでは、以下の順序で作成します。
      1. proposal.md — 理由と内容
      2. specs/**/*.md — 差分仕様(要件とシナリオ)
      3. design.md — 技術的なアプローチ
      4. tasks.md — 実装チェックリスト
    • 各アーティファクトは、作成前に依存関係を読み込みます。
  3. レビュー

    • これですべての計画アーティファクトが利用可能になります。ユーザーは次に進む前に、いずれかを編集できます。

出力

  • すべての計画アーティファクトが openspec/changes/<name>/ に作成されます。
    • proposal.md
    • specs/**/*.md
    • design.md
    • tasks.md

次のステップ

  • 必要に応じてアーティファクトをレビュー、編集します。
  • openspec-apply を使用してタスクを実装します。
  • または、実装後に openspec-verify を使用して検証します。

トラブルシューティング

  • 「変更が見つかりません」:名前を指定します:/opsx:ff add-dark-mode。
  • アーティファクトの品質に関する問題:代わりに /opsx:continue を使用して、より細かく制御します。openspec/config.yaml にプロジェクトのコンテキストを追加します(openspec-config を参照)。

参考資料

コメント