用途
Agent Instructions Manager 用于创建和审计智能体指令文件（AGENTS.md、CLAUDE.md），检查其质量、一致性与最佳实践。其核心模型是：AGENTS.md 是内容的唯一权威来源；CLAUDE.md 是一个精简的 @AGENTS.md 导入存根，仅包含有限的、特定于运行环境的增量内容。该技能是指令文件创建以及 MCP Tool Preferences 插入或替换的唯一负责方。
主要能力
- 发现目标项目中的指令文件，报告哪些文件存在或缺失，以及哪些运行环境直接共享 AGENTS.md、哪些通过导入使用。
- 创建缺失的指令文件：先创建 AGENTS.md（权威源），再创建 CLAUDE.md（导入存根）。
- 审计 token 预算：检查 AGENTS.md 与 CLAUDE.md 的行数以及 AGENTS.md 中用户添加的祈使句数量。
- 检查提示缓存安全性：识别时间戳、内容中的日期、动态计数、绝对路径、条件性结构等可能破坏基于前缀的提示缓存的内容。
- 内容质量检查：构建/测试命令、抽象原则、冗余文档、硬性边界、Compact Instructions 章节、MCP Tool Preferences、工具输出示例等。
- 自动修复可修复问题（如缺失的 Compact Instructions、缺失或过时的 MCP Tool Preferences），仅在已验证的插入位置插入，不重写整个文件。
- 验证导入模式合规性：CLAUDE.md 必须恰好包含一行 @AGENTS.md，且不得重复 AGENTS.md 的内容。
- 插件冲突检查：读取 ~/.claude/settings.json 中的 enabledPlugins，过滤出非 levnikolaevich-skills-marketplace 的已启用插件，按冲突信号关键词评分（2 个及以上信号类别为 CONFLICT，1 个为 WARN，0 个为安全）。
使用方式
输入：项目上下文、dry_run 标志、可选的 runId、可选的 summaryArtifactPath。
输出：结构化 summary envelope，payload.status 为 completed / skipped / error，并在 changes / detail 中给出已创建文件、审计发现与警告。若提供 summaryArtifactPath，则将同一 summary JSON 写入该路径；若未提供，则内联返回 summary 并保持完全独立运行。若未提供 runId，则在发出 summary envelope 前生成独立的 run_id。
运行时：环境 worker 运行时，阶段包括 PHASE_0_CONFIG、PHASE_1_DISCOVER_FILES、PHASE_2_CREATE_MISSING_FILES、PHASE_3_TOKEN_BUDGET_AUDIT、PHASE_4_PROMPT_CACHE_SAFETY、PHASE_5_CONTENT_QUALITY、PHASE_6_IMPORT_PATTERN_COMPLIANCE、PHASE_7_WRITE_SUMMARY、PHASE_8_SELF_CHECK。
运行时规则：发出 summary_kind=env-instructions；独立运行自行生成 run_id 并写入默认 worker 家族产物路径；受管运行同时需要 runId 与 summaryArtifactPath，且必须将 summary 写入所提供的确切路径；在最终结果之前始终写入已验证的 summary 产物。
输出契约 payload 字段：files_found、files_created、quality_findings、token_budget、prompt_cache_safety、import_pattern_status、status。
适用场景
- 编辑任何指令文件之后
- 添加或移除 MCP 服务器或钩子之后
- 发布或出版之前
- 会话质量下降（出现上下文膨胀症状）时
- 首次项目设置（指令文件缺失）时
限制
- 自动修复仅针对可修复问题（Compact Instructions、MCP Tool Preferences），且仅在 dry_run 为 false 时执行；缺失构建/测试命令与抽象原则仅发出 WARN，需人工判断。
- 自动修复前必须验证插入点存在（在特定行找到确切标题）；若标题未找到则视为歧义，发出 WARN 并跳过，报告为需手动修复。
- 插入后需验证文件中不存在重复的 ## Compact Instructions 或 ## MCP Tool Preferences 章节。
- 关键规则：非破坏性文件编辑。自动修复仅在已验证位置插入章节，绝不重写整个指令文件，保留插入章节之外的所有现有内容。
- 若 .hex-skills/environment_state.json 报告 agents.codex.discovery_violation=true，需发出 WARN，说明 Codex 技能发现已漂移，在 ln-013-config-syncer 修复市场/插件对齐之前，不得将陈旧缓存中的重复技能计数用作指令审计证据。
- 若 .hex-skills/environment_state.json 报告 agents.codex.permissions_default_ready=false，需发出 WARN，说明 Codex CLI 启动权限已偏离受管默认值，在 ln-013-config-syncer 修复 ~/.codex/config.toml 之前，指令审计不得假定全访问启动语义。
- 版本：2.2.0；最后更新：2026-03-25。