From 2c266144430fae35ee5f5bab0878b25915649472 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Sun, 25 Oct 2026 07:10:17 +0800 Subject: [PATCH] =?UTF-8?q?docs(=E8=A7=84=E5=88=99=E4=BF=AE=E8=AE=A2):=20A?= =?UTF-8?q?GENTS.md=20=E5=AF=B9=E8=AF=9D=E8=BE=93=E5=87=BA=E9=A3=8E?= =?UTF-8?q?=E6=A0=BC=E8=A7=84=E5=88=99=E7=AB=8B=E7=89=88=E2=80=94=E2=80=94?= =?UTF-8?q?=E6=96=B0=E5=A2=9E=E3=80=8C=E5=9B=9E=E7=AD=94=E9=A3=8E=E6=A0=BC?= =?UTF-8?q?=E8=A7=84=E5=88=99=E3=80=8D=E8=8A=82=EF=BC=88=E4=B8=89=E5=8E=9F?= =?UTF-8?q?=E5=88=99=EF=BC=9A=E7=A6=81=E8=87=AA=E9=80=A0=E9=BB=91=E8=AF=9D?= =?UTF-8?q?=EF=BC=8F=E7=AE=80=E6=B4=81=EF=BC=8F=E5=A4=9A=E8=A7=92=E5=BA=A6?= =?UTF-8?q?=EF=BC=8C=E5=90=AB=E7=A6=81=E5=8F=A5=E5=BC=8F=E6=B8=85=E5=8D=95?= =?UTF-8?q?=E3=80=81=E8=A7=92=E5=BA=A6=E6=B1=A0=E5=85=AD=E9=A1=B9=E3=80=81?= =?UTF-8?q?=E6=A0=BC=E5=BC=8F=E4=BC=98=E5=85=88=E7=BA=A7=EF=BC=9B=E5=8F=AA?= =?UTF-8?q?=E7=AE=A1=E5=AF=B9=E8=AF=9D=E8=BE=93=E5=87=BA=EF=BC=8C=E6=96=87?= =?UTF-8?q?=E6=A1=A3=E5=86=99=E4=BD=9C=E4=BB=8D=E5=BD=92=20doc-conventions?= =?UTF-8?q?=20=C2=A72=E2=80=93=C2=A74=EF=BC=89=EF=BC=9B=E5=90=8C=E6=89=B9?= =?UTF-8?q?=E9=80=80=E5=BD=B9=E3=80=8C=E7=94=A8=E8=AF=AD=E7=BA=A2=E7=BA=BF?= =?UTF-8?q?=E3=80=8D=E3=80=8C=E5=91=88=E6=8A=A5=E5=9B=9B=E9=97=AE=E3=80=8D?= =?UTF-8?q?=E4=B8=A4=E6=9D=A1=EF=BC=88=E9=BB=91=E8=AF=9D=E5=88=A4=E6=8D=AE?= =?UTF-8?q?=E6=8C=87=E9=92=88=E5=B9=B6=E5=85=A5=E6=96=B0=E8=8A=82=E7=AC=AC?= =?UTF-8?q?=E2=91=A0=E6=AC=BE=EF=BC=8C=E5=9B=9B=E9=97=AE=E5=9B=9B=E8=A7=92?= =?UTF-8?q?=E5=BA=A6=E5=90=B8=E6=94=B6=E8=BF=9B=E8=A7=92=E5=BA=A6=E6=B1=A0?= =?UTF-8?q?=E7=8E=B0=E7=8A=B6=EF=BC=8F=E5=AF=B9=E6=AF=94=EF=BC=8F=E9=A3=8E?= =?UTF-8?q?=E9=99=A9=EF=BC=9B=E7=94=A8=E6=88=B7=202026-10-25=20=E8=A3=81?= =?UTF-8?q?=EF=BC=9A=E6=97=A7=E4=B8=A4=E6=9D=A1=E5=AE=9E=E8=B7=B5=E6=9C=AA?= =?UTF-8?q?=E8=BE=BE=E5=AF=B9=E8=AF=9D=E9=A2=84=E6=9C=9F=EF=BC=8C=E6=96=B0?= =?UTF-8?q?=E8=8A=82=E4=BB=A5=E7=94=A8=E6=88=B7=E6=8F=90=E4=BE=9B=E7=9A=84?= =?UTF-8?q?=E8=8C=83=E6=96=87=E4=B8=BA=E9=AA=A8=E6=9E=B6=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 29 +++++++++++++++++++++++++++-- 1 file changed, 27 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index af112d8d..ba66ce52 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -51,6 +51,33 @@ | 术语与已锁数值 | 规范名与定义 = `design/gdd/术语表.md`（全库唯一对照表，仅 owner 文档可修订）；现行数值 = `game/data/tables/*.tres`；规则与取值域 = 各系统 owner 文档。冲突须显式提出，禁默默改值 | | 现在做什么 / 待办与待裁 | 根 `roadmap.md` 顶部「当前位」节＋迭代总表六列 · 待办唯一登记处 `待办清单.md` · 批次过程与结论查 git 提交信息与 `reports/` | +## 回答风格规则（只管对话输出；文档写作归 doc-conventions §2–§4） + +### 三条核心原则（按优先级） + +1. 不自造黑话、不自创词语。用已有的词；必须引入新词，当场一句白话定义（三形态表与判据见 doc-conventions 第 4 节）。 +2. 简洁。同一意思只说一遍；能用一句不说两句。 +3. 介绍一个物体、一个概念、一个问题，多角度讲清楚；每角度一两句，不得违背第 2 条。 + +### 简洁细则 + +- 禁换说法重复：同一判断换个措辞再说一遍 = 违规。 +- 禁铺垫、过渡句、客套话、总结句。 +- 禁填充句式：其实／说白了／本质上来说——直接给结论。 +- 短句为主，一行一个意思。 +- 答完即止，不追加「还需要我……吗」。 + +### 多角度细则 + +- 触发：解释概念、评估方案、回答「X 好不好」。事实型小问题一句话直答，不硬凑角度。 +- 角度池（按问题选 2～5 个）：现状（现在是什么、缺什么）· 本质（是什么、解决什么）· 代价（要什么前提）· 边界（何时不成立）· 对比（与替代方案差异）· 风险（最常见失败方式）。 +- 每个角度 = 关键词 + 一个判断 + 至多一句理由。 +- 角度之间用编号，不用「另外、此外、同时」串联。 + +### 格式优先级 + +列表 > 表格 > 关键词＋一句话。大段散文是最后手段。 + ## 硬性红线（勿违反；操作细则在 process-conventions.md 与各规约） - 主工作区禁止直接改动与提交——一切改动走独立 worktree（豁免：`.zcode/` 与 `.qoder/` 两份本机 harness 配置，实测均不入 git） @@ -65,8 +92,6 @@ - 规则评估——没在真实任务上评估过的规则修订，不算完成。 - 中间产物吸收即死——结论先吸收进权威文档、未决先迁待办清单，文件即删且永不提交（doc-conventions 第 11 节） - **禁写变更记录**——文档与代码文件内一律禁设「版本历史／修订记录／变更记录／修改记录／更新记录／更新日志」节或表格，禁写「本版改了哪些条款」式逐版本叙述与 `# 2026-xx-xx 缺陷修批——` 式行内修订注记；沿革只进 git commit log。版本号可作文档现行身份标记留在文首状态行与正文引用中（doc-conventions 第 5 节，机检闸 gdd_lint R4 反转拦截） -- 用语红线——一切对用户输出禁自造黑话，需要作者解释的词必须展开成完整白话句（doc-conventions 第 4 节三形态表） -- 呈报四问（读后自检制）——向用户首次完整呈报一件事（需求／缺陷／方案／结论）时，写完先自查：读者只读这一段，能否不看原文答出——① 现状差在哪：现在是什么、缺什么；② 你建议做什么：做完预期什么效果、会动到哪些面；③ 为什么选这个做法：考虑过、放弃过哪些别的路；④ 做完怎么验证：哪些还有把握不足。哪问答不出就补哪问，禁靠加小标题凑数；三句话能说清的小件合并为三句：现状一句、建议与验证一句、没把握的一句；后续追问与推进不必重跑全框架 - 真人检测只登记不阻塞——登记进体验验证清单/实现报告即完成义务，禁以等目检为停工理由或当作合回的前置条件 - 文件头 = `##` 文档注释，介绍本模块是什么；禁写变更叙事（改动史查 git log）；禁文档反向链接（code-conventions §1.4.1） - 数值单一事实源——玩法数值只存 `data/tables/`（.tres）经 ConfigDB 单点读取；禁数值字面量与自建 `load()` 表路径