用途:在执行实施计划(如由计划编写技能产出)之前对其进行评审,检查并行化、TDD、类型与 API、库用法以及安全与边界情况,并产出可直接应用的修改建议。
主要能力:
- 防臆造门(gate 0):在给出任何结论前,必须先回引本轮新读取的计划原文或 file:line 代码,未回引不得下结论。
- 五类评审透镜:并行化分析(可并行任务、顺序依赖、循环依赖、关键路径、建议批次与最大并发);TDD 与过度工程检查(先测后写、RED/GREEN、测试关注行为、过度 mock 与抽象);类型与 API 校验(类型、枚举、导入路径、接口契约比对并给出 file:line);库最佳实践(函数签名、废弃 API、官方文档用法、安装命令);安全与边界情况(输入校验、错误处理、鉴权、边界)。
- 汇总报告:含 Summary Table、Critical/Major/Minor 三级问题、编号、位置 Task:Step、建议修改内容以及最终结论(可直接执行 / 需修复 / 不可执行)。
- 保存与提示:将评审写入计划同目录的 [plan-basename]-review.md,并在写完后重新读取该路径成功,才提示用户选择下一步。
使用方式:提供计划文件路径参数(如 docs/plans/2025-01-15-auth-feature.md)。先读取计划并提取 Goal、Architecture、Tech Stack 头部字段,再按检测到的技术栈加载对应技能(如 python-code-review、fastapi-code-review、pytest-code-review、go-code-review 等),然后运行五类评审(支持子代理时并行,否则顺序执行),最后汇总、保存评审并提示用户。
适用场景:在编写好计划、准备执行之前做质量把关,尤其适合多任务、需并行调度或涉及类型契约与安全的实施计划。
限制:需要能读取计划文件的路径;技能依赖已有技能库中的对应技能;该技能不会自动执行计划,必须由用户选择后续操作;资料未提供具体版本兼容范围、收费或平台信息。