実験ワークフローで完了した変更をアーカイブします。
ストアの選択: ユーザーがストア(このマシンに登録された独立したOpenSpecリポジトリ)を指定した場合、または作業がストア内にある場合は、openspec store list --json を実行して登録済みのストアIDを確認し、スペックや変更を読み書きするコマンド(new change、status、instructions、list、show、validate、archive、doctor、context)には --store <id> フラグを渡します。その他のコマンドはこのフラグを受け付けません。コマンドが出力するヒントには既にフラグが含まれているため、フォローアップでもそのまま使用してください。ストアがない場合、コマンドは最も近いローカルの openspec/ ルートに対して動作します。
入力:変更名をオプションで指定します。省略した場合、会話のコンテキストから推測できるか確認します。曖昧な場合は、利用可能な変更をプロンプトで表示する必要があります。
手順
-
変更名が指定されていない場合、選択を促す
openspec list --jsonを実行して利用可能な変更を取得します。AskUserQuestionツール を使用してユーザーに選択させます。既にアーカイブされていないアクティブな変更のみを表示します。 各変更で使用されているスキーマがあれば含めます。
重要:変更を推測したり自動選択したりしないでください。必ずユーザーに選択させてください。
-
アーティファクトの完了状態を確認
openspec status --change "<name>" --jsonを実行してアーティファクトの完了状態を確認します。JSONを解析して以下を把握します:
schemaName:使用されているワークフローplanningHome、changeRoot、artifactPaths、actionContext:パスとスコープのコンテキストartifacts:ステータス(doneまたはその他)を持つアーティファクトのリスト
doneでないアーティファクトがある場合:- 未完了のアーティファクトをリストした警告を表示
- AskUserQuestionツール を使用してユーザーに続行確認
- ユーザーが確認した場合のみ続行
-
タスクの完了状態を確認
タスクファイル(通常は
tasks.md)を読み取り、未完了のタスクを確認します。- [ ](未完了)と- [x](完了)のマークが付いたタスクをカウントします。未完了のタスクがある場合:
- 未完了タスクの数を示す警告を表示
- AskUserQuestionツール を使用してユーザーに続行確認
- ユーザーが確認した場合のみ続行
タスクファイルが存在しない場合: タスク関連の警告なしで続行します。
-
デルタスペックの同期状態を評価
ステータスJSONの
artifactPaths.specs.existingOutputPathsを使用してデルタスペックを確認します。存在しない場合は、同期プロンプトなしで続行します。デルタスペックが存在する場合:
- 各デルタスペックを、
openspec/specs/<capability>/spec.mdにある対応するメインスペックと比較 - 適用される変更(追加、修正、削除、リネーム)を特定
- プロンプトの前に結合サマリーを表示
プロンプトオプション:
- 変更が必要な場合:「今すぐ同期(推奨)」、「同期せずにアーカイブ」
- 既に同期済みの場合:「今すぐアーカイブ」、「とにかく同期」、「キャンセル」
ユーザーが同期を選択した場合、Taskツール(subagent_type: "general-purpose"、プロンプト: "Use Skill tool to invoke openspec-sync-specs for change ''. Delta spec analysis: <分析したデルタスペックのサマリーをここに含める>")を使用します。選択にかかわらずアーカイブに進みます。
- 各デルタスペックを、
-
アーカイブを実行
planningHome.changesDirの下にarchiveディレクトリが存在しない場合は作成します:mkdir -p "<planningHome.changesDir>/archive"現在の日付を使用してターゲット名を生成:
YYYY-MM-DD-<change-name>ターゲットが既に存在する場合:
- エラーで失敗し、既存のアーカイブの名前変更または別の日付の使用を提案
- 存在しない場合:
changeRootをアーカイブディレクトリに移動
mv "<changeRoot>" "<planningHome.changesDir>/archive/YYYY-MM-DD-<name>" -
サマリーを表示
アーカイブ完了サマリーを表示(以下を含む):
- 変更名
- 使用されたスキーマ
- アーカイブ場所
- スペックが同期されたかどうか(該当する場合)
- 警告に関するメモ(未完了のアーティファクト/タスク)
成功時の出力
## アーカイブ完了
**変更:** <change-name>
**スキーマ:** <schema-name>
**アーカイブ先:** `planningHome.changesDir` から派生したアーカイブパス/YYYY-MM-DD-<name>/
**スペック:** ✓ メインスペックに同期済み(または「デルタスペックなし」「同期スキップ」)
全アーティファクト完了。全タスク完了。
ガードレール
- 変更名が指定されていない場合は必ず選択を促す
- 完了確認にはアーティファクトグラフ(openspec status --json)を使用
- 警告があってもアーカイブをブロックせず、通知と確認のみ行う
- 移動時に .openspec.yaml を保持(ディレクトリごと移動するため)
- 何が行われたかを明確に示すサマリーを表示
- 同期が要求された場合は openspec-sync-specs アプローチ(エージェント駆動)を使用
- デルタスペックが存在する場合は、常に同期評価を実行し、プロンプトの前に結合サマリーを表示