mcpField
O
openspec-apply

openspec-apply

github.com/partme-aiエージェントワークフロー39 回インストール
リポジトリ

openspec-apply について

openspec-applyは、計画済みのOpenSpec変更を実装するコーディングエージェント向けスキルです。tasks.mdを読み、未完了のタスクを順に進めてチェックリストを更新し、中断後も再開できます。

主な機能

  1. 01tasks.mdから未完了タスクを読み込む
  2. 02タスクを順に実装
  3. 03コードファイルの作成と変更
  4. 04必要に応じたテスト実行
  5. 05完了タスクへのチェック記入

活用シーン

  1. 01計画成果物がそろった変更の実装
  2. 02中断後の実装作業の再開
  3. 03実装中の問題に応じた設計成果物の更新

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/partme-ai/openspec-skills --skill openspec-apply

インストール後、Claude Code で/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 は反復的に進められます。

参考資料

コメント

Markdown 対応