用途:审计项目现有文档是否能让编码智能体安全开始工作。默认不编辑文件,先报告缺口。
检查对象:根级智能体指令(如 AGENTS.md、CLAUDE.md 或等价文件);领域语言(CONTEXT.md 或 CONTEXT-MAP.md);持久决策(docs/adr/);智能体文档(docs/agents/ 或项目等价位置);构建、测试、负责人、安全与工具有关策略事实;package scripts、CI 配置、测试配置与明显入口点。文件缺失时应先直接检查仓库,再判定为缺口。
审计问题:文档应能让智能体回答:从哪开始阅读;如何安装、构建、运行、lint、类型检查与测试;哪些模块可能在范围内;哪些路径或操作需要批准;谁负责决策或评审;哪些已知风险不应被意外“修复”;允许哪些工具、连接器、技能、钩子及副作用。更完整清单可参考 readiness-questions.md。
输出:返回 ready、ready_with_gaps 或 not_ready;按最高风险缺口优先;附证据(文件路径或命令结果);为每个缺口给出具体修复建议;指出冗余或应转为技能的文档。不要要求占位文档;若某事实并非安全工作所必需,应说明。