用途
Deep Init Skill 用于在整个代码库中创建全面的、分层级的 AGENTS.md 文档，帮助 AI 智能体理解代码库结构。AGENTS.md 文件作为 AI 可读的文档，帮助智能体理解：每个目录包含什么内容、组件之间如何关联、在该区域工作的特殊指令、依赖关系与关联。
分层标签系统
每个 AGENTS.md（根目录除外）都包含一个父级引用行：
Parent context: ../AGENTS.md
这必须是可见的文本，绝不能是 HTML 注释。Claude Code 在记忆文件到达模型之前会剥离 HTML 注释，因此注释化的父级引用、生成时间以及被注释的 MANUAL 边界对智能体来说是不可见的。
这创建了一个可导航的层级结构：
/AGENTS.md ← 根目录（无父级行）
├── src/AGENTS.md ← Parent context: ../AGENTS.md
│ ├── src/components/AGENTS.md ← Parent context: ../AGENTS.md
│ └── src/utils/AGENTS.md ← Parent context: ../AGENTS.md
└── docs/AGENTS.md ← Parent context: ../AGENTS.md
加载模型
现成的 Claude Code 按文件名发现嵌套的 CLAUDE.md，从不加载嵌套的 AGENTS.md；根级 @AGENTS.md 导入也无法到达子目录。这里生成的嵌套文件由 OMC 的 PostToolUse 目录上下文注入器递送，它从每个被访问的文件向上遍历，并在每个会话中注入最近的 AGENTS.md/README.md 一次。
这意味着该层级结构需要 OMC 的钩子处于激活状态。当 OMC 钩子被禁用（DISABLE_OMC=1、OMC_SKIP_HOOKS=post-tool-use）或插件未注册时，为根文件添加根级 CLAUDE.md 符号链接或 @AGENTS.md 导入，并且预期嵌套文件将保持未被读取。
执行工作流
第 1 步：映射目录结构
使用探索任务列出所有目录，排除 node_modules、.git、dist、build、pycache、.venv、coverage、.next、.nuxt 等。
第 2 步：创建工作计划
为每个目录生成待办事项，按深度层级组织：Level 0 根目录、Level 1 /src /docs /tests、Level 2 /src/components 等。
第 3 步：逐层生成
重要：先生成父层级再生成子层级，以确保父级引用有效。对每个目录：读取所有文件、分析用途与关系、生成 AGENTS.md 内容、写入带有正确父级引用的文件。
第 4 步：比较与更新（如果已存在）
当 AGENTS.md 已存在时：读取现有内容、识别自动生成部分与手动部分（## Manual Notes 标题及其下所有内容会被保留）、比较新增文件/删除文件/结构变化、合并更新自动生成内容并保留手动注释、更新时间戳。
第 5 步：验证层级
验证父级引用是否可解析、没有孤立的 AGENTS.md、完整性、时间戳是否为最新。
空目录处理
- 无文件无子目录：跳过，不创建 AGENTS.md
- 无文件有子目录：创建仅含子目录列表的最小 AGENTS.md
- 仅有生成文件：跳过或创建最小 AGENTS.md
- 仅有配置文件：创建描述配置用途的 AGENTS.md
模板结构
每个 AGENTS.md 包含：目录名称、父级引用、生成与更新时间戳、Purpose（用途）、Key Files（关键文件表格）、Subdirectories（子目录表格）、For AI Agents（工作指令、测试要求、常见模式）、Dependencies（内部与外部依赖）、Manual Notes（人类编写的笔记，重新生成时保留）。
并行化规则
同层级目录并行处理，不同层级顺序处理（父级优先），大型目录为每个目录分配专门智能体，小型目录批量交给一个智能体。
适用场景与限制
适用于需要为大型代码库创建 AI 可读文档的场景。依赖 OMC 钩子来递送嵌套文件，钩子禁用时嵌套文件不会被读取。不编造具体功能效果。