Synchronize plugin skills with the current implementation and documentation.

Purpose

Ensure that skills in plugins/synapse-a2a/skills/ accurately reflect:

Current implementation in synapse/ directory
README.md documentation
Guides in guides/ folder

When to Use

After implementing new features or parameters
After updating README.md or guides
Before releasing a new version
When /sync-plugin-skills is invoked

Workflow

Step 1: Gather Current State

Read the following files to understand current implementation and documentation:

Implementation: Key files in synapse/

synapse/tools/a2a.py - CLI tool implementation

synapse/a2a_client.py - A2A client
synapse/cli.py - Main CLI entry point
synapse/commands/*.py - Command implementations
Documentation:

README.md - Main documentation

guides/usage.md - Usage guide
guides/settings.md - Settings documentation
guides/delegation.md - Delegation guide
Current Skills:

plugins/synapse-a2a/skills/synapse-a2a/SKILL.md

plugins/synapse-a2a/skills/synapse-a2a/references/*.md
plugins/synapse-a2a/skills/delegation/SKILL.md
plugins/synapse-a2a/skills/delegation/references/*.md

Step 2: Identify Gaps

Compare and identify:

New CLI options/parameters not documented in skills
Changed command syntax or behavior
New features mentioned in README but missing from skills
Deprecated or removed features still in skills
Endpoint path inconsistencies

Step 3: Update Skills

Update skill files to match current state:

synapse-a2a/SKILL.md:

Quick Reference table
Command examples
Feature descriptions

synapse-a2a/references/commands.md:

Full CLI command documentation
All options and parameters
Example usage

synapse-a2a/references/api.md:

Endpoint paths
Request/response formats
Extension endpoints

delegation/SKILL.md:

Delegation patterns
Command examples

delegation/references/modes.md:

Communication methods
A2A patterns

Step 4: Verify Consistency

Ensure consistency across:

Endpoint paths match between README and skills
Command syntax is identical
Option names and defaults match implementation
Examples use correct syntax

Key Areas to Check

Command Options

# Check synapse/tools/a2a.py for current options
synapse send <target> <message> [options]

Key options to verify:

--from / -f: Sender identification
--priority / -p: Priority levels (1-5)
--response / --no-response: Roundtrip control
--reply-to: Reply to specific task

API Endpoints

/.well-known/agent.json    # Agent Card
/tasks/send                # Standard A2A
/tasks/send-priority       # Synapse extension
/tasks/{id}                # Task status
/status                    # Agent status

Settings Commands

synapse init               # Initialize .synapse/
synapse config             # Interactive TUI
synapse config show        # View settings
synapse reset              # Reset to defaults

Output

After synchronization, report:

Files that were updated
Specific changes made
Any manual review needed

Notes

Preserve skill file structure (YAML frontmatter + markdown)
Keep descriptions concise and actionable
Use imperative form for instructions
Avoid duplicating content between SKILL.md and references/

安装