From b03c710862c0c96fd745aed212f4d069c04e3654 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Sun, 25 Oct 2026 07:45:24 +0800 Subject: [PATCH] =?UTF-8?q?docs(=E8=A7=84=E5=88=99=E4=BF=AE=E8=AE=A2):=20?= =?UTF-8?q?=E5=9B=9E=E7=AD=94=E9=A3=8E=E6=A0=BC=E8=A7=84=E5=88=99=20v2?= =?UTF-8?q?=E2=80=94=E2=80=94=E6=8C=89=E4=B8=A4=E5=AD=90=E4=BB=A3=E7=90=86?= =?UTF-8?q?=E5=AF=B9=E7=85=A7=E8=AF=84=E4=BC=B0=E7=BB=93=E8=AE=BA=E4=BF=AE?= =?UTF-8?q?=E5=85=AB=E5=A4=84=EF=BC=9A=E2=91=A0=E5=B7=B2=E6=9C=89=E8=AF=8D?= =?UTF-8?q?=E5=88=A4=E6=8D=AE=E6=98=8E=E7=A1=AE=E4=B8=BA=E9=A1=B9=E7=9B=AE?= =?UTF-8?q?=E5=B7=B2=E7=AB=8B=E5=90=8D+=E8=A1=8C=E4=B8=9A=E9=80=9A?= =?UTF-8?q?=E7=94=A8=E8=AF=8D=E3=80=81=E5=8E=8B=E7=BC=A9=E9=80=A0=E8=AF=AD?= =?UTF-8?q?=E6=8C=89=E9=80=A0=E8=AF=8D=E5=A4=84=E7=90=86=EF=BC=88=E5=8E=9F?= =?UTF-8?q?=E5=88=99=E2=91=A0=EF=BC=89=EF=BC=9B=E2=91=A1=E7=A1=AC=E7=BA=A6?= =?UTF-8?q?=E6=9D=9F/=E6=95=B0=E5=AD=97/=E5=89=8D=E6=8F=90=E4=B8=8D?= =?UTF-8?q?=E5=8F=82=E4=B8=8E=E5=8E=8B=E7=BC=A9=E3=80=81=E4=BF=A1=E6=81=AF?= =?UTF-8?q?=E5=AE=8C=E6=95=B4=E4=BC=98=E5=85=88=EF=BC=88=E5=8E=9F=E5=88=99?= =?UTF-8?q?=E2=91=A1=EF=BC=89=EF=BC=9B=E2=91=A2=E6=AF=8F=E8=A7=92=E5=BA=A6?= =?UTF-8?q?=E4=BF=A1=E6=81=AF=E7=82=B9=E2=89=A43=20=E6=9B=BF=E4=BB=A3?= =?UTF-8?q?=E5=8F=A5=E6=95=B0=E9=99=90=E5=88=B6=EF=BC=88=E5=8E=9F=E5=88=99?= =?UTF-8?q?=E2=91=A2=EF=BC=89=EF=BC=9B=E2=91=A3=E8=AE=A4=E9=A2=86=E8=B4=A3?= =?UTF-8?q?=E4=BB=BB=E5=8F=A5=E4=B8=8D=E7=AE=97=E5=AE=A2=E5=A5=97=EF=BC=88?= =?UTF-8?q?=E7=AE=80=E6=B4=81=E7=BB=86=E5=88=99=EF=BC=89=EF=BC=9B=E2=91=A4?= =?UTF-8?q?=E6=8B=86=E7=9F=AD=E5=8F=A5=E4=B8=8D=E7=AE=97=E5=95=B0=E5=97=A6?= =?UTF-8?q?=EF=BC=9B=E2=91=A5=E8=BF=BD=E9=97=AE=E7=A6=81=E4=BB=A4=E6=94=B6?= =?UTF-8?q?=E7=AA=84=E4=B8=BA=E6=97=A0=E6=96=B0=E4=BF=A1=E6=81=AF=E5=AE=A2?= =?UTF-8?q?=E5=A5=97=E3=80=81=E5=90=AB=E5=86=B3=E7=AD=96=E5=88=86=E5=8F=89?= =?UTF-8?q?=E6=97=B6=E6=9C=AB=E5=B0=BE=E5=86=B3=E7=AD=96=E8=AF=B7=E6=B1=82?= =?UTF-8?q?=E4=B8=8D=E5=8F=97=E9=99=90=EF=BC=9B=E2=91=A6=E4=BA=8B=E5=AE=9E?= =?UTF-8?q?=E9=A2=98=E5=88=A4=E6=8D=AE=3D=E8=83=BD=E5=90=A6=E4=B8=80?= =?UTF-8?q?=E5=8F=A5=E8=A3=85=E4=B8=8B+=E7=BB=93=E8=AE=BA=E8=A1=8C?= =?UTF-8?q?=E5=9B=BA=E5=AE=9A=EF=BC=88=E5=A4=9A=E8=A7=92=E5=BA=A6=E7=BB=86?= =?UTF-8?q?=E5=88=99=EF=BC=89=EF=BC=9B=E2=91=A7=E8=A7=92=E5=BA=A6=E6=B1=A0?= =?UTF-8?q?=E5=A3=B0=E6=98=8E=E4=B8=BA=E7=A4=BA=E4=BE=8B=E9=9B=86=E9=9D=9E?= =?UTF-8?q?=E5=B0=81=E9=97=AD=E9=9B=86=E3=80=81=E6=A0=BC=E5=BC=8F=E4=BC=98?= =?UTF-8?q?=E5=85=88=E7=BA=A7=E6=94=B9=E6=8C=89=E5=86=85=E5=AE=B9=E5=BD=A2?= =?UTF-8?q?=E6=80=81=E9=80=89=E3=80=82=E8=AF=84=E4=BC=B0=E4=BE=9D=E6=8D=AE?= =?UTF-8?q?=EF=BC=9A8=20=E9=A2=98=E5=AF=B9=E7=85=A7=E5=AE=9E=E9=AA=8C?= =?UTF-8?q?=E5=87=80=E6=94=B6=E7=9B=8A=E5=85=A8=E6=AD=A3=E3=80=81=E5=BF=85?= =?UTF-8?q?=E6=94=B9=E7=BC=BA=E9=99=B7=E4=BA=94=E6=9D=A1=E5=85=A8=E6=95=B0?= =?UTF-8?q?=E5=AF=B9=E5=BA=94?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) 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 与各规约）