openspec-archive について
openspec-archiveは、完了したOpenSpec変更を仕上げるスキルです。差分仕様をメインの仕様ディレクトリに統合し、変更の成果物をアーカイブに保存します。
主な機能
- 01成果物とタスクの完了状況を確認
- 02追加・変更・削除された仕様を統合
- 03変更を日付付きアーカイブへ移動
- 04監査用に変更の背景を保存
活用シーン
- 01検証済み変更のアーカイブ
- 02差分仕様のメイン仕様への反映
- 03完了した変更記録の保存
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/openspec-archiveを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yaml
詳細
OpenSpec アーカイブスキル
完了した変更を確定するには /opsx:archive を使用します。差分仕様をメインの openspec/specs/ ディレクトリにマージし、変更フォルダーを openspec/changes/archive/ に移動してアーカイブします。
使用するタイミング
- 実装が完了し、検証済みの場合。
- ユーザーが「archive」「finish」「done with this change」「wrap up」と言った場合。
- openspec-verify の実行後（任意ですが、推奨）。
前提条件
- 変更が存在し、成果物があり、（できれば）タスクが完了していること。
ワークフロー
-
アーカイブを実行
/opsx:archive— 現在の変更、または推測された変更をアーカイブします。/opsx:archive <change-name>— 指定した変更をアーカイブします。
-
実行される処理
- 成果物の完了状況とタスクの完了状況を確認します（未完了の場合は警告します）。
- 差分仕様がまだ同期されていない場合、同期するかどうかを確認します（openspec-sync を参照）。
- 差分仕様を
openspec/specs/にマージします（ADDED / MODIFIED / REMOVED セクション）。 - 変更フォルダーを
openspec/changes/archive/YYYY-MM-DD-<name>/に移動します。
-
すべての成果物を保持
- 変更のコンテキスト全体（提案、設計、タスク、仕様）を、監査証跡としてアーカイブに保持します。
差分仕様のマージルール
| セクション | 処理内容 |
|---|---|
## ADDED Requirements | メイン仕様に追加します |
## MODIFIED Requirements | メイン仕様内の既存の要件を置き換えます |
## REMOVED Requirements | メイン仕様から削除します |
出力
- 差分仕様が
openspec/specs/にマージされます。 - 変更が
openspec/changes/archive/YYYY-MM-DD-<name>/に移動されます。
次のステップ
- openspec-new を使って新しい変更を開始します。
- メイン仕様に変更が反映されます。以降の変更は、更新された信頼できる情報源に基づいて進めます。
トラブルシューティング
- 「Incomplete tasks」：アーカイブでは警告が表示されますが、処理はブロックされません。先にタスクを完了するか、そのままアーカイブするかを判断してください。
- 「Delta specs not synced」：アーカイブ時に同期するかどうかを確認します。または、事前に openspec-sync を実行してください。
- アーカイブする変更が複数ある場合：代わりに openspec-bulk-archive を使用してください。
参考資料
コメント
Markdown 対応