docs(skills,handoff): decision-method 2.7.5 / feature-first 1.7.1 / knowledge-upkeep 1.2.0(+8.6 注入预算)；T08 归档

dsh-server-docs/skills/dsh-knowledge-upkeep/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: dsh-knowledge-upkeep
-description: dsh 平台文档库 / 项目知识的**维护与纠偏方法**。当发现「文档与现状不符」「同一事实多处打架」「知识越积越碎」「AI 忘了某条规则」「要收敛或重构知识库结构」时使用；也用于定期体检。核心 = 六层知识结构（L0-L5）+ **分层判据（实体 vs 指针）** + Lint 四件套 + **漂移处理 SOP** + **自动化的边界（检测可自动，改写不可自动）** + 今天踩过的 5 个反例。**配套：`dsh-feature-first`（谁定什么）· `dsh-decision-method`（怎么定得对）· `dsh-change-workflow`（怎么落地）。**
-version: 1.0.0
-updated_at: 2026-09-12
+description: dsh 平台文档库 / 项目知识的**维护与纠偏方法**。当发现「文档与现状不符」「同一事实多处打架」「知识越积越碎」「AI 忘了某条规则」「要收敛或重构知识库结构」时使用；也用于定期体检。核心 = 六层知识结构（L0-L5）+ **分层判据（实体 vs 指针）** + Lint 四件套 + **漂移处理 SOP** + **自动化的边界（检测可自动，改写不可自动）** + 今天踩过的 5 个反例 + **§8.6「注入预算」维度**（每轮注入有上限 ⇒ 长文件后半段等于不存在；**先重排、后删减**）。**配套：`dsh-feature-first`（谁定什么）· `dsh-decision-method`（怎么定得对）· `dsh-change-workflow`（怎么落地）。**
+version: 1.2.0
+updated_at: 2026-09-16
 agent_created: true
 ---
 
@@ -131,3 +131,70 @@ python3 scripts/docs-consistency.py  # 事实：写死取值 + 跨页取值冲
 5. 两处技能副本 md5 一致吗？推服务器了吗？
 6. 临时/备份产物清了吗？
 7. 复数入口都改成"复跑取号"了吗？
