docs(规则修订): AGENTS.md 对话输出风格规则立版——新增「回答风格规则」节(三原则:禁自造黑话/简洁/多角度,含禁句式清单、角度池六项、格式优先级;只管对话输出,文档写作仍归 doc-conventions §2–§4);同批退役「用语红线」「呈报四问」两条(黑话判据指针并入新节第①款,四问四角度吸收进角度池现状/对比/风险;用户 2026-10-25 裁:旧两条实践未达对话预期,新节以用户提供的范文为骨架)
This commit is contained in:
1 parent
d67b7dad0b
commit
2c26614443
1 file changed
+27
-2
@@ -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()` 表路径
|
||||
|
||||
Reference in new issue
Block a user