- write-notes-like-deepseek 从三个子仓库的重复副本改为 meta 唯一副本 - 新增 .agents/scripts/verify-notes.ts,从 meta 视角一次校验四个笔记根 - workspace-layout 补「共有技能单一来源」的落位与理由 - .rgignore 排除 archived 历史快照
3.0 KiB
3.0 KiB
按需阅读:语义自检(写完笔记后过一遍)
脚本管结构,这张清单管意思。写完后自检,只向用户报缺口和写得好的地方,不逐条背诵。 定位:这是给 Agent 的自检,不是给脚本的规则——下列检查点全部是语义判断,永不进 verify 脚本。
动手前:先自己查,再问用户
- 这个"问题"真的是决策吗?——能用 §3 检索四法(入口注释若有 / 分类树 / rg / 模块文档)自己查到的事实,不要抛给用户。Finding facts is your job; 只有取舍和拍板才占用用户时间。
Problem
- 动机脱离方案也能独立成立——删掉 Decision 再读一遍,还是同一个问题吗?
- 触发清楚:什么破了、什么要变、不做会怎样。
Decision / Proposal
- 具体到能行动,不是"用更好的数据库"而是"为会话存储用 SQLite"。
- 理由是被"vs"逼出来的——写"决定用 X"就补一句"X vs Y 为何选 X"。
Alternatives considered
- ≥2 个真备选;不要编没权衡过的选项。「不做/复用」仅当当时真的考虑过才算一档,不是必填档。
- 每个被否项先写它最强的论据,再写为何否——只写弱处的拒绝是稻草人。
- 否掉的理由落到具体驱动条件,不是"经验上不行"。
Consequences
- 代价和收益都写。自问"什么变难了?维护成本是什么?"——只有收益的后果是挑选过的。
- 简化注明已知上限与何时该重访。没有升级触发条件的简化会悄悄变永久。
- 没有基线就不写相对量词——"提升了/更快了"说不清基线时,降级为事实陈述。
Verification / Testing(implemented)
- 落到可确认表面:哪条路径、什么量级、跑什么命令。
- 不写"看起来能用"——验收标准要么可勾选,要么明确留给后续。
汇报形态
写完自检后,这样汇报(一行一缺口,没缺口就收口):
**语义自检:<filename>**
✅ 稳定:动机独立成立 / 有 2 个真备选 / 后果代价收益兼备
⚠️ 缺口:
- Alternatives — 有"做了 vs 不做"稻草人,补一个与现行方案平行的真实选项
- Consequences — "性能提升"要落到哪条路径、什么量级
建议:修以上 2 处后落盘 / 可接受缺口,直接放行
用户接受缺口即放行;不接受就修再落盘。意思上的判断不是脚本,别把它撑成另一道检查。
这套自检生效了吗(观测判据)
每隔一段时间回看,以下信号说明自检在起作用;信号消失说明它在空转:
- 你向用户提的问题里,不再出现翻一下笔记树或 rg 一下就能答的事实性问题。
- 汇报里的每条缺口都带着具体修法(改哪节、补什么),而不是"建议再完善"。
rejected/和 Alternatives 里被否掉的路线,不再被新会话重新提出——这正是整套系统存在的理由。