docs: refine language for clarity in AGENTS.md

This commit is contained in:
Qiu Yuzhou
2026-10-02 10:55:45 +08:00
parent e9712a86c0
commit e3ca886b9f
+3 -3
View File
@@ -16,8 +16,8 @@ triage 标签使用五个默认角色名作为标签字符串(needs-triage / nee
single-context:根目录一个 `CONTEXT.md` + `docs/adr/`,按需惰性创建。见 `docs/agents/domain.md`。
现状与已定设计以当前代码、`CONTEXT.md` 和 `docs/adr/` 为准。仅 `CONTEXT.md` 和 `docs/adr/` 这两类文档持续维护为最新状态;判断当前实现时,以当前代码为事实依据。将设计文档或研究报告作为实现依据前,先在代码里核实相关描述。
现状与已定设计以当前代码、`CONTEXT.md` 和 `docs/adr/` 为准。仅 `CONTEXT.md` 和 `docs/adr/` 持续维护为最新状态;判断当前实现时,以当前代码为事实依据。将设计文档或研究报告作为实现依据前,应先在代码中核实相关描述。
`docs/design/` 记录对应任务执行时的需求、设计和规格,仅作参考,不代表最新代码的现状。
`docs/design/` 记录对应任务执行时的需求、设计与规格,仅作为历史参考,不代表最新代码现状。
`docs/research/` 收录研究报告:各文档记录写作时点调研的上游能力、候选方案与结论,不描述项目现状,也不代表已采纳的设计。
`docs/research/` 收录研究报告。各文档记录写作时点对上游能力、候选方案与结论的调研,不描述项目当前状态,也不代表相关设计已经被采纳。