+
+---
+
+## 8. 文档的「无效信息」分类与高价值写法（2026-09-16 加）
+
+> **起因**：用户问「AI 会话生成的文档是否有无效信息？是否需要一套方法，写出**简单明了、高价值、且不影响模型阅读**的文档？」
+> §4 处理的是「漂移」**一类**；本节把它扩成 **六类无效信息** + **不能删的红线** + **写作形态**。
+
+### 8.1 唯一判据（正反两面）
+
+> **去掉这一行，下一个会话会不会「做错事」或「变慢」？**
+> **会 ⇒ 必须留**（还要让它落在首屏）；**不会 ⇒ 可删 / 可降级到归档。**
+
+正面用法（决定"值不值得写"）：**这行会改变读者的下一步动作吗？** 不会 ⇒ 它只是背景装饰，压缩或删。
+
+⛔ **别把"更简洁"当目标** —— 目标是**行为相关性**。把必要的「为什么」删掉，AI 会在同一处**反复摇摆**，那是负收益。
+
+### 8.2 六类无效信息（2026-09-16 全部亲见，不是理论）
+
+| # | 类型 | 当日实例 | 处置 |
+|---|---|---|---|
+| 1 | **与可执行体不符** | `stop-dialog-guard.py` 注释写「15 万/120」，代码是 `120000/80` | ⛔ 以**代码 / 实测**为准改注释，不是反过来 |
+| 2 | **过期结论仍占"生效位"** | 记忆里「hook 确实在生效（09-13 取证）」——当天已被推翻 | **不删**：标注「已推翻 + 新结论 + 日期」，保留纠偏轨迹 |
+| 3 | **同一事实多处重复** | 同一技能在本机 / 文档库 / 镜像三副本 | 收敛到**单一来源**，其余只留指针（§2） |
+| 4 | **过程流水挤掉结论** | 日志里「我做了什么」淹没了「现在是什么状态」 | **结论前置**；流水降级到日志 / 附录 |
+| 5 | **中间产物混进正式文档** | 项目根 `_tmp_*`、`_中间产物_待清理/`（239 文件） | 集中到归档区，永不进正式文档；收尾清 |
+| 6 | **只写"给人看的套话"** | 「这个很重要」「要注意」—— 不含任何判据 | 换成**可执行判据**：什么条件下、做什么动作 |
+
+### 8.3 ⛔ 不能删的红线（「不影响模型阅读」的边界）
+
+**删「结论的装饰」，留「判断的依据」。** 以下五类删了会直接坏事：
+
+1. **判据与阈值**（数字 / 边界条件 / 优先级）
+2. **命令原文与路径** —— 删了 AI 得重新试错，这是**最贵的成本**
+3. **反例与踩坑**（现象 → 根因）
+4. **「为什么」（决策依据）** —— 删了会在同一处反复摇摆
+5. **失效 / 作废标注** —— 删了会让旧做法「复活」
+
+### 8.4 高价值文档的形态（动笔前先定这五条）
+
+1. **结论先行** —— 首屏 3 行给判定
+2. **状态与流水分离** —— 状态（现在是什么）= 常驻；流水（怎么变的）= 追加 ⇒ **分文件放**
+3. **一事实一处** —— 其余给指针
+4. **可执行** —— 给命令 / 判据 / 路径；⛔ 不给"建议注意"
+5. **排版** —— 按 `dsh-feature-first §5.4`（每节 ≤7 行 / 表格 ≤5 列 / **并列项各占一段**）
+
+### 8.5 自检三问（贴出去之前过一遍）
+
+1. **读者是「下一个会话」**（不是人）—— 它读完能**直接动手**吗？
+2. 这份里**有多少行会改变下一步动作**？占比低 ⇒ 该压缩。
+3. 我删掉的每一行，**有没有落在 §8.3 的红线**里？
+
+### 8.6 「注入预算」维度 —— 长文件的后半段等于不存在（2026-09-16 加，实测）
+
+> §8.1–§8.5 用「**行为相关性**」判该不该留。另有一条**独立于内容质量**的约束：
+> **每轮注入是有上限的** —— 超出上限的部分宿主不会给模型，**效果上等于这段不存在**。
+
+- **实测（2026-09-16）**：用户级 `MEMORY.md` 20,977 B / 11,712 chars，宿主**注入上限 ≈ 4,000 chars**。原排序下窗口只覆盖「钩子配置 + 环境路径」，**整节 `Preferences`（全部行为规则）落在窗口外** ⇒ 规则没写错，是**排序错**。
+- **⇒ 判据升级**：一份「每轮都要生效」的文件要同时过 **两条** —— ① 每行都过 §8.1 的判据；② **体量 ≤ 注入上限**（或硬规则必须全部落在窗口内）。超限时**先重排、后删减**：重排零损失，删减有丢规则风险。
+- **⛔ 不要用「删内容」解决超限**，正确顺序是：
+  1. **分类** —— 哪些是「每轮必须生效」（硬规则 / 事故级事实 / 禁令），哪些是「查阅型」（历史细节 / 取证过程 / 个别项目偏好）
+  2. **把硬规则整体排到最前**，使注入窗口正好覆盖它们
+  3. 查阅型内容留在窗口外**不算丢失**（本机仍可读），只需在其上方留一行指针
+  4. 重排仍不够才压措辞 —— 且**受压的必须是查阅型，不得压判据与命令原文**（§8.3）
+- **📌 排序契约（防复发）**：文件头必须显式写明「**注入上限 ≈ N 字符；排序即重要性；新增内容按序插入对应小节，⛔ 不要追加到末尾**」。少了这一行，下一次追加就会把重要规则顶出窗口 —— 这是**慢性失效**，没有任何报错。
+- **适用面**：一切「每轮注入」的文件 —— `MEMORY.md`、`CODEBUDDY.md`、`.codebuddy/rules/*.md`、各技能的 `description`。
+- **可复跑自检**：`wc -c <file>` ÷ ~1.8 ≈ 字符数，与上限比；**更直接的判据 = 看注入块结尾有没有被截断**（结尾被截断 ⇒ 已有内容在静默失效）。