# AGENTS.md

> 通用 AI coding agent（Codex 等）的仓库级薄入口。**全部硬规则以 [`CLAUDE.md`](CLAUDE.md) 为准**，本文只做导航。

## 开工顺序

1. 读 [`CLAUDE.md`](CLAUDE.md)：项目定位、修改原则、技术约定、安全与验证要求（唯一权威规则源）。
2. 读 [`docs/current-state.md`](docs/current-state.md)：当前快照、已验证事实、blocker。
3. 读 [`tasks.md`](tasks.md)：领取唯一任务（一次一个，依赖齐才领）。
4. `git log --oneline -10`：看最近发生了什么。
5. 需要背景再读 [`docs/README.md`](docs/README.md) 导航到设计文档 01~06。

## 完成任务后

- 更新 `tasks.md` 状态；追加 [`progress.md`](progress.md)（含真实验证命令与结果）；覆盖更新 `docs/current-state.md`。
- 验证入口统一走 `./init.sh`（阶段 0 前会提示先建骨架）。

## 红线（详见 CLAUDE.md）

- 严禁提交 `ask` 密钥、真实账号/机构码/身份证、`config.yaml`、`docs/账号.txt`、`scripts/` 联调脚本。
- 签名、serviceId、checkId、码表、幂等相关改动必须保守，以 `docs/01`、`docs/04`（含 §8 实测契约）为事实来源，不照搬 docx。