10 — Skills、系统技能缓存与 AGENTS.md ​

Skills crate：嵌入式系统技能 ​

codex-rs/skills 使用 include_dir! 将 内置样本技能 打进二进制，并在用户 CODEX_HOME 下缓存：

• 目录：skills/.system
• 指纹 marker 文件（.codex-system-skills.marker + salt v1）：内容哈希一致则 跳过重复安装，加快启动。

/// Installs embedded system skills into `CODEX_HOME/skills/.system`.
///
/// Clears any existing system skills directory first and then writes the embedded
/// skills directory into place.
///
/// To avoid doing unnecessary work on every startup, a marker file is written
/// with a fingerprint of the embedded directory. When the marker matches, the
/// install is skipped.
pub fn install_system_skills(codex_home: &Path) -> Result<(), SystemSkillsError> {

设计原因：系统技能随版本升级；清目录再写入 避免陈旧文件残留；marker 避免每次冷启动都碰磁盘。

codex-core 中的 Skills 子系统 ​

core/src/lib.rs pub mod skills 并 re-export SkillsManager、SkillInjections 等，负责：

• 从配置与项目路径 加载 skill 元数据；
• 注入 到 system/developer 消息（与 mention、$ connector 等协同）；
• 依赖解析、隐式调用探测（maybe_emit_implicit_skill_invocation）。

简明表述：Skill 是「可版本化的 prompt + 资源包」，介于「硬编码系统提示」与「用户当场粘贴」之间。

AGENTS.md ​

仓库 docs/agents_md.md 指向官网指南，并说明特性位 child_agents_md：开启时在用户说明中附加 层级 agent 范围与优先级 说明，且 即使没有 AGENTS.md 文件也会注入（避免「无文件就无提示」的缺口）。

根目录 AGENTS.md 则是 本仓库 给自动化代理的约束（Rust 规范、测试命令、codex-core 瘦身原则等），与 用户项目的 AGENTS.md 是同一格式的不同用途。

延伸阅读 ​

• 02 分层
• 12 Hooks