Agent 质检（agent-quality-check）
概述
对 Agent / AI 原生系统代码库做只读质量体检，检查维度来自 AI 实操培训 15 章能力标尺（系统提示、步骤设计、评估调试、架构、记忆 RAG、工具权限、规划、微调判断、部署省钱、安全对齐、多模态、多智能体、安全护栏、协议互通）+ 6 大高频盲区。产出分两阶段：体检报告 → 人工审核 → 改动指令。全程不修改代码，所有改动决策权在人工。
工作流（五步，顺序不可颠倒）
第 1 步：摸底（只读）
- 读项目根结构：README、PRD/需求文档、package.json / requirements.txt、目录结构。
- 识别系统类型：单 Agent / 多 Agent / Web 应用 + LLM / 云函数。判断是否含：LLM 调用、外部工具、数据库、用户输入、文件上传。
- 定位关键文件：系统提示词、LLM 调用点、工具/函数定义、鉴权逻辑、云函数入口、数据库访问、错误处理。
- 全程只读：不修改任何文件、不运行有副作用的命令。
第 2 步：体检
- 加载并执行
references/01-checklist.md的 15 章清单，先做「0. 通用横切：6 大高频盲区」，再逐维度核对。 - 每条发现必须三要素：位置（文件+行号）+ 现状摘录（原文/代码片段）+ 问题与建议。禁止"只写结论不写内容"。
- 按优先级分级：P0（安全/数据风险/核心功能错误）→ P1（明显缺陷）→ P2（优化项）。
- 信息不足无法判断的，列入「需人工确认项」，不硬编。
- 汇总「差距总表」：维度 × 发现数 × P0 数，标出最弱维度。
第 3 步：产出体检报告（交给人工审核）
按 references/02-output-formats.md「阶段一」格式产出报告文档：
- 文件名：
质检报告-<项目名>-<日期>.md - 存档位置：项目外或项目内专用目录（如
运维/），不放进被扫描代码区。 - 报告只描述现状与建议，不附改动指令；明确等待人工决策。
第 4 步：人工审核（硬门槛）
- 将发现清单逐条交给用户决策：做 / 不做 / 改。
- 不替用户决策，不跳过审核直接进第 5 步。
- 被否决的项记入「不改动清单」（含否决理由），防止后续被顺手加回来。
- 用户决策有调整的，按调整后的范围收敛改动清单。
第 5 步：产出改动指令（审核通过后）
按 references/02-output-formats.md「阶段二」格式，生成喂给代码编辑软件（TRAE / Cursor / Copilot / CodeBuddy 等）的执行文档：
- 文件名：
<IDE名>改动建议-<项目名>-<日期>-<主题>.md - 结构：改动总览表 → 逐项改动（文件相对路径 + 行号/锚点 + 可直接粘贴的代码块 + 目的 + 验证方法）→ 不改动清单 → 验收清单。
- 开头声明：只改列出的项，不要扩展；验收清单逐条独立可勾，含回归项。
硬性规则
- 只读不修改：扫描与报告阶段绝不修改代码、配置、数据；改动只存在于最终指令文档中。
- 证据化：每条发现必须有文件+行号+原文摘录；做不到就列入"需人工确认项"，不编造。
- 安全是主线：注入/越权/密钥类发现一律 P0；对照三道墙（提示词侧/工具侧/内容侧/系统侧）逐层查。
- 失败兜底必查：重试上限 → 降级路径 → 如实提示不编造，三步缺一即记发现。
- 人工审核门槛：未审核不得生成改动指令。
- 决策留痕：改动指令中写明每项"为什么改"与"不改什么"，供后续维护理解。
- 不写模糊词：报告与指令中禁止"适当/尽快/可能/视情况"等不可执行表述。
输出物清单
| 阶段 | 产物 | 给谁 |
|---|---|---|
| 3 | 体检报告（差距总表 + 发现清单 + 审核决策表） | 人工审核 |
| 5 | 改动指令（总览 + 逐项 + 不改动清单 + 验收清单） | 代码编辑软件直接执行 |
参考资料
references/01-checklist.md：15 章体检清单（检查项 + 失败信号 + 产出要求）references/02-output-formats.md：两阶段输出格式模板（报告结构 + 指令结构 + 衔接铁律）
按需加载对应文件，不一次性全读。
