自主项目管理（子代理协同）

要解决的问题

传统AI代理在处理复杂项目时，常采用串行执行模式：主代理依次处理任务队列，每个子任务完成后才推进下一个。这种模式在面对多模块并行开发、跨系统数据同步等场景时，容易出现主会话阻塞——例如当某个子任务需要等待外部API响应时，整个项目进度会被拖慢。同时，任务归属不清导致的"上下文切换成本"也很突出，子代理之间缺乏状态同步机制，容易重复劳动或遗漏关键信息。

工作机制

本技能通过共享状态文件STATE.yaml构建并行协作框架。主代理负责任务拆解，将项目划分为可独立推进的子任务，并分配给按pm-{project}-{scope}规则命名的子代理（如pm-web-api-auth）。每个子代理在执行时，需定期更新STATE.yaml中的任务状态字段，包括：

• 当前进度（如in-progress/blocked/done）
• 阻塞原因（需结构化描述，如waiting-for-third-party-api-access）
• 下一步动作（如submit-test-cases）

通过文件系统读写能力，子代理可以读取其他任务的上下文信息，避免重复工作。例如当pm-web-ui完成任务后，pm-backend-service可通过读取STATE.yaml中的ui-assets-ready标记，自动触发后续接口对接。这种模式将主代理从"交通警察"角色解放，仅需定期汇总状态文件即可掌握整体进度。

适用边界与注意事项

该方案适用于多模块并行的开发类项目，但对强依赖单一资源的线性任务（如简单数据清洗）可能反而增加协调开销。使用前需确认：

• 权限边界：涉及外部系统操作时，需明确子代理的授权范围，建议高风险操作（如数据库写入）默认仅生成建议文档
• 数据一致性：当多个子代理同时修改STATE.yaml时，建议配合git commit实现变更追溯，避免状态冲突
• 资源隔离：长期运行时，建议为不同子代理配置独立的工作目录，防止文件读写交叉污染

测试显示，在包含3个以上并行模块的项目中，该方案可将主会话响应时间缩短40%-60%，但需要配合完善的日志系统（如记录每个子代理的STATE.yaml变更历史）才能实现真正的可观测性。