关于 parallel-agents
为协作编码 Agent 提供并行开发指导,帮助减少共享文件冲突。内容涵盖文件边界、可合并编辑、冲突热点审查和 Agent 文档维护。
主要功能
- 01按功能划分文件边界
- 02整理便于合并的共享列表
- 03审查重复冲突热点
- 04维护简洁的 Agent 文档
适用场景
- 01规划并行功能开发的文件结构
- 02减少注册表和生成文件的合并冲突
- 03调查反复出现的代码冲突
- 04精简 Agent 指令文档
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ jssblck/ agents --skill parallel-agents安装后在 Claude Code 中输入/parallel-agents确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/doc-gardening.mdhotspot-audit.mdmergeable-edits.mdone-feature-one-file.md详细介绍
并行 Agent
避免彼此独立负责的工作在共享文件中发生冲突。只有当并发工作或已观察到的冲突历史证明有必要时,才进行结构调整。
- 如果将独立行为放入单独文件能划定有用的所有权边界,就这样做。尽量少改共享注册表。不要仅为了一行注册代码就拆分紧密耦合的模块。
- 调整共享列表的结构,使其便于合并:每行一项,插入顺序稳定,不做无关的格式调整。重新生成生成文件和锁文件。
- 拆分重复出现的冲突热点前,先进行调查。如果同时需要结构调整和行为变更,应将两者分开处理。
- Agent 文档应简洁:说明协作约定、不明显的约束,以及实用的设置和检查入口。模块细节应放在其所属位置附近。
参考资料
只阅读与任务相关的参考资料:
- one-feature-one-file.md:如何为并发功能开发选择文件边界。
- mergeable-edits.md:如何编辑共享注册表、生成文件或存在冲突的分支。
- hotspot-audit.md:在需要审计或结构修复时,如何衡量冲突热点。
- doc-gardening.md:如何维护 Agent 指引或减少重复文档。
评论
支持 Markdown