mcpField
S
sync-plugin-skills

sync-plugin-skills

github.com/s-hiraokuエージェントワークフロー1756 回インストール2 週間前に更新
リポジトリ

sync-plugin-skills について

synapse-a2a プラグインのスキルファイルを、Synapse の実装やドキュメントに合わせて保守するスキルです。差分の確認、参照ファイルの更新、リリース前や変更後の整合性検証を支援します。

主な機能

  1. 01実装とドキュメントの比較
  2. 02スキル内容の不足・陳腐化の検出
  3. 03コマンドと API 参照の更新
  4. 04構文、オプション、エンドポイントの確認

活用シーン

  1. 01CLI オプションや機能の追加後
  2. 02README やガイドの更新後
  3. 03バージョンのリリース前

インストール

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

$npx skills add https://github.com/s-hiraoku/synapse-a2a --skill sync-plugin-skills

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

詳細

プラグインスキルの同期

プラグインスキルを現在の実装およびドキュメントと同期します。

目的

plugins/synapse-a2a/skills/ 内のスキルが、以下を正確に反映するようにします。

  • synapse/ ディレクトリ内の現在の実装
  • README.md のドキュメント
  • guides/ フォルダー内のガイド

使用するタイミング

  • 新機能やパラメーターを実装した後
  • README.md またはガイドを更新した後
  • 新しいバージョンをリリースする前
  • /sync-plugin-skills が呼び出されたとき

ワークフロー

ステップ 1：現在の状態を把握する

現在の実装とドキュメントを理解するため、以下のファイルを読みます。

  1. 実装：synapse/ 内の主要ファイル

    • synapse/tools/a2a.py - CLI ツールの実装
    • synapse/a2a_client.py - A2A クライアント
    • synapse/cli.py - CLI のメインエントリーポイント
    • synapse/commands/*.py - コマンドの実装

  2. ドキュメント：

    • README.md - メインドキュメント
    • guides/usage.md - 使用ガイド
    • guides/settings.md - 設定ドキュメント

  3. 現在のスキル：

    • plugins/synapse-a2a/skills/synapse-a2a/SKILL.md
    • plugins/synapse-a2a/skills/synapse-a2a/references/*.md
ステップ 2：不足箇所を特定する

以下を比較して特定します。

  • スキルに記載されていない新しい CLI オプション／パラメーター
  • 変更されたコマンド構文や動作
  • README に記載されているが、スキルにない新機能
  • スキルに残っている非推奨または削除済みの機能
  • エンドポイントパスの不整合
ステップ 3：スキルを更新する

スキルファイルを現在の状態に合わせて更新します。

synapse-a2a/SKILL.md：

  • クイックリファレンスの表
  • コマンドの例
  • 機能の説明

synapse-a2a/references/commands.md：

  • CLI コマンドの全ドキュメント
  • すべてのオプションとパラメーター
  • 使用例

synapse-a2a/references/api.md：

  • エンドポイントパス
  • リクエスト／レスポンス形式
  • 拡張エンドポイント
ステップ 4：一貫性を確認する

以下の項目で一貫性を確認します。

  • エンドポイントパスが README とスキルで一致していること
  • コマンド構文が同一であること
  • オプション名とデフォルト値が実装と一致していること
  • 例で正しい構文が使われていること

確認する主な項目

コマンドオプション
# Check synapse/tools/a2a.py for current options
synapse send <target> <message> [options]

確認する主なオプション：

  • --from / -f：送信者の識別
  • --priority / -p：優先度（1～5）
  • --wait / --notify / --silent：応答モードの制御
  • --reply-to：特定のタスクへの返信
API エンドポイント
/.well-known/agent.json    # Agent Card
/tasks/send                # Standard A2A
/tasks/send-priority       # Synapse extension
/tasks/{id}                # Task status
/status                    # Agent status
設定コマンド
synapse init               # Initialize .synapse/
synapse config             # Interactive TUI
synapse config show        # View settings
synapse reset              # Reset to defaults

出力

同期後、以下を報告します。

  1. 更新したファイル
  2. 実施した具体的な変更
  3. 手動レビューが必要な項目

注意事項

  • スキルファイルの構成（YAML frontmatter ＋ Markdown）を維持してください
  • 説明は簡潔で実行に移しやすい内容にしてください
  • 指示には命令形を使用してください
  • SKILL.md と references/ の間で内容が重複しないようにしてください

コメント

Markdown 対応