tomevault-io Agents Md Compress
Core Objective
将冗长 AGENTS 文档压缩为高密度、可检索、可执行的索引文档，提升规则命中率与一致性。
Core Thinking
- 优先“检索导向推理”，避免仅依赖预训练记忆。
- 用“被动上下文”降低决策成本：关键规则直接放在 AGENTS 顶部，减少额外检索动作。
- 用“结构化索引行”替代解释性段落，提升解析稳定性。
必须保留关键指令行：
|IMPORTANT: Prefer retrieval-led reasoning over pre-training-led reasoning for any project tasks.
Hard Format Constraints
- 第一行必须是
# AGENTS.md。 - 除标题外，所有非空行必须以
|开头。 - 优先使用以下两种表达：
- 文件索引：
|Category:path:{file1,file2,file3} - 命令/规则：
|Category:value1|value2|value3
- 文件索引：
- 删除长段落、代码块、深层标题（
##/###）。 - 目标文档通常控制在 15-35 行；超长时拆分到
references/。
Language Policy (Mandatory)
- 规则说明文本默认使用目标项目主要语言（中文或英文）；若仓库已有语言规则，优先遵循仓库规则。
- 路径、命令、文件名、目录名、代码标识（类名/方法名/注解/配置键）保留英文。
- 不修改 mandatory
|IMPORTANT:行英文原文。
Meta Directory Policy (Mandatory)
- 官方目录事实必须准确表述：repo skills 位于
.agents/skills，user skills 位于$HOME/.agents/skills，admin skills 位于/etc/codex/skills（或企业约定系统目录），system skills 由 Codex 内置。 - 官方目录事实必须准确表述：project subagents 位于
.codex/agents，user subagents 位于~/.codex/agents。 - 官方目录事实必须准确表述：mcp/config 位于
~/.codex/config.toml或.codex/config.toml；trusted project 下可沿repo root -> cwd逐级加载多个.codex/config.toml，且近目录覆盖远目录。 - 项目可在官方事实之上增加更严格目录约束（例如“本仓库
.codex仅保留agents/与config.toml”），但必须显式标注为“项目约束”，不得写成官方硬性规则。
Execution Workflow
- 读取当前
AGENTS.md，提取最高优先级事实（结构、命令、约束、校验方式）。 - 校验关键路径是否真实存在，避免无效索引。
- 按索引格式压缩重写，仅保留可执行信息。
- 涉及自动触发时，按当前项目实际技能名与路径补充以下行（禁止硬编码）：
|Local Skills:<skills-dir>:{<skill-name>[,<other-skill-name>]}|Skill Trigger:Use <skill-name> when request mentions AGENTS.md creation, compression, or rule updates.
- 运行校验脚本并修正失败项。
Quality Gate
运行：
python <skill-root>/scripts/example.py AGENTS.md- 若
python不可用，执行等价静态校验：标题行、|IMPORTANT:、标题后行前缀、禁用##/###/code fence。
通过标准：
- 标题行正确。
- 存在
|IMPORTANT:行。 - 标题后非空行全部以
|开头。 - 不含
##/###/代码围栏。 - 语言策略满足：说明遵循目标项目语言，命令类元素英文。
Reference Loading Guide
按需加载，不要一次性全读：
- 压缩模板与示例：
references/api_reference.md - 原则、符号、格式边界：
references/compression_principles.md - 检查清单与反例：
references/checklists_and_antipatterns.md - 定期维护策略：
references/maintenance.md
Source: LuckyKuang/codex-tokens-compress — distributed by TomeVault.