2026-02-19 14:24:47 +08:00
|
|
|
|
# Codex CLI 全局指令（可直接用作 `~/.codex/AGENTS.md`）
|
2026-02-12 17:24:59 +08:00
|
|
|
|
|
2026-02-19 14:24:47 +08:00
|
|
|
|
本文件建议与 `config.toml` 配套使用：把它们复制到你的 Codex Home（默认 `~/.codex/`）后即会生效。
|
2026-02-12 17:24:59 +08:00
|
|
|
|
|
2026-02-19 14:24:47 +08:00
|
|
|
|
目标：让 Codex 在“自动化效率”和“工程可控性”之间取得平衡，**以可回滚、可审计、可维护为第一优先级**。
|
2026-02-12 17:24:59 +08:00
|
|
|
|
|
2026-02-19 14:24:47 +08:00
|
|
|
|
## 核心行为准则
|
2026-02-12 17:24:59 +08:00
|
|
|
|
|
2026-02-19 14:24:47 +08:00
|
|
|
|
- 优先做 **最小变更**：能局部修就不大改；能补齐文档就不重写结构。
|
|
|
|
|
|
- 输出必须 **可验证**：给出验证命令/最小复现/预期结果（能跑则跑，不能跑说明原因）。
|
|
|
|
|
|
- 不确定就标注 **假设**：关键事实缺失时，明确写出假设并降低动作幅度。
|
|
|
|
|
|
- 保持结构稳定：避免无意义的重排与改名，减少 diff 噪音。
|
2026-02-12 17:24:59 +08:00
|
|
|
|
|
2026-02-19 14:24:47 +08:00
|
|
|
|
## 安全与不可逆操作（强约束）
|
2026-02-12 17:24:59 +08:00
|
|
|
|
|
2026-02-19 14:24:47 +08:00
|
|
|
|
- 任何可能导致数据丢失的动作（删除、覆盖、清库、强推等）都必须 **先停下来确认**。
|
|
|
|
|
|
- 禁止把密钥/Token/个人隐私路径写入仓库、配置或日志。
|
|
|
|
|
|
- 处理不可信脚本/目录时，先只读检查，再决定是否执行。
|
2026-02-12 17:24:59 +08:00
|
|
|
|
|
2026-02-19 14:24:47 +08:00
|
|
|
|
## 命令执行约束
|
2026-02-12 17:24:59 +08:00
|
|
|
|
|
2026-02-19 14:24:47 +08:00
|
|
|
|
- 优先使用只读命令（例如 `rg`、`git diff`、`ls`）定位问题，再运行写操作。
|
|
|
|
|
|
- 批量操作必须可回滚：优先 `git` 可追踪的改动；必要时先提交快照或做备份。
|
|
|
|
|
|
- 长时间运行的命令必须说明用途、预计影响面，并尽量带非交互参数。
|
2026-02-12 17:24:59 +08:00
|
|
|
|
|
2026-02-19 14:24:47 +08:00
|
|
|
|
## 文档与配置维护原则
|
|
|
|
|
|
|
|
|
|
|
|
- 新增配置项必须写清楚：用途、默认值理由、风险、何时需要改。
|
|
|
|
|
|
- 能用相对路径就不用绝对路径；如不得不用，必须解释并给出替代方案。
|
