diff --git a/AGENTS.md b/AGENTS.md index 3ff0c62c..1226851d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -55,28 +55,29 @@ ### 三条核心原则(按优先级) -1. 不自造黑话、不自创词语。用已有的词;必须引入新词,当场一句白话定义(三形态表与判据见 doc-conventions 第 4 节)。 -2. 简洁。同一意思只说一遍;能用一句不说两句。 -3. 介绍一个物体、一个概念、一个问题,多角度讲清楚;每角度一两句,禁止违背第 2 条。 +1. 不自造黑话、不自创词语。项目文档已立名与行业通用词=已有词;其余必须引入时当场一句白话定义(三形态表与判据见 doc-conventions 第 4 节)。为省字压出的新短语按造词处理,宁可多两字用现成说法。 +2. 简洁。同一意思只说一遍;能用一句不说两句。硬约束、数字、前提条件不参与压缩;信息完整与简洁冲突时保信息。 +3. 介绍一个物体、一个概念、一个问题,多角度讲清楚;每角度信息点 ≤3 个,禁止违背第 2 条。 ### 简洁细则 - 禁换说法重复:同一判断换个措辞再说一遍 = 违规。 -- 禁铺垫、过渡句、客套话、总结句。 +- 禁铺垫、过渡句、客套话、总结句。认领责任的一句(如「是我的失误」)不算客套;所禁是铺垫与重复道歉。 - 禁填充句式:其实/说白了/本质上来说——直接给结论。 -- 短句为主,一行一个意思。 -- 答完即止,不追加「还需要我……吗」。 +- 短句为主,一行一个意思;装不下拆成短句,不算啰嗦。 +- 答完即止。所禁是无新信息的客套邀约;回答含待用户决断的分叉或待授权动作时,末尾一句决策请求不受限。 ### 多角度细则 -- 触发:解释概念、评估方案、回答「X 好不好」。事实型小问题一句话直答,不硬凑角度。 -- 角度池(按问题选 2~5 个):现状(现在是什么、缺什么)· 本质(是什么、解决什么)· 代价(要什么前提)· 边界(何时不成立)· 对比(与替代方案差异)· 风险(最常见失败方式)。 +- 触发:解释概念、评估方案、回答「X 好不好」。事实型问题判据=答案能否一句装下:装得下一句直答;装不下按格式优先级上清单,不算硬凑角度。 +- 评估与呈报类第一行=结论行:判断+一句主理由;角度列表随后。 +- 角度池(示例集非封闭集,按问题选 2~5 个;机制与流程题可自造稳定轴命名):现状(现在是什么、缺什么)· 本质(是什么、解决什么)· 代价(要什么前提)· 边界(何时不成立)· 对比(与替代方案差异)· 风险(最常见失败方式)。 - 每个角度 = 关键词 + 一个判断 + 至多一句理由。 - 角度之间用编号,不用「另外、此外、同时」串联。 ### 格式优先级 -列表 > 表格 > 关键词+一句话。大段散文是最后手段。 +枚举用列表,二维对照用表格,按内容形态选;散文是最后手段。 ## 硬性红线(勿违反;操作细则在 process-conventions.md 与各规约)