openspec-bulk-archive

OpenSpec 一括アーカイブスキル

完了した複数の変更を一度にアーカイブするには、/opsx:bulk-archive を使用します。各変更を検証し、変更間の仕様の競合を検出して、実際に実装されている内容を確認しながら解決します。

使用するタイミング

• 複数の変更が完了し、アーカイブできる状態になったとき。
• ユーザーが「すべてアーカイブ」「一括アーカイブ」「完了した変更を整理」と言ったとき。
• スプリントや並行作業の一連の作業が終わったとき。

前提条件

• タスクが完了したアクティブな変更が複数あること。

ワークフロー

1. 一括アーカイブを実行

   • /opsx:bulk-archive — 完了した変更をすべて一覧表示し、選択を促します。
   • /opsx:bulk-archive <name1> <name2> ... — 指定した変更をアーカイブします。

2. 実行内容

   • 完了した変更をすべて一覧表示します。
   • 各変更をアーカイブする前に検証します。
   • 変更間の仕様の競合を検出します（例：2つの変更が同じ仕様ファイルに影響する場合）。
   • コードベースで実際に実装されている内容を確認して競合を解決します。
   • 作成日の順にアーカイブします。

3. 確認

   • エージェントが一覧と競合の解決計画を提示し、ユーザーが確認します。

出力

• 選択したすべての変更が openspec/changes/archive/ にアーカイブされます。
• 差分仕様が作成日の順に openspec/specs/ にマージされます。

次のステップ

• openspec-new を使用して新しい変更を開始します。

トラブルシューティング

• 仕様の競合：エージェントがコードベースを調査して解決します。確認する前に解決内容を確認してください。
• 未完了の変更：一括アーカイブでは未完了のタスクに警告が表示されますが、処理はブロックされません。

参考資料

• OpenSpec コマンド：/opsx:bulk-archive