SuperAPI AI 工具集

review-as-json

通用与其它

查看项目

更新于 10-15 21:38

技能介绍

用途:在代码变更上运行 /review 并严格遵循其流程,把评审结果以单个 JSON 对象输出,而不是散文式报告,主要供 CI 消费。

主要能力:输出对象包含 verdict(approve、changes_needed、hold)、summary、findings 数组、passes 与 sectionSummaries。每条 finding 含 severity(critical、warning、info)、type(issue、suggestion、question)、category(mission、architecture、implementation、craft、security、performance)、title、description、file、line 以及可选的 suggestedFix。passes 覆盖 mission、architecture、implementation、craft、security、performance 六个维度。

使用方式:在变更上运行 /review,并要求以 JSON 输出。输出规则要求只输出 JSON 对象,不要前言、评论或 markdown 代码围栏。severity 中 critical 会阻止合并(缺陷、安全漏洞、数据丢失),warning 应处理但非阻塞,info 为提示。summary 不要复述 verdict,而应回答原因。sectionSummaries 要说明底层主题而非仅计数。type 中 question 是待解答事项,suggestion 是可选改进,其余为 issue。每条 finding 的 category 即发现它的 pass。标记前需先验证:每条 finding 都要有具体文件、行号和后果,无法验证则改为 question。若无 finding,输出空数组并给出 approve。

适用场景与限制:适合 CI 中机器可读的评审输出;人工评审请直接用 /review。资料未提供安装命令、收费、价格、平台或效果等信息。