SuperAPI AI 工具集

parallel-docs-simplify-sync

编程与开发

查看项目

更新于 10-16 02:15

技能介绍

用途

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 连贯且可审阅

限制

资料未提供该技能的收费、价格、平台支持范围或性能指标等额外信息,暂未提供。