mcpField
O
openspec-sync

openspec-sync

github.com/partme-ai開発35 回インストール
リポジトリ

openspec-sync について

openspec-syncは、変更をアーカイブせずに差分仕様をOpenSpecのメイン仕様ディレクトリへ統合するスキルです。作業中または並行中の変更で、アーカイブ前に更新後のベース仕様を確認したい場合に使えます。

主な機能

  1. 01差分仕様をopenspec/specs/に統合
  2. 02ADDED、MODIFIED、REMOVEDの各節を処理
  3. 03差分にない既存内容を保持
  4. 04同期後も変更をアクティブな状態に維持
  5. 05要件の競合は最新の同期を優先

活用シーン

  1. 01長期的な変更中にベース仕様を更新
  2. 02並行する変更に更新後の仕様を反映
  3. 03アーカイブ前に仕様の統合結果を確認

インストール

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

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

インストール後、Claude Code で/openspec-syncを入力して読み込まれたか確認します。

詳細

OpenSpec Sync スキル

/opsx:sync を使用して、変更に含まれる差分仕様をメインの openspec/specs/ ディレクトリにマージします。変更をアーカイブする必要はありません。同期後も変更はアクティブなままです。この操作は任意です。openspec-archive はアーカイブ時に自動で同期します。

使用するタイミング

  • 長期にわたる変更で、アーカイブ前にメインの仕様へ反映したい場合。
  • 複数の並行する変更で、ベースとなる仕様を更新する必要がある場合。
  • アーカイブ前に、マージを個別に確認またはプレビューしたい場合。

前提条件

  • specs/ に差分仕様があるアクティブな変更。

ワークフロー

  1. 同期を実行する

    • /opsx:sync — 現在の変更または推定された変更を同期します。
    • /opsx:sync <change-name> — 指定した変更を同期します。

  2. 処理内容

    • 変更フォルダーから差分仕様を読み込みます。
    • ADDED／MODIFIED／REMOVED セクションを解析します。
    • 変更を openspec/specs/ にマージします。
    • 差分に記載されていない既存の内容は保持します。
    • 変更はアーカイブされず、アクティブなままです。

  3. 確認する

    • 更新された openspec/specs/ の仕様を確認します。

出力

  • 差分変更がマージされた openspec/specs/。
  • openspec/changes/<name>/ でアクティブなままの変更。

次のステップ

  • 変更作業を続けるか、完了したら openspec-archive を使用します。

トラブルシューティング

  • 「差分仕様がありません」：変更に specs/ ディレクトリがありません。まず openspec-continue または openspec-ff で仕様を作成してください。
  • 他の変更との競合：同期では要件単位でマージされます。同じ要件を2つの変更が修正した場合、後から同期した内容が優先されます。

参考資料

コメント

Markdown 対応