SuperAPI AI 工具集

parallel-docs-simplify-sync

编程与开发

查看项目

更新于 10-16 09:55

技能介绍

用途:这是一个面向开发的编排技能,把四个独立技能并行执行,适合代码与文档在同一任务中被修改的场景,例如需要文档更新、代码简化重构、插件技能同步、GitHub Pages 站点同步同时进行时。

主要能力:synapse-docs 负责文档更新(README.md、guides/、CLAUDE.md);/simplify 为 Claude Code 内置的代码简化(替代自定义 code-simplifier),仅处理最近改动的 .py 文件;sync-plugin-skills 负责插件技能同步(plugins/synapse-a2a/skills/);github-pages-sync 负责 GitHub Pages 站点同步(site-docs/ 与 mkdocs.yml)。权威源位于 plugins/synapse-a2a/skills/,并同步到 .agents/skills/ 和 .claude/skills/。

使用方式:第一步把任务拆成四条独立子任务并明确目标与范围;第二步在单条消息中用 Task 工具发起四个并行调用,示例为 Task(subagent_type="general-purpose", prompt="[synapse-docs prompt]")、Skill("simplify")、Task(...sync-plugin-skills...)、Task(...github-pages-sync...)。每个轨道使用统一提示模板,包含 Goal、Track、Scope、Constraints(除非明确要求否则不改行为、风格与仓库一致、不碰范围外文件)与 Deliverable(变更摘要与涉及文件)。第三步等待四条轨道全部返回并收集结果;第四步合并并解决冲突后运行测试;第五步仅重试失败的轨道,不全部重跑。

冲突规则: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 同改 mkdocs.yml,以 github-pages-sync 优先。

限制与检查:完成清单要求四轨均完成、冲突按规则解决、pytest 通过、若执行了 Pages 轨道则 uv run mkdocs build --strict 通过,最终 diff 需连贯可审阅。资料未提供安装命令、收费、价格与平台支持信息。