Agent Skills
返回列表
Agent 只读质检

Agent 只读质检

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_db7376c0/read-only-quality-check。

技能介绍

要解决什么问题

Agent 与 AI 原生应用在快速迭代时,系统提示、工具权限、RAG、多智能体协作等往往散落在各处,单靠 Code Review 很难按同一套标尺系统性对照。更常见的情况是:要么直接让 AI 改代码、风险难控;要么只有笼统结论、缺少文件路径 + 行号 + 原文摘录,后续无法验收。

本技能面向代码库的只读质量体检:扫描阶段不修改任何文件,先产出可审核的差距报告,再在人工决策后生成给 TRAE / Cursor 等工具执行的改动指令。

技能如何工作

工作流固定为五步,且顺序不可颠倒:

  1. 摸底(只读):读 README、依赖清单与目录,识别单 Agent / 多 Agent / Web+LLM 等类型,定位系统提示词、LLM 调用点、工具定义与鉴权入口。
  2. 体检:加载 references/01-checklist.md,先做「6 大高频盲区」,再按 15 章能力标尺逐条核对;每条发现必须含位置、现状摘录与建议,并按 P0 / P1 / P2 分级。
  3. 体检报告:按阶段一模板输出 质检报告--.md,含差距总表与「需人工确认项」,明确等待人工决策。
  4. 人工审核:逐条决策做 / 不做 / 改,否决项记入不改动清单,未审核不得进入下一步。
  5. 改动指令:审核通过后按阶段二模板生成 改动建议---.md,含可粘贴代码块、验证方法与验收清单,并声明只改列出项。

硬性约束包括:注入与密钥类一律 P0;失败兜底须查重试上限、降级路径与如实提示;报告与指令中禁止「适当 / 视情况」等不可执行表述。

适用边界与注意点

  • 适合需要证据化清单与人工门槛的场景,不适合期望 AI 当场直接改仓的场景。
  • 信息不足时应列入需人工确认项,技能不应硬编结论。
  • 报告建议放在项目外或专用目录(如运维目录),避免混入被扫描代码区。
  • 参考资料 01-checklist.md、02-output-formats.md 按需加载,不必一次性全读。

使用场景

  • 多 Agent 项目准备合并主分支前,要按 15 章清单产出带行号的差距报告供评审会讨论
  • 接手含 LLM 与外部工具的 Web 应用,希望先只读扫描注入、越权与密钥暴露再决定是否改代码
  • 云函数 Agent 入口曾出现超时无降级,需对照失败兜底三步清单写进体检报告而非直接 patch
  • 培训结业团队用同一套能力标尺验收自研 Agent,先把 P0 项列入人工审核表再生成 Cursor 改动指令

适合人员

  • 负责 Agent 发版的技术负责人,需要结构化差距总表并在改代码前强制过一遍人工审核
  • 日常用 Cursor/TRAE 改仓的工程师,希望改动建议文档含路径行号、可粘贴片段与逐条验收清单
  • 对企业内 LLM 应用做安全合规自查的架构师,要求注入与密钥类发现一律 P0 并附原文证据
  • 刚落地 AI 原生应用的小团队,缺统一 Review 标准,想用体检报告替代口头「感觉还行」