SuperAPI AI 工具集

audit-review

通用与其它

查看项目

更新于 10-15 23:47

技能介绍

用途:在完成任务、实现重大功能或合并到主分支前,调度 the-inspector 代理审查代码变更,尽早发现问题。核心原则是“尽早审计、经常审计”。

主要能力:the-inspector 只接收精心构造的上下文,不接收会话历史,从而专注于工作产物而非思考过程,并保留调用者上下文。审查结果按严重程度分级:Critical 需立即修复,Important 需在继续前修复,Minor 可记录后不阻塞进度,Wrong 可用技术理由反驳。

使用方式:先获取 Git SHA,例如 BASE_SHA=$(git rev-parse HEAD~1) 或 origin/main,HEAD_SHA=$(git rev-parse HEAD)。然后用 Task 工具调度 the-inspector,subagent_type 设为 "the-inspector",不要用 "general" 或 "general-purpose"。填写技能目录中的 the-inspector-prompt.md 模板,占位符包括 {WHAT_WAS_IMPLEMENTED}、{PLAN_OR_REQUIREMENTS}、{BASE_SHA}、{HEAD_SHA}、{DESCRIPTION}。最后根据发现的问题采取行动。

适用场景:并行执行中每个任务完成后、完成重大功能后、合并到 main 前;也可在卡住时、重构前、修复复杂 bug 后使用。与 Heist 流水线集成时,在 Crew Lead 完成领域后审计,在 Don 批准前做最终审计,临时工作则在合并前审计。

限制与注意:不要因“简单”而跳过审计,不要忽略 Critical 问题,不要带着未修复的 Important 问题继续,不要无证据地反驳有效技术反馈。若认为 inspector 有误,应提供技术理由和代码/测试证明,并使用 gangsta:receiving-orders 严格处理反馈。Omerta 合规要求 inspector 审查实际 diff 而非声明,且通过审计技能沟通,不直接与 Worker 沟通。