用途
ai-engineering-review 是一个面向 AI 工程的代码审查技能,用于审查任何调用模型的方案或变更,包括 LLM 调用、提示词、智能体、工具使用、RAG、MCP、评估(evals)、防护栏(guardrails),以及微调或经典机器学习。它帮助识别模型贴合度、约束边界、评估覆盖、可观测性与纠错机制等方面的问题,并按真实后果对发现进行排序。当审查范围内没有任何内容涉及模型时,该技能会被跳过。
主要能力
- 支持两种审查模式:--mode=code(默认)审查源码、提示词、工具架构、配置和测试;--mode=plan 审查计划、规范或设计,对照 AF-1 至 AF-6 条款返回计划缺口和必需的补充项。
- 内置分阶段流程:Phase 0 加载协议、清单与项目策略;Phase 1 检测 AI 表面,无 AI 表面时按文档跳过;Phase 2 构建表面图、信任边界与自主性映射;Phase 3 执行框架检查;Phase 4 执行九个工程维度的逐项检查;Phase 5 按条件执行 RAG、智能体/MCP、微调/ML 扫描;Phase 6 核对提供商事实;Phase 7 生成 AI Gate 报告;Phase 8 通过 why-review 验证发现;Phase 9 在独立 --fix-loop 下执行修复并从头重新审查。
- 支持 --report-only 模式,作为只读叶子运行,仅返回报告与验证后的发现,不执行任何修复。
使用方式
该技能以 /skill 方式调用,通过参数选择模式,例如 --mode=code 或 --mode=plan,以及 --fix-loop、--report-only、--base <审查基线> 等选项。在 Codex 环境中,需调用 $skill-name 加载注册的 .agents/skills/<name>/SKILL.md 并执行,无需单独的 Skill 工具或 Claude 模式切换。审查时默认只读,只有通过 why-review --validate-findings 确认后的 --fix-loop 才会授权修复,且修复会触发从 Phase 0 开始的全新审查。每条发现必须注明所属条款(AF-n / AE-x.y)、清单 ID、file:line 或计划章节、P 级、触发路径与具体修复建议。
适用场景
适合在涉及模型调用的代码变更、分支或 PR 审查中使用,也适合在计划或设计阶段对 AI 方案进行审查。它可与安全审计、架构审查、集成测试审查、生产就绪审查和变更审查等技能配合,各自负责不同维度,避免重复报告缺陷。
限制
该技能明确要求不得编造成本、延迟、准确率等数字,无法测量的内容标记为 NOT VERIFIABLE。提供商事实(模型 ID、参数、限制、保留条款、弃用信息)必须从当前文档核验,记忆中的事实不能作为证据。审查为只读,直到发现经过验证;在 --report-only 模式下不得执行功能、安装依赖或调用付费模型。当范围内没有 AI 表面时,该技能会被跳过,不会为了制造覆盖而强行审查。缺失的事实会明确标注暂未提供。