用途:对指定代码范围做多维度质量评估,通过8个专业化只读子代理并行评审,聚合结果并按严重程度汇报,再根据用户选择落地修复。
主要能力(代理维度):命名(the-crucible:namer,识别误导性、含糊、类型编码、作用域不匹配的标识符);复杂度(complexity-reviewer,嵌套、标志参数、重复、过早抽象);注释(comment-reviewer,噪音、过时、重构信号、被注释掉的代码);测试(test-reviewer,虚假信心、实现耦合、不稳定、覆盖缺口);错误处理(error-handling-reviewer,静默吞错、上下文丢失、资源泄漏、异步错误丢失);安全(security-reviewer,注入、访问控制、密钥、加密、数据暴露);可观测性(observability-reviewer,日志、指标、链路追踪、基数、上下文传播);文档(docs-auditor,缺失API文档、过时文档、契约缺口)。所有代理均为只读,通过 SendMessage 汇报发现。
使用方式:用户以自然语言指示,例如“Run code quality evaluation on src/auth/”。流程分阶段:阶段0用 TeamCreate(name="code-review") 创建团队并按每个代理创建任务;阶段1用 Agent(subagent_type=..., prompt=..., team_name="code-review", task_id=...) 并行启动8个评审代理;阶段2收集消息、跨代理去重,按 Critical > Issues > Recommendations 呈现并询问用户处理哪些问题;阶段3按用户指示先修严重问题再修一般问题与建议,迭代直至用户停止或全部处理完毕。
适用场景:需要对某个目录或模块做全面代码审查并结合修复时使用。
限制:8个代理均为只读,仅分析并汇报,不直接改代码;修复依赖用户选择与后续步骤;资料未提供支持的模型、平台、价格或性能数据。