自定义 Agent 全周期审计

要解决什么问题

自定义 Agent 与 Workbuddy 类「专家系统」往往只有 agents/*.md 和零散脚本，没有完整的 plugin.json 与 memory/ 树。时间一长，常见问题是：能力写在 MD 里但脚本或引用不存在、多处版本号对不上、Reference 死链、以及「审完仍放行」的虚假健康状态。手工翻文件很难系统归类，也更难在修症状之前定位根因。

工作流如何运转

技能先按语义与关键词做意图分级（快速查看、修复、升级验证、补能力、全量审计），并在阶段 0 用目标识别协议判定结构类型：standard / skill / custom / bare，只对适用维度打分，不因缺目录结构硬扣分。

全流程带 CP1～CP4 检查点：非快速模式在发现 P0/P1 后必须经你确认才进入修复。阶段 1 会并行启动三路审计（Agent 定义、Memory/References、Config/Script/Test），主进程合并去重后输出统一报告模板。修复轨道强调先根因分析、再诚实降级（把未实现声明从 MD/plugin.json/memory 中收回或标注），再按缺口类型补脚本、connector 或测试，最后在阶段 6 做版本同步与恢复验证。异常场景（无 Git、路径不存在、子进程超时等）在异常处理矩阵里有明确 fallback，避免静默跳过。

适用边界与注意点

• 调用前需明确目标路径与读写权限；备份优先 Git，不可用时用目录复制。
• 快速模式只过 CP1，直接出报告，不自动改文件；修复与全量才会动配置并走降级/实现循环。
• 非标准结构会跳过部分检查（例如轻量 Skill 不审 plugin.json 合规），报告会标注跳过维度。
• 反模式与细项清单在 references/ 与 scripts/audit_runner.py 等配套资源中，会话结束还应更新工作日志并清理临时基线文件。