変更の既存の計画成果物を改訂し、相互の一貫性を保ちます。コードは絶対に編集しません。
ストアの選択: ユーザーがストア(このマシンに登録されているスタンドアロンのOpenSpecリポジトリ)を指定した場合、または作業がストア内にある場合は、openspec store list --json を実行して登録済みのストアIDを確認し、仕様や変更を読み書きするコマンド(new change、status、instructions、list、show、validate、archive、doctor、context)には --store <id> を渡します。その他のコマンドはこのフラグを受け付けません。コマンドが出力するヒントには既にフラグが含まれているため、フォローアップでもそのまま使用します。ストアがない場合、コマンドは最も近いローカルの openspec/ ルートに対して動作します。
入力: 変更名をオプションで指定できます。省略された場合は、会話の文脈から推測できるか確認します。曖昧または不明な場合は、利用可能な変更をユーザーに問い合わせる必要があります。
手順
-
変更名が指定されていない場合、選択を促す
openspec list --jsonを実行して、最後に変更された順に並べられた利用可能な変更を取得します。次に AskUserQuestion ツール を使用して、ユーザーに更新する変更を選択させます。最新の変更3〜4件をオプションとして表示し、以下を示します:
- 変更名
- スキーマ(
schemaフィールドがあればそれ、なければ "spec-driven") - ステータス(例: "0/5 tasks"、"complete"、"no tasks")
- 最終更新日時(
lastModifiedフィールドから)
最も最近変更された変更には "(推奨)" とマークします。これはユーザーが更新したい可能性が高いためです。
重要: 変更を推測したり自動選択したりしないでください。常にユーザーに選択させます。
-
変更の成果物を取得する
openspec status --change "<name>" --jsonJSON を解析して現在の状態を理解します。レスポンスには以下が含まれます:
schemaName: 使用されているワークフロースキーマ(例: "spec-driven")artifacts: 成果物の配列(ステータスは "done"、"ready"、"blocked")isComplete: すべての成果物が完了しているかを示すブール値planningHome、changeRoot、artifactPaths、actionContext: パスとスコープのコンテキスト。リポジトリローカルのパスを仮定せずにこれらを使用します。
成果物IDとパスはアクティブなスキーマから取得されます。ハードコードされた成果物名を仮定したり、分岐したりしないでください。カスタムスキーマでもそのまま動作する必要があります。
編集するファイルは
artifactPaths.<id>.existingOutputPathsです。これはディスク上に存在する具体的なファイルで、グロブ成果物(例:specs/**/*.md)の場合は既に展開されています。resolvedOutputPathには書き込まないでください。グロブ成果物の場合、それは依然としてグロブパターンであり、実際のファイルではありません。 -
リクエストを理解する
- ユーザーが特定の改訂を依頼した場合("設計は今後Xを使用する")、それが編集の起点となります。
- 単に "更新" や "一貫性を保つ" とだけ言われた場合は、一貫性レビューとして扱います。既存の成果物を読み、それらを相互にチェックして矛盾、欠落、重複がないか確認します。
-
読み取りと調整
- リクエストが触れる成果物と、変更の他の既存の成果物を読みます。
- 要求された編集を適用します。その後、他のすべての既存の成果物をそれに対してチェックします。任意の方向で: 後の成果物への編集は前の成果物の修正を必要とする場合があり、その逆も同様です。ビルド順序は有用な読み取り順序ですが、どの成果物が改訂されるかの制約ではありません。
- 矛盾、欠落、または矛盾しているものをすべて記録します。
- 既に存在するファイル(
existingOutputPaths)のみを改訂します。まだ存在しない成果物を作成したり、グロブ成果物の下に新しいファイルを作成したりしないでください。それらを記録し、ユーザーに/opsx:continueを実行して作成するよう促します。 - 変更が既に一貫している場合は、その旨を伝え、編集を行いません。
-
確認と適用を1つの成果物ずつ行う
- 各修正案とその理由を示します。ユーザーが確認した後にのみ書き込みます。
- ユーザーが修正を拒否した場合、書き込まず、その成果物は変更しないままにします。
- 大幅な書き換えが必要な場合は、まずその成果物のルールとテンプレートを取得します:
openspec instructions <artifact-id> --change "<name>" --json
-
次のステップを指示する(ガイダンスのみ - 決して実行しない)
- まだ存在しない成果物がある場合 ->
/opsx:continueを実行して作成するよう提案します。 - 変更が既に実装済み(タスクがチェック済み、または既に適用済み)の場合 -> コードが改訂された計画と一致しなくなっている可能性があります。
/opsx:applyを実行して差分をコードに反映するよう提案します。 - すべて完了し実装済みの場合 ->
/opsx:archiveを提案します。
- まだ存在しない成果物がある場合 ->
出力
各呼び出しの後、以下を表示します:
- どの成果物が改訂されたか(およびどの修正案が拒否されたか)
/opsx:continueに先送りされたもの(未作成の成果物やファイル)- 変更の現状と推奨される次のコマンド
ガードレール
- 計画成果物のみ - 実装コードは決して編集しません。改訂された計画がコードの変更を意味する場合は、そこで止めて
/opsx:applyを指示します。 openspec statusが報告する成果物IDとパスを使用します。ハードコードされた成果物名で分岐しないでください。existingOutputPaths内の具体的なファイルのみを編集します。グロブのresolvedOutputPathには書き込まないでください。- ビルドフロンティアを進めないでください。新しい成果物の作成や、グロブ成果物の下への新しいファイルの追加は行いません。それは
/opsx:continueの役割です。 - すべての編集は、書き込む前にユーザーに確認します。
- リクエストが変更の意図を変更するものであり、洗練するものではない場合は、
/opsx:newで新規作成を推奨します(「更新 vs 新規作成」のヒューリスティック)。