From e3ca886b9fb87a4fa304f87ce1f923bad9dfe51e Mon Sep 17 00:00:00 2001 From: Qiu Yuzhou Date: Fri, 2 Oct 2026 10:55:45 +0800 Subject: [PATCH] docs: refine language for clarity in AGENTS.md --- AGENTS.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 93f98c05..1834c42c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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/` 收录研究报告。各文档记录写作时点对上游能力、候选方案与结论的调研,不描述项目当前状态,也不代表相关设计已经被采纳。 \ No newline at end of file