init-deeplisted

# init-deep 为目标仓库建立一套耐久、简洁、有证据支撑的代理指引层级。`AGENTS.md` 是唯一权威载体，仓库根目录的 `AGENTS.md` 是主要产物；只有当子树确有不同的操作要求时，才增加更近的文件。 做完之后应当满足： - 后续会话能据此找到重要入口、改动应落在哪里、项目特有约束，以及权威的验证命令。 - 根文件写仓库共同规则，子文件只写局部增量，不复述父级内容。 - 每个含 `AGENTS.md` 的目录都有一个同目录 `CLAUDE.md`，内容只有对 `AGENTS.md` 的引用。 - 每条写入的内容都能指向具体来源；证据不足的内容宁可省略。 ## AGENTS.md 与 CLAUDE.md 的分工 Claude Code 只读 `CLAUDE.md`，不读 `AGENTS.md`。本技能用一行引用把两者接起来，指引本身始终只有 `AGENTS.md` 一个权威来源： - 每个 `AGENTS.md` 的同目录都要有一个 `CLAUDE.md`，**完整内容只有一行**： ```markdown @AGENTS.md ``` - `CLAUDE.md` 里不写任何其他内容——不加标题、说明、Claude 专属规则或补充条款。所有指引写进 `AGENTS.md`。 - 已有 `CLAUDE.md` 且含有实质内容时，先把其中仍然有效的规则并入同目录 `AGENTS.md`，再把 `CLAUDE.md` 缩减为那一行引用。内容较多或存在丢失风险时，先说明将要迁移和删除的内容并取得确认。 - 用户明确要求且平台允许时，也可以用符号链接（`ln -s AGENTS.md CLAUDE.md`）代替引用行；Windows 需要管理员权限或开发者模式，默认仍用引用行。 需要知道的加载规则： - 工作目录及其各级父目录的 `CLAUDE.md` 在会话开始时全量载入，从文件系统根向下拼接，越近的文件排在越后面。文件是拼接关系，不是覆盖关系，因此父子两级的规则会同时生效。 - 工作目录**以下**子目录中的 `CLAUDE.md` 不在启动时载入，只有当 Claude 读取该子目录��的文件时才带入；`/compact` 之后也不会自动重新注入。因此高频、跨模块的规则属于根 `AGENTS.md`。 - `@相对路径` 引用在载入时展开，最多四跳，相对于写引用的文件解析。 - 会话中用 `/context` 可以确认哪些指引文件实际载入。 - 仓库已有 `.claude/rules/` 或 `CLAUDE.local.md` 时，检查它们与 `AGENTS.md` 是否冲突并报告，但不把新指引写进去——避免权威分散到多处。 ## 授权与停止条件 先确认仓库根目录和用户授权的可写范围。初始化、修复、刷新一类请求即授权范围内的本地读取、编辑和非破坏性验证，连续做完即可，不必逐步征求同意��� 删除或覆盖难以恢复的内容、扩大目标仓库范围、执行明显昂贵的操作之前，先取得确认。只有当缺失的决定会实质改变范围、风险或产物时才提问。 若根 `AGENTS.md` 不在可写范围内，说明缺少的最小权限并停下，不要改用「只建子文件」来变通。关键证据读不到、仓库边界无法确定，或必要验证无法安全运行时，说明准确阻碍和最小下一步。 ## 查明现有指引与仓库边界 确定实际项目根目录；在多仓库工作区、子模块或嵌套版本库中，不要把工作区目录默认当作仓库根目录。记录用户指定范围与检测到的边界是否一致。 读取所有可能约束目