简体中文 | English

面向 Codex 的精简全局工程基线。它只保留需求、设计、实施、验证、独立复审和授权边界；具体技术栈与业务事实留给项目级 AGENTS.md。

主 Agent：需求 + 设计 + 集成 + 验证 + 完成声明
    ├─ explorer / worker：有界探索或独立实现切片
    └─ 4 个只读 reviewer：设计、实现、数据一致性、视觉

自定义角色只保留：

• design_reviewer
• reviewer
• data_consistency_reviewer
• visual_reviewer

探索与实施复用 Codex 内置 explorer / worker。模型和 reasoning effort 由 codex/agent-routing.toml 统一管理，只有 routine 和 critical 两级。

Reviewer 只报告有证据且在范围内的问题。主 Agent 独立核验 finding，并依据需求自行设计最小修复；Reviewer 的实现建议不会自动成为修改要求。

git clone https://github.com/itstarts/agent-rules.git ~/agent-rules
cd ~/agent-rules
./install.sh
./install.sh codex-agents
./install.sh codex-agent-routing

三个入口彼此独立：

安装脚本使用绝对软链，请保留 clone 目录。事务、恢复、现有安装迁移和 CODEX_HOME 说明见安装细节。

全局规则不保存技术栈、命令、Schema 或业务契约。新项目可复制模板后按实际证据填写：

cp ~/agent-rules/project-template.md /path/to/project/AGENTS.md

git diff --check
bash -n install.sh
python3 -B scripts/validate_codex_agents.py
python3 -B -m unittest discover -s tests -p 'test_*.py'

更多说明见工作原理。

MIT © itstarts