audit-agent-context

用途

Audit Agent Context 用于审计当前仓库中的 AGENTS.md 和/或 CLAUDE.md 是否仍然反映项目的真实状态，包括目录结构、命令、技术栈、命名约定、声明范围以及多智能体协作规则。它的目标是发现并报告差异，而不是自动修正。技能会输出一份分类报告，具体是否修改由用户在后续明确步骤中自行决定并执行。

触发方式

• 用户执行 /audit-agent-context。
• 用户提出类似请求，例如“检查 AGENTS.md 是否仍然属实”“更新智能体上下文”“CLAUDE.md 是否已过时”或等价表述。

输入

无必填输入。可选传入一个不同于当前工作目录（cwd）的项目路径，例如审计某个子项目或 worktree 时使用。

工作流

1. 解析范围。

   • 项目根目录：git rev-parse --show-toplevel（若失败则使用 cwd）。
   • 定位所有相关的 AGENTS.md 和 CLAUDE.md：仓库根目录、若 cwd 不同则包括 cwd，以及声明的工作子目录中嵌套的文件。不假设每种文件只有一个——可能在不同层级存在多对。

2. 从每个找到的文件中提取可验证声明，不重写原文。重点查找：

   • 提到的路径与文件/文件夹名称（是否存在？是否仍在？）。
   • 引用的命令（build、lint、test、gentle-ai ...、herdr ... 等）——所引用的二进制/脚本是否存在或可调用？
   • 否定性声明（“没有代码”“没有 package.json”“没有测试”）——是否仍然成立？
   • 声明的命名/结构约定（例如 HU-0X-<slug>.md、PLAYBOOK-<ROL>.md）——实际文件是否符合？
   • 声明的范围（该 AGENTS.md/CLAUDE.md 覆盖哪些文件夹）与文件在目录树中的实际位置。
   • 多智能体协作规则（playbook 路径、技能名称、调用命令）。

3. 对照真实仓库核实每条声明。

   • 使用 Glob/Grep/Read 检查结构与内容；使用 git ls-files / git status 区分已跟踪与未跟踪内容。
   • 若仓库有代码且 CodeGraph 可用，在结构性问题上优先使用 CodeGraph，再进行大范围 grep（这是全局已生效的结构性问题规则）。
   • 对于命令，核实二进制/技能是否存在（.claude/skills、.agents/skills、package.json 脚本等）——不要仅为“验证可用”而执行有副作用的命令。

4. 为最终报告对每条声明分类：

   • ✅ 仍然有效——与现实一致。
   • ⚠️ 已过时——与实际状态矛盾（引用证据：文件怎么说 vs. 实际发现了什么）。
   • ❓ 无法自动验证——需要人工确认（例如业务决策或未来范围）。
   • 🆕 未记录——仓库中存在某些内容（文件夹、约定、技能、playbook），但没有任何 AGENTS.md/CLAUDE.md 提及。

5. 按被审计文件分组交付报告（若不止一个）。每项包含：引用的原文声明、发现的证据、分类。最后给出建议修改清单，以具体提案形式撰写（不应用），供用户决定哪些写入文件。

不可协商的规则

• 在本技能内绝不编辑 AGENTS.md/CLAUDE.md。应用修正是后续的明确步骤，不在本次审计范围内。
• 绝不假设未确认的意图。若某条声明含糊或依赖业务/团队决策，标记为 ❓，不靠猜测解决。
• 若被审计项目有自己的领域规则（例如本项目中的“Puntos Abiertos”或“Alcance — No incluye”），本技能同样受这些规则约束：不凭空发明范围，也不静默解决冲突。
• 若在解析出的范围内找不到任何 AGENTS.md 或 CLAUDE.md，需明确报告——这不是静默失败。

适用场景

适用于任何需要审计智能体上下文文件（AGENTS.md / CLAUDE.md）与仓库实际状态是否一致的仓库，包括多层级存在多个此类文件、或存在多智能体协作约定的项目。

限制

• 该技能对仓库只读：不写文件、不提交。
• 不自动修正任何内容，仅报告差异与建议。
• 无法自动验证的声明需人工确认。
• 步骤 2–4 是通用流程，不硬编码到 test-project 的结构，可用于审计任何仓库的智能体上下文。