# Claude / Codex 路径、加载和体量速查

平台机制会变。先探测当前环境和本机规则；涉及写入或尺寸上限时，优先核对当前官方文档或本机工具输出，不把这张表当永远不变的事实。

## 通用原则

- 区分三类文件：人工维护的规则、Agent 自动记忆、机器生成的历史/索引。它们不能共用同一套写入规则。
- `MEMORY.md` 只是文件名，不代表跨平台语义相同。尺寸阈值必须绑定平台和文件类型。
- 规则真身可能是 CLAUDE.md、AGENTS.md、override、导入或软链；以当前工作空间声明和实际加载链为准。
- 发现多个平台目录不等于每个平台都在使用。只审当前运行平台和用户明确纳入的安装面。

## Claude Code

| 用途 | 常见路径 / 规则 |
|---|---|
| 用户指令 | `~/.claude/CLAUDE.md` |
| 项目指令 | `./CLAUDE.md`、`./.claude/CLAUDE.md`、`CLAUDE.local.md` |
| 路径规则 | `.claude/rules/**/*.md` |
| 自动记忆 | `~/.claude/projects/<project>/memory/` |
| 自动记忆索引 | 上述目录的 `MEMORY.md` |
| Skills | `~/.claude/skills/<name>/SKILL.md` 或项目 `.claude/skills/` |

当前官方口径：

- CLAUDE.md 全量加载，但建议目标少于约 200 行；越长越消耗注意力并降低遵守度。这是质量预算，不是硬截断线。
- Claude 自动记忆 `MEMORY.md` 在会话启动时只加载前 200 行或 25KB（先到者）；主题文件按需读取。这个硬限制只属于 Claude 自动记忆，不适用于 Codex 生成记忆。
- Claude 原生读 CLAUDE.md。已有 AGENTS.md 的项目可用导入或软链同源；方向由项目规则决定，不擅自翻转。

## OpenAI Codex

| 用途 | 常见路径 / 规则 |
|---|---|
| Codex home | `$CODEX_HOME`，默认 `~/.codex` |
| 全局指令 | `$CODEX_HOME/AGENTS.override.md`，不存在时读 `AGENTS.md` |
| 项目指令 | 从项目根到当前目录逐级找 `AGENTS.override.md`、`AGENTS.md`、配置的 fallback |
| 全局 Skills | `$CODEX_HOME/skills/<name>/SKILL.md` |
| 项目 Skills | 项目 `.codex/skills/<name>/`（以当前 Codex 版本和环境为准） |

当前官方口径：项目指令链合并后默认最多 32KiB，由 `project_doc_max_bytes` 控制；越靠近当前目录的指令越晚加载。检查 override 和 fallback，不能只找根目录 AGENTS.md。

某些 Codex 环境还提供 `~/.codex/memories/`、rollout summaries 或 Chronicle 派生索引。这类文件可能由宿主管线生成：

- 先读当前环境给出的 memory instructions；没有明确授权时只读。
- 不直接改生成的 `MEMORY.md`、`memory_summary.md`、`raw_memories.md` 或 rollout summary。
- 用户明确要求更新记忆且环境允许时，只使用该 Codex 环境规定的 correction input，或通过官方 `/memories`、设置和 `memories.*` 配置控制生成与使用，再等待宿主 consolidation；不要自设文件尺寸目标、compact candidate 或项目级生成记忆门禁。

发现 `TEAM_GUIDE.md`、`.agents.md` 等文件时，只有它们出现在 Codex fallback 配置中才把它们当指令文件。

## 其他 Agent Skills 平台（Qoder、Kimi Code、iFlow、CodeBuddy、Cursor、Gemini CLI 等）

Agent Skills 是开放标准（2025-12 由 Anthropic 开放），已有约 40 个产品兼容本 skill 的分发格式。Claude Code 和 Codex 之外的平台不逐一维护速查表，用通用探测法：

1. **规则文件**：在项目根和上级目录找 `AGENTS.md`（跨平台事实标准）、`CLAUDE.md`，以及平台专属形态（如 `.cursor/rules/`、`.cursorrules`、平台设置里的项目指令）。哪份实际被加载，以当前平台文档和诊断入口为准，不猜。
2. **三分法归类**：把发现的每个知识文件归入三类之一——人工维护的规则、Agent 自动记忆、机器生成的历史/索引。归类不明时按机器生成处理（最保守）。
3. **记忆边界**：未知平台的记忆机制找不到官方控制面时默认只读；不把任何其他平台的尺寸阈值或写入规则套过来。
4. **降级用法**：宿主不支持 Agent Skills 时本 skill 仍可用——把 SKILL.md 全文作为规则文件或对话指令交给 Agent，references 内容按需跟进；执行边界不变。

## 共存检查

1. 列出实际存在的平台目录和 skill realpath。
2. 核对同名 skill 是否软链到同一真身、复制安装、或由更高优先级版本覆盖。
3. 只改权威真身；复制安装需要明确同步机制，不能假设会自动更新。
4. 软链在 Windows 或受限环境可能不可用，允许项目采用导入或生成镜像，只要现场规则明确且有一致性门禁。
5. 验证加载而不是只验证文件存在：使用平台提供的 instruction/skill list、`/memory`、status 或等价诊断入口。

## 官方复核入口

- Agent Skills specification: <https://agentskills.io/specification>
- Agent Skills 兼容产品名录: <https://agentskills.io>（showcase）
- Claude Code memory and CLAUDE.md: <https://code.claude.com/docs/en/memory>
- OpenAI Codex AGENTS.md: <https://developers.openai.com/codex/guides/agents-md/>
- OpenAI Codex Memories: <https://learn.chatgpt.com/docs/customization/memories>