cflmy
0ac661eef2
docs(design): 防警告疲劳机制 — stale 必须是「变更报告」而非「扫描报告」
触发:用户指出 []() 每次报 warning 会导致烦躁与忽略,机制必须先定再开工。
一、为什么标签检查特别容易被忽视
高频(标签密度≈每个取值/调用)、主观(自然语言断言,机器只能近似)、
持续(代码天天改)。且实测基线是**零噪音**:lib/ + ext/ai/ 共 59 文件跑 check,
warning=0、error=0 —— 标签校验会成为项目第一个持续警告源,一次就要做对。
二、疲劳的真正根因不是"报得多",而是「同一件已知的事被反复告知」。
目标改成三条硬约束:没有新信息就不说话 / 说了就能做点什么 / 说过的就不再重复。
三、六个机制评估
M1 分级(按证据强度:error=能证明断裂,warning=能证明变化但不知谁错,hint=弱信号)
M2 聚合(check 人类输出最多一行,细节进 --json / view / labels)
M3 基线(bootstrap 静默吸收,用于迁移后的存量)
M4 确认即静默(ack 台账,同指纹不再报)
M5 **结构化 diff(推荐核心)**:stale 只在「() 变了 ∧ [] 没变 ∧ 在本次变更集」时报
M6 文档内抑制 # noqa —— **否决**(污染文档、不可审计、会永久化;抑制只放台账/配置)
四、M5 的性质(这是把疲劳问题降级的关键)
零台账(git 即台账,无新文件/无合并冲突)、零基线(首次也安静)、
零重复(提交后 diff 清空报告即消失)、天生带 before/after(正好是 LLM 复核输入)、
格式化免疫(比 AST 指纹而非文本)。非 git 环境降级为 L1,仍安静。
五、推荐组合
默认:M5a + 默认 hint + check 最多一行 + 每条带定位/before-after/建议 + 变更集去重 + 非 git 降级
严格模式(知识库仓 opt-in):升 warning/error + 基线与确认台账 + **棘轮(允许存量、禁止新增)**
+ labels status 进 CI。棘轮是最值得抄的机制:老债不阻塞、新债立刻拦、债务数字可下降。
六、确认的三种语义:改标签 / 改代码 / 显式确认。
建议三者都提供,但显式确认留痕(confirmed_by + 次数)——**被反复确认的标签本身是坏味道**。
七、可证伪原则:只有能被证伪的断言才被检查。标签含反引号实体→参与 L1;纯口语→L1 不检查。
检查成本由书写具体程度决定,同时反向抑制"为凑数写废话"。
八、agent 节流:只对它自己刚改到的标签做检查,每轮一次,超 N 条只报前 N+汇总。
模型看到的是"你刚改的这处描述可能不成立",而不是"全仓库 200 处过期"。
九、防「用忽视解决」三道闸:债务可见(labels status 给数字)、可 gate(error)、
可审计抑制(labels audit + 过期抑制提示)。
十、验收指标(写进文档防走样):无变更时标签相关输出=0;单变更集提示≤3 或≤20%;
重复=0;可行动率 100%;误报≤10%;check 人类输出≤1 行;hint/warning 不影响退出码。
未改代码。附五项待决策(核心机制、默认级别、棘轮、确认留痕、check 聚合行是否常显)。
2026-10-22 13:44:36 +08:00
..
2026-09-04 16:57:43 +08:00
2026-08-28 15:54:47 +08:00
2026-10-22 13:06:57 +08:00
2026-09-24 20:05:25 +08:00
2026-10-22 13:40:02 +08:00
2026-09-14 11:33:11 +08:00
2026-09-04 09:11:36 +08:00
2026-08-07 13:28:32 +08:00
2026-09-14 11:33:11 +08:00
2026-10-22 13:06:57 +08:00
2026-09-28 16:44:39 +08:00
2026-10-22 11:59:14 +08:00
2026-09-14 10:16:48 +08:00
2026-09-14 15:33:45 +08:00
2026-09-14 13:03:03 +08:00
2026-09-24 20:05:25 +08:00
2026-09-07 20:15:36 +08:00
2026-09-28 16:44:39 +08:00
2026-09-13 20:38:53 +08:00
2026-09-10 14:47:43 +08:00
2026-08-28 17:47:59 +08:00
2026-08-28 16:06:11 +08:00
2026-09-28 16:44:39 +08:00
2026-10-16 11:47:28 +08:00
2026-10-16 11:11:54 +08:00
2026-09-17 09:28:28 +08:00
2026-09-17 09:28:28 +08:00
2026-09-07 22:14:51 +08:00
2026-09-07 16:13:22 +08:00
2026-09-07 15:50:33 +08:00
2026-09-24 20:07:59 +08:00
2026-08-12 14:40:55 +08:00
2026-08-12 13:59:51 +08:00
2026-08-12 13:59:51 +08:00
2026-09-07 10:53:56 +08:00
2026-08-28 15:54:47 +08:00
2026-08-28 15:54:47 +08:00
2026-10-16 17:33:24 +08:00
2026-09-17 21:00:10 +08:00
2026-08-28 10:33:05 +08:00
2026-09-13 15:09:45 +08:00
2026-08-25 14:58:46 +08:00
2026-09-18 16:01:40 +08:00
2026-09-18 10:17:39 +08:00
2026-09-17 20:58:21 +08:00
2026-09-17 20:54:02 +08:00
2026-09-28 11:06:38 +08:00
2026-10-15 15:28:46 +08:00
2026-10-18 01:39:36 +08:00
2026-10-18 14:51:12 +08:00
2026-10-22 13:14:03 +08:00
2026-10-22 12:46:13 +08:00
2026-10-22 12:46:13 +08:00
2026-08-13 10:03:21 +08:00
2026-08-13 10:03:21 +08:00
2026-08-06 17:52:33 +08:00
2026-10-22 13:40:02 +08:00
2026-09-22 19:03:03 +08:00
2026-09-14 11:38:24 +08:00
2026-10-22 12:53:03 +08:00
2026-10-15 15:28:46 +08:00
2026-09-24 19:51:24 +08:00
2026-08-18 11:20:46 +08:00
2026-10-18 12:42:15 +08:00
2026-10-18 12:42:15 +08:00
2026-08-18 11:20:46 +08:00
2026-10-16 11:47:28 +08:00
2026-10-22 12:53:03 +08:00
2026-10-22 11:52:27 +08:00
2026-09-14 15:33:45 +08:00
2026-09-14 10:16:48 +08:00
2026-10-22 11:52:27 +08:00
2026-09-07 20:27:19 +08:00
2026-09-09 09:14:18 +08:00
2026-09-07 20:02:43 +08:00
2026-10-18 00:43:31 +08:00
2026-09-09 09:27:06 +08:00
2026-09-07 20:10:12 +08:00
2026-09-07 20:15:36 +08:00
2026-09-09 09:22:00 +08:00
2026-08-13 10:03:21 +08:00
2026-09-07 20:32:58 +08:00
2026-09-07 20:37:28 +08:00
2026-10-15 15:28:46 +08:00
2026-09-09 09:42:13 +08:00
2026-09-09 09:04:29 +08:00
2026-09-09 09:42:13 +08:00
2026-09-07 20:10:12 +08:00
2026-09-07 20:02:43 +08:00
2026-09-07 20:15:36 +08:00
2026-09-09 09:42:13 +08:00
2026-08-11 09:45:08 +08:00
2026-09-14 11:38:24 +08:00
2026-09-07 20:27:19 +08:00
2026-09-09 09:22:00 +08:00
2026-09-09 09:14:18 +08:00
2026-10-15 15:45:52 +08:00
2026-09-14 11:33:11 +08:00
2026-09-01 09:59:03 +08:00
2026-09-01 10:06:56 +08:00
2026-09-18 09:02:53 +08:00
2026-10-15 14:13:42 +08:00
2026-10-15 13:12:53 +08:00
2026-10-15 20:36:12 +08:00
2026-10-15 13:12:53 +08:00
2026-10-15 13:12:53 +08:00
2026-09-14 13:39:12 +08:00
2026-10-15 20:36:12 +08:00
2026-10-15 14:13:42 +08:00
2026-10-15 14:13:42 +08:00
2026-08-07 09:41:53 +08:00
2026-08-07 09:41:53 +08:00
2026-10-22 13:44:36 +08:00
2026-08-29 10:35:13 +08:00
2026-09-04 13:43:35 +08:00
2026-09-28 11:36:45 +08:00