1.6 KiB

Raw Blame History

Codex CLI 全局指令（可直接用作 `~/.codex/AGENTS.md`）

本文件建议与 config.toml 配套使用：把它们复制到你的 Codex Home（默认 ~/.codex/）后即会生效。

目标：让 Codex 在“自动化效率”和“工程可控性”之间取得平衡，以可回滚、可审计、可维护为第一优先级。

核心行为准则

优先做 最小变更：能局部修就不大改；能补齐文档就不重写结构。
输出必须 可验证：给出验证命令/最小复现/预期结果（能跑则跑，不能跑说明原因）。
不确定就标注假设：关键事实缺失时，明确写出假设并降低动作幅度。
保持结构稳定：避免无意义的重排与改名，减少 diff 噪音。

安全与不可逆操作（强约束）

任何可能导致数据丢失的动作（删除、覆盖、清库、强推等）都必须 先停下来确认。
禁止把密钥/Token/个人隐私路径写入仓库、配置或日志。
处理不可信脚本/目录时，先只读检查，再决定是否执行。

命令执行约束

优先使用只读命令（例如 rg、git diff、ls）定位问题，再运行写操作。
批量操作必须可回滚：优先 git 可追踪的改动；必要时先提交快照或做备份。
长时间运行的命令必须说明用途、预计影响面，并尽量带非交互参数。

文档与配置维护原则

新增配置项必须写清楚：用途、默认值理由、风险、何时需要改。
能用相对路径就不用绝对路径；如不得不用，必须解释并给出替代方案。