用途
Parallel Docs Simplify Sync 是一个面向开发流程的编排技能,其核心用途是使用 Task 工具并行协调四个相互独立的技能,用于 synapse-a2a 的开发工作流。其规范源位于 plugins/synapse-a2a/skills/,并同步至 .agents/skills/ 与 .claude/skills/。
涉及的四个技能分别为:
- synapse-docs — 文档更新
- /simplify — Claude Code 内置的代码简化功能(替代自定义 code-simplifier)
- sync-plugin-skills — 插件技能同步
- github-pages-sync — GitHub Pages 站点同步
适用场景
资料给出的使用时机包括:
- 同一任务中代码与文档都发生了变更。
- 在需要简化或重构清理的同时保持文档同步。
- 需要在同一次运行中完成插件技能同步。
- GitHub Pages 站点(site-docs/)需要反映代码或文档变更。
并行执行工作流
步骤 1:拆分为四个独立子任务
定义一个明确目标并进行划分,各轨道(Track)对应的技能与典型范围如下:
- Docs / synapse-docs / README.md、guides/、CLAUDE.md
- Simplify / /simplify(内置)/ 近期变更的 .py 文件
- Sync / sync-plugin-skills / plugins/synapse-a2a/skills/
- Pages / github-pages-sync / site-docs/
步骤 2:在单条消息中发起四个 Task 工具调用
使用 Task 工具在同一个响应中进行四次并行调用。每个 Task 调用应使用下方给出的提示模板。示例(3 个 Task 代理 + 1 个 Skill):
Task(subagent_type="general-purpose", prompt="[synapse-docs prompt]")
Skill("simplify")
Task(subagent_type="general-purpose", prompt="[sync-plugin-skills prompt]")
Task(subagent_type="general-purpose", prompt="[github-pages-sync prompt]")
步骤 3:等待全部四个输出
四个任务独立返回,在合并前先收集结果。
步骤 4:合并并解决冲突
应用各轨道的变更。若出现冲突,遵循下方冲突解决规则。合并后运行测试。
步骤 5:仅重试失败的轨道
若某个轨道失败,仅重新运行该轨道,不要重新执行全部四个。
任务提示模板
每个并行轨道使用以下模板:
Goal: <shared task goal>
Track: <synapse-docs | simplify | sync-plugin-skills | github-pages-sync>
Scope: <files/areas>
Constraints:
- Keep behavior unchanged unless explicitly requested
- Keep style consistent with repository conventions
- Do NOT touch files outside your track's scope
Deliverable:
- Concise change summary and touched files
冲突解决规则
synapse-docs 与 sync-plugin-skills 都可能修改 plugins/synapse-a2a/skills/ 下的文件。发生这种情况时:
- 技能 SKILL.md 内容以 sync-plugin-skills 为准。
- README.md、guides/ 及非技能文档以 synapse-docs 为准。
- 若两者修改了同一个 SKILL.md,采用 sync-plugin-skills 的输出,并对照 synapse-docs 的文档变更进行验证;若描述出现分歧则手动协调。
/simplify 不应产生冲突,因为它只触及 .py 文件。
github-pages-sync 仅修改 site-docs/ 与 mkdocs.yml。若 synapse-docs 与 github-pages-sync 都修改 mkdocs.yml,则以 github-pages-sync 为优先,因为它拥有站点构建配置。
完成检查清单
- 四个轨道均完成:synapse-docs、/simplify、sync-plugin-skills、github-pages-sync
- 已按上述规则解决冲突
- pytest 通过
- uv run mkdocs build --strict 通过(若 Pages 轨道运行)
- 最终 diff 连贯且可审阅
限制
资料未提供该技能的收费、价格、平台支持范围或性能指标等额外信息,暂未提供。