.agent 文档入口 / .agent documentation entrypoint
这个文件主要给在 .agent/ 目录里浏览的人类读者看。
真正会被 Codex 自动发现的入口，应当放在仓库根目录的 AGENTS.md。
This file is mainly a convenience note for humans browsing inside .agent/.
The auto-discovery entrypoint for Codex should live at the repo-root AGENTS.md.
快速规则 / Quick rules
- 复杂任务请先读
.agent/PLANS.md与相关活跃 ExecPlan。 For complex work, read.agent/PLANS.mdand the relevant active ExecPlan first. - 如果计划已存在，直接从下一个未完成里程碑继续。 If a plan already exists, continue from the next unfinished milestone.
- 还有未完成里程碑时，不要为了状态汇报停下。 Do not stop for status updates while unfinished milestones remain.
- 停止前更新
Status、Progress、Surprises & Discoveries、Decision Log、Outcomes & Retrospective。 Before stopping, updateStatus,Progress,Surprises & Discoveries,Decision Log, andOutcomes & Retrospective.