用途:编排端到端任务实现,从理解任务、评估复杂度,到直接实现或分派团队协作,最后打磨结果。仅在用户显式调用该技能时运行。
工作流程:
- 解析任务:从 $ARGUMENTS 读取任务描述;若为空,则向用户索取任务描述并停止。提取范围(涉及的文件、模块、组件)、动作类型(新功能、修复、重构、迁移)与约束,并记录引用的 issue、PR 或 URL。
- 评估复杂度:按文件数量、模块跨度、依赖链、风险面、并行性五个信号判断。简单为 1-3 个文件、单模块、无新依赖、低风险、仅顺序步骤;复杂为 4 个以上文件、跨模块、新依赖或服务集成、高风险(认证、支付、数据、基础设施)、可并行子任务。3 个及以上信号落在复杂列即为复杂;存疑时优先走简单路径,只有并行确实带来加速才启用团队。
- 简单路径:直接执行,不生成子代理。先读取相关文件、理解现有代码与约定;按项目规范实现;运行最小有效检查(对改动文件跑格式化/静态检查、针对性测试、必要时类型检查),快速检查通过后仅在风险需要时跑更广检查。
- 复杂路径:将任务拆分为文件重叠最少、无循环依赖、有明确验收标准的独立子任务;以任务名创建团队并按子任务建任务、设依赖;按模块、共享工具、测试量分派代理;协调进度,处理集成冲突与后续任务;全部完成后运行完整测试、类型检查和 lint,直接修复集成问题,关闭队友。
- 打磨:调用 /code-polish 简化并审查本会话修改的所有文件,此步强制,即使实现看似干净也要执行;若有残余风险或停止条件,转达用户。
错误处理:$ARGUMENTS 为空则询问并停止;实现后验证失败先尝试修复,无法修复则先报告用户;团队代理失败或超时则收回任务直接完成。
停止条件:任务描述歧义且存在多种解释;需要修改任务未提及的公共 API 或破坏契约;实现中范围超出原始描述;外部依赖不可用或损坏;在任务相邻的既有代码中发现严重安全问题。