parallel-docs-simplify-sync

并行文档简化同步

使用 Task tool 并行协调四项独立技能。

面向开发的编排技能。 权威源位于 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：拆分为四项独立子任务

定义一个明确的目标并进行拆分：

轨道	技能	典型范围
文档	synapse-docs	README.md、guides/、CLAUDE.md
简化	/simplify（内置）	最近更改的 .py 文件
同步	sync-plugin-skills	plugins/synapse-a2a/skills/
Pages	github-pages-sync	site-docs/

步骤 2：在同一条消息中启动四次 Task tool 调用

在一次响应中使用 Task tool 并行调用四次。 每次 Task 调用都应使用下面的提示词模板。

# Example: four parallel calls (3 Task agents + 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/ 下的文件。发生这种情况时：

1. 对于技能 SKILL.md 内容，以 sync-plugin-skills 为准。
2. 对于 README.md、guides/ 和非技能文档，以 synapse-docs 为准。
3. 如果两者修改了同一个 SKILL.md，采用 sync-plugin-skills 的输出，并 对照 synapse-docs 的文档更改进行核验。如果描述不一致，请手动协调。
4. /simplify 不应产生冲突，因为它只会修改 .py 文件。
5. 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 轨道）
• 最终差异连贯且便于审查