这是一个面向 Codex 的独立入口技能，目标是让 Codex 保持范围收敛、足够深入且节省资源。
用途：作为 Codex 的启动工作流，先做智能体文档自愈，再进入主任务；同时用于修复或控制 Codex 的常见失范行为。
主要能力 一、启动文档审计。按顺序检查仓库根目录与相关子目录的 AGENTS.md、.agents/CONTEXT.md、.agents/skills/local/ 下的仓库本地技能，以及 CLAUDE.md、GEMINI.md 等控制文件。缺口分为：missing（不存在）、stale（过时）、weak（缺少范围、约束、验证或路由规则）、conflicting（多份文档互相冲突）。 二、安全自愈。若修复可由仓库推断，则先改文档再继续任务；若取决于产品意图或团队策略，只提一个聚焦问题，不猜测。 三、上下文检测。按顺序查看 AGENTS.md、.agents/CONTEXT.md、package.json、tsconfig.json、next.config.、vite.config.、nest-cli.json 等，推断框架、语言、包管理器、验证命令及阻塞安全执行的文档缺口；证据足够时不再问设置问题。 四、恢复最小 .agents/CONTEXT.md。缺失或明显薄弱时，依据仓库证据还原最小草稿：项目名、技术栈摘要、包管理器、清单中的命令、当前技能映射、未确认的就绪项；不强制走完整引导流程。 五、自动修复策略。仅当仓库证据充分、改动收紧或恢复行为、规则属于操作性而非产品特定时才自动修补；遇到文档冲突、团队特定流程或涉及扩大自主权、分支策略、审批策略时，只问一个聚焦问题。 六、失败模式诊断。先分类主要问题：范围过大（无关改动、泛化重构、投机抽象）、范围过浅（浅层补丁、未触根因、验证薄弱）、漂移（旧任务恢复、重复劳动）、造工具漂移（写脚本、扫描器、报告代替直接工作）、长程膨胀。一次只针对主要失败模式，不用一个大提示块修全部。 七、交互默认值。镜像用户语言与技术深度；技能产物默认用英文；每个未决策略缺口最多问一个窄问题；优先直接查仓库而非探询式提问；把启动自愈视为任务一部分。 八、执行契约。用 Goal、Context、Constraints、Done when、Verify 结构重写任务，约束如：不做全仓库清理、除非在至少三处重复否则不加抽象、除非直接命令明显更差否则不建临时工具、除非任务需要否则不加文档或测试。 九、防过度工程与防浅层守卫。优先改现有文件而非新增层；拒绝投机抽象；helper 限于单一用途探针或短脚本；避免“面向未来”措辞；补丁前先自问：直接编辑为何不够、现在消除什么重复成本、最小可行版本是什么。要求最终修复前给一句根因说明；列出受影响面而非只列改动文件；验证行为而不只验证语法；验证受阻时以阻塞点停下，不谎称完成。完成最低标准：根因、改动面、验证、剩余风险。 十、长会话与压缩处理。重新锚定最新目标，用 Done when 校验下一步动作，不确认旧子任务，把大工作拆成带验收标准的里程碑。 十一、控制 helper 与子代理蔓延。一次性 helper 保持短小可弃；不生成报告器、仓库扫描器、迷你框架；只委派有边界的附属工作；不重做子代理已成功完成的工作。 十二、规则落位。跨任务稳定规则放 AGENTS.md；启动审计与自愈规则放 AGENTS.md 加本技能；技术栈、命令、技能映射放 .agents/CONTEXT.md；细节证据移到 references/。
使用方式：在需要单一 Codex 入口技能、修复或控制 Codex 行为时使用；技能正文含可复制的执行契约块，以及 references/agent-doc-self-heal.md 和 references/codex-latest-notes.md 两个参考文件。
限制：资料未提供具体安装命令、平台支持范围、收费与价格信息，暂未提供；实际效果取决于仓库证据是否充分，策略类改动需人工确认。