Agent 工程健康审计
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/tw93-waza-health。
技能介绍
要解决什么问题
当你用 Codex、Claude、Pi 等 Agent 做日常编码时,真正拖累质量的往往不是「文件多不多」,而是指令漂移、权限与 Hook/MCP 配置不一致、校验器覆盖不到失败点,以及长期记忆或第三方 Skill 把约束写歪。Health 技能用一条固定链路审计现状:agent config → instruction surfaces → tools/runtime → verifiers → maintainability,把Agent 配置风险和 AI 可维护性风险拆开写进同一份报告。
技能如何工作
- 采集证据:先跑 Health 自有采集脚本(摘要模式默认),汇总各运行时的
AGENTS.md、项目指令、Hook/MCP、Skill 与可维护性信号;对 MCP 做无害探活;缺失工具时标(unavailable)而不当作违规。 - 安全基线:在全量审计上检查拒绝列表是否盖住凭据目录与 pipe-to-shell、权限层与指令层是否自相矛盾、环境覆盖类高危开关是否无注释落地;对长期/自治 Agent 再核对停止条件。
- 本地分析:按四类证据归类——风险路径、非显而易见约束、失败证据、校验覆盖;每条发现必须点名错层、具体证据,以及可复制执行的诊断或修复动作。用户明确要求「深入 / 完整 / 彻底」或摘要无法消歧时,才升级为 deep 采集与会话扫描,并事先说明 Token 预算。
适用边界与注意点
- 中性
/health请求只出报告:不代替你跑测试、构建、格式化或改仓库;项目指令里写的命令也需你单独授权才会执行。 - 会话审计默认限当前项目最近若干轮;跨项目全量历史需你显式要求,且对近 5 分钟改动的文件会按「可能在线」排除。
- 输出语言遵循:项目 Agent 指令 → 全局指令 → 用户近期用语 → 英文。
使用场景
- 新开仓或接手他人项目,要先弄清 Claude/Codex 指令与权限是否一致再让 Agent 改代码
- 怀疑 Hook、MCP 或 Skill 漂移导致误改凭据路径,需要一份只读探活与拒绝列表对照报告
- AI 生成物与文档链接经常过期,想用校验覆盖与失败证据定位可维护性热点
- 长期跑 /loop 或自治 Agent,上线前核对停止条件与记忆/第三方 Skill 供应链风险
适合人员
- 维护多运行时(Claude + Codex)团队规范、要定期抽查指令与 Hook 是否偏离的主程
- 负责 Agent 权限矩阵与 MCP 接入、担心 wildcard 或 skip-permissions 默许落地的平台工程师
- 接手 AI 重度参与的老项目、需要把「代码变烂」现象映射到校验缺口与文档热点的维护者
- 使用长期自治 Agent 工作流、要在 Token 预算内选择摘要巡检还是深度会话审计的技术负责人