openspec-apply

OpenSpec Apply スキル

変更内容に基づいてタスクを実装するには、/opsx:apply を使用します。エージェントは tasks.md を読み、タスクを1つずつ進め、コードを記述し、必要に応じてファイルを作成してテストを実行し、完了した項目に [x] を付けます。

使用するタイミング

• 計画用の成果物がすべて完成しており、ユーザーが実装を希望している場合。
• ユーザーが「実装して」「適用して」「コーディングを始めて」「タスクを実行して」と言った場合。
• 中断後に実装を再開する場合。

前提条件

• 計画用の成果物が完成していること — 最低限、tasks.md が存在する必要があります（openspec-ff または openspec-continue で作成）。

ワークフロー

1. 実装を開始する

   • /opsx:apply — 現在の変更、または推定される変更を適用します。
   • /opsx:apply <change-name> — 指定した変更を適用します。

2. タスクを読む

   • エージェントは tasks.md を読み、未完了のタスク（未チェックの [ ] 項目）を特定します。

3. タスクを進める

   • 各タスクについて、関連する仕様、設計、既存のコードを読み、コードを記述し、ファイルを作成または変更して、テストを実行します。
   • tasks.md で各タスクに [x] を付けて完了にします。

4. 問題に対処する

   • タスクを進める中で設計に誤りがあるとわかった場合は、成果物（例：design.md）を編集してから続行します。
   • OpenSpec は柔軟に変更できます。実装中に成果物を更新することが想定されており、推奨されています。

5. 中断後に再開する

   • もう一度 /opsx:apply を実行します。チェックボックスの状態に基づいて、中断した箇所から再開します。

出力

• タスクを実装するコードの変更（新規ファイル、変更したファイル）。
• 完了したタスクに [x] を付けて更新された tasks.md。

次のステップ

• openspec-verify を使用して、実装が成果物と一致していることを検証します。
• openspec-archive を使用して、完了した変更をアーカイブします。

トラブルシューティング

• 「変更が見つかりません」：変更名を指定します：/opsx:apply add-dark-mode。
• タスクが間違っているように見える：適用する前に tasks.md を編集するか、/opsx:continue を使用して再生成します。
• 実装が設計から逸脱している：必要に応じて design.md または specs/ を編集します。OpenSpec は反復的に進められます。

参考資料

• OpenSpec コマンド：/opsx:apply
• OpenSpec の概念：成果物