用途：为代码仓库创建或更新贯穿整个代码库的分层 AGENTS.md 文档，帮助 AI 代理理解每个目录的内容、组件关系、特殊指令与依赖，同时保留用户手工笔记。支持 Claude Code、Codex/OMX、Gemini 及 Antigravity/OMA 项目。
主要能力：每个 AGENTS.md（根目录除外）带 <!-- Parent: ../AGENTS.md --> 父级引用，形成可导航层级；提供统一模板，含 Purpose、Key Files、Subdirectories、For AI Agents、Dependencies 及 <!-- MANUAL --> 手工保留区；在已有 AGENTS.md 时进入更新模式，比较新增/删除文件与结构变化，合并自动生成内容并保留仍有效的手工指令，对过时指令做标记而非静默删除；提供层级校验脚本。
使用方式：在已有 AGENTS.md 或运行时目录的仓库上运行前，先阅读 references/scope-and-preservation.md；按“映射目录结构 → 生成工作计划 → 按层级逐级生成（先父后子）→ 比较并更新 → 校验层级”流程执行。校验命令为 python3 .agent-skills/deepinit/scripts/validate_agents_hierarchy.py .。
适用场景与限制：适用于多目录、需 AI 代理理解结构的代码库。默认排除 .git/、node_modules/、dist/、build/、coverage/、.next/、.nuxt/、pycache/、.venv/、venv/ 及 .omc/、.omx/、.survey/、.codex/、.claude/、.gemini/、.agents/、.opencode/、.ouroboros/ 等运行时状态目录；.agent-skills/ 保留在范围内。空目录、仅生成文件目录等按规则跳过或生成最小文档。资料未提供其他收费、平台或效果信息。