SuperAPI AI 工具集

coding-agent-review-method

编程与开发

查看项目

更新于 10-16 03:16

技能介绍

用途:为通过外部编码智能体(委派子智能体)执行代码评审提供方法论,适用于希望由外部编码智能体评审代码、需要跨多个编码智能体复用的评审流程,或需要将评审编排与具体智能体执行细节分离的场景。

主要能力:解析评审目标、范围与意图;在用户未指定编码智能体时要求用户明确;准备高上下文评审输入;以用户提供的 diff、范围、patch、commit 或文件列表为主评审范围;在风险依赖调用方、引用、消费方、契约、兼容性假设或相邻上下游行为时,进行有界的影响追踪;保持评审与实现、构建、测试工作流分离;要求每次运行使用唯一产物并采用“发现优先”的输出契约;由执行方查阅所选编码智能体自身的操作指南以获取调用细节。

使用方式:用户需先指定编码智能体(如 Claude Code、Cursor、Codex 或团队自定义包装),否则应停止并询问。评审前需解析工作目录、评审范围、背景、已评审内容、评审运行 ID、影响焦点。执行前准备高上下文提示(可参考 assets/review_prompt_template.md),提示中应包含仓库路径、精确范围、背景、已评审事实、关注领域、影响目标、仅评审约束与发现优先输出要求。每个评审运行需有唯一 review-run-id 并派生唯一产物(提示文件、输出文件、诊断文件)。宿主框架支持子智能体时,委派给专用评审子智能体,使其仅执行一次评审并返回原始结果。

限制:该技能仅为方法论,不定义如何调用 Claude、Cursor、Codex 等具体智能体;不得将其作为某一编码智能体的直接执行指南。所选编码智能体必须有操作指南说明命名解析、提示提交、原始输出捕获、诊断捕获、委托或后台执行支持及重试规则等,否则无法安全执行。禁止静默选择编码智能体,禁止在范围明确时让其自由探索整个仓库,禁止无限追踪影响,禁止跨运行复用产物,禁止将调用失败当作“无发现”,禁止在同一外部评审运行中混入代码编辑、构建或测试,除非用户明确要求。若外部智能体返回泛泛内容,可收紧范围、补充文件或范围、补充已评审事实、点名需检查的符号与调用方,重跑一次并使用新产物。

输出契约:最终回复应包含 External Review(编码智能体、范围、所用操作指南)、Findings(高置信发现或“无明确发现”)、Notes(执行细节)。若外部智能体报告无问题,应如实说明,仅在确有残留验证缺口时提及。其他细节(如具体命令、API 形状、计费或平台支持)资料未提供。