用途:Codex Rules 用于把项目内的规则文件自动注入 Codex 上下文,让模型在会话和文件修改时遵循项目约定。启用插件后自动生效,无需手动调用。
主要能力:在 SessionStart 与 UserPromptSubmit 时注入静态项目指令;默认在 Codex apply_patch 之后注入与文件匹配的规则;PostToolUse 的动态输出作为附加上下文注入,并按插件数据会话去重。它不会重写工具输出。
支持的规则来源:CONTEXT.md、.omo/rules//*.md、.claude/rules//.md、.cursor/rules/**/.md、.github/instructions/**/*.md、.github/copilot-instructions.md。
环境配置:CODEX_RULES_DISABLED=1 可禁用;CODEX_RULES_MODE 取 both、static、dynamic 或 off;CODEX_RULES_MAX_RULE_CHARS 与 CODEX_RULES_MAX_RESULT_CHARS 控制字符上限;CODEX_RULES_ENABLED_SOURCES 指定启用来源,例如 CONTEXT.md,.omo/rules。从 pi-rules 迁移的用户可使用旧变量 PI_RULES_* 作为回退。
适用场景:需要让 Codex 遵循项目级或目录级规则、按文件类型应用不同约定的开发工作流。
限制:资料未提供安装命令、具体匹配算法细节、各来源优先级及冲突处理方式,暂未提供。