mcpField
O
openspec-sync

openspec-sync

github.com/full-stack-skills開発187 回インストール4 週間前に更新
リポジトリ

openspec-sync について

openspec-sync は、変更をアーカイブせずに、その差分仕様を OpenSpec のメイン仕様ディレクトリへ反映するスキルです。長期または並行して進む変更で、アーカイブ前に仕様の統合を個別に確認したい場合に使えます。

主な機能

  1. 01差分仕様をメイン仕様へ統合
  2. 02変更のない仕様内容を保持
  3. 03変更をアクティブ状態に維持
  4. 04統合後の仕様を確認

活用シーン

  1. 01長期変更の途中で仕様を同期
  2. 02並行変更のベース仕様を更新
  3. 03アーカイブ前に統合結果を確認

インストール

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

$npx skills add https://github.com/full-stack-skills/openspec-skills --skill openspec-sync

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

同梱ファイルagents/openai.yaml

詳細

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 対応