SuperAPI AI 工具集

comet-review

通用与其它

查看项目

更新于 10-16 01:07

技能介绍

用途:comet-review 用于对当前选定的 Comet 变更做一次按需、只读的手动代码审查,不属于工作流阶段,也不替代 Build 或 Verify 的检查与审查,且独立于 review_mode。

主要能力:审查需求、任务与当前差异,聚焦实现正确性与明显逻辑错误、安全与权限及路径边界风险、错误处理与兼容性及重要边界情况、缺失任务或与明确需求矛盾之处,以及测试是否覆盖变更行为。仅使用四档严重度:CRITICAL、IMPORTANT、WARNING、SUGGESTION。每条发现须给出文件与行号并说明触发条件。

使用方式:先用只读 Git 查询定位项目根目录,然后运行 comet status . --json,读取 .comet/current-change.json 选定审查目标。Classic 模式读取 proposal.md、design.md、tasks.md、specs 与关联 Design Doc,并用 comet state get 查询 phase、base_ref、plan、verification_report;Native 模式运行 comet native show 与 comet native status --details --json。随后用 git status --short --untracked-files=all 与完整差异建立实现范围,报告按严重度排序,含审查范围、证据状态、未决问题与结论,并在结尾提示这是只读手动审查。

限制:整个调用必须保持只读,不得修改、创建或删除文件,不得暂存、提交、切换分支、创建分支或工作树,不得运行 comet state select、comet native select、comet state set、comet state transition、phase guards、comet native next 或 archive 命令,不得修复发现、推进阶段或更新任务、状态、验证报告或审查记录;不得把该审查称为 Verify 通过,也不得把“无发现”当作测试通过的证明。仅运行读取文件、查询状态和检查 Git 差异所需的命令;可能执行项目代码、安装依赖或生成文件的检查不在范围内。若无法建立可靠基线,则审查可见的工作树差异并显著标注范围不完整。修复需作为新的写入任务处理。