workflowlisted

## 目标与职责 把复杂任务拆成职责清晰、可验证、可并行、可汇总的工作流。并行不只用于审计：写入范围隔离时，子 agent 应直接完成实现和测试；共享资源由主 agent 统一集成 负责并行 agent / 多工作流编排，不负责长期 progress 文件。需要计划文件、阶段验收和跨多轮进度记录时，组合 `invoke-plan` ## 调用场景（符合任一项即可） - 多个实现任务位于不同仓库、隔离目录或明确不重叠文件 - 跨大量文件、模块、仓库或文档的搜索、审计、迁移评估 - 需要从正确性、安全性、性能、可维护性、可复现性等角度独立审查 - 需要查询官方文档、GitHub、Issue、PR、源码或 release note 验证结论 - 主上下文会被大量原始文件、日志、搜索结果撑爆 ## 可并行实现的条件（以下条件必须全部满足） - 子任务之间没有顺序依赖 - owned paths 明确，写入集合不重叠 - 共享文件和跨任务接线已明确交给主 agent - 每个子任务都能独立实现并运行自己的验证 ## 仅可只读并行、禁止并行写入的情况（符合任一项） - 多个任务会修改同一文件或同一共享生成物 - owned paths 无法明确划分，存在覆盖其他 agent 改动的风险 - 多个任务会写入同一个 git index、数据库、外部服务或日志/报告 这些情况仍可并行搜索、审计和验证；代码与共享资源由主 agent 串行写入 ## 不应拆分并行任务的情况（符合任一项） - 后一步依赖前一步输出 - 必须先全局去重、排序、汇总后才能继续 - 任务规模很小，主 agent 可以直接完成，且用户没有明确要求并行 ## 默认执行流程（按顺序执行） 1. 主 agent 先侦察，列出任务依赖、目标文件、共享资源和验证入口 2. 为每个子任务声明 owned paths、forbidden paths、是否允许写入以及禁��的 Git 操作 3. 写入集合不重叠时，子 agent 并行完成实现、测试和只读 Git 核对 4. 写入集合重叠或边界不确定时，子 agent 只读审计，由主 agent 串行落写 5. 共享文件、跨任务接线、冲突解决和最终验收始终由主 agent 负责 6. 每个子任务的 prompt 必须自包含，写清目标、范围、排除项、测试和输出格式 7. 子 agent 返回结构化结论、修改文件、验证结果和不确定点，不粘贴大段原文 8. 主 agent 汇总并标出已验证、部分验证和未验证结论 用户明确要求并行，且任务位于不同仓库、隔离目录或明确不重叠文��时，必须并行实现，不能退化成“子 agent 只审计、主 agent 串行写全部代码” ## 实现型子任务 Prompt（必须包含） 实现任务至少声明： ```text 目标： 允许写入： 禁止修改： 共享文件： 允许执行的测试： 禁止的 Git 操作： 交付：实现摘要、修改文件、测试结果、残余风险、git status --short ``` - `允许写入` 必须使用明确路径；不写“相关文件”等模糊范围 - `禁止修改` 应包含其他 agent 的 owned paths 和主 agent 负责的共享文件 - 子 agent 可在 owned paths 内自主��现和修复测试，不需要逐文件向主 agent 请示 - 发现必须修改共享文件时只报告，不越界写入，由主 agent 集成 ## 多角度审查规则（适用时全部满足） - 对复杂结论至少拆出 2 个独