plan-auditor 是做什么的？
严格的计划 + 独立审计员智能体技能——通过真实的命令执行证据验证AI智能体的工作成果，绝不轻信智能体的自我报告。
概述
plan-auditor 是一个用于AI编码智能体（如Claude Code、Cursor、Codex）的技能组件。它在标准Shell环境中运行，核心目标是对AI智能体的输出进行独立验证。审计员不依赖智能体提供的任何自我断言，而是主动执行一组预定义或动态生成的系统命令（例如 ls、find、grep、wc、git status 等），从而获取真实、可重现的客观证据。
工作原理
- 任务执行阶段：AI智能体按照用户指令完成代码编写、文件修改或命令执行等任务。
- 审计触发阶段：智能体或用户显式调用
plan-auditor技能。 - 证据收集阶段：审计员根据预设的审计规则或动态生成的命令列表，逐一执行命令并捕获其标准输出、标准错误以及退出码。
- 独立判断阶段：审计员将收集到的证据与预期结果（如文件应存在、代码应无错误、函数计数应正确等）进行对比。若证据不符合预期，则生成失败报告；若符合，则输出通过确认。
- 结果输出：审计员生成结构化的审计报告（通常为 Markdown 格式），包含每个验证点的命令、实际输出、预期结果以及最终判定。
关键特性
- 不信任任何来自智能体的报告：所有断言都基于系统命令的真实输出，而非智能体的解释或摘要。
- 完全透明：审计员在执行时会展示正在运行的命令及其输出，用户可以全程查看验证过程。
- 可配置的审计规则：支持通过 YAML 或 JSON 配置文件定义审计点，包括命令、期望返回码、输出模式匹配等。
- 零外部依赖：仅依赖标准 Shell 命令，无需安装额外工具。
- 支持任何平台：只要目标环境提供标准 Shell 和核心 Unix 工具（如
bash、sh），即可运行。
使用方式
直接集成到智能体工作流
在 AI 智能体的提示或系统指令中，引入以下形式的审计指令：
- 你已启用 plan-auditor 技能。
- 在完成所有代码修改后，你必须调用 auditor 执行以下验证步骤：
1. 运行 `find ./src -name "*.go" | wc -l` 以确认新建文件数量。
2. 运行 `grep -r "TODO" ./src` 确认没有遗留的待办事项。
3. 运行 `go build ./...` 检查代码是否可以正常编译。
4. 如果任意步骤失败，在报告中明确列出失败项，并不要声称任务完成。
作为独立审计脚本
你也可以在本地直接运行审计脚本：
# 示例：执行自定义审计规则
./audit.sh -c audit-config.yaml
配置示例（audit-config.yaml）
checks:
- name: "文件存在性检查"
command: "ls -la ./output/data.json"
expected_exit_code: 0
description: "确认数据文件已生成"
- name: "代码编译检查"
command: "npm run build 2>&1"
expected_exit_code: 0
expected_output_not_contain: "ERROR"
description: "确认前端项目构建无错误"
支持的环境
- Claude Code：完美支持，作为自定义技能引入。
- Cursor：通过
.cursorrules或手动调用。 - Codex：作为开源脚本集成。
- 任何 Shell 环境：包括本地终端、CI/CD 管道（如 GitHub Actions）。
许可证
MIT