Files
lpt-meta/.agents/skills/write-notes-like-deepseek/references/quality-gate.md
T
cat-shark f99e1e156d docs: 共有技能收归 meta 单一份并加工作区级笔记校验入口
- write-notes-like-deepseek 从三个子仓库的重复副本改为 meta 唯一副本
- 新增 .agents/scripts/verify-notes.ts,从 meta 视角一次校验四个笔记根
- workspace-layout 补「共有技能单一来源」的落位与理由
- .rgignore 排除 archived 历史快照
2026-11-18 14:59:45 +08:00

3.0 KiB
Raw Blame History

按需阅读:语义自检(写完笔记后过一遍)

脚本管结构,这张清单管意思。写完后自检,只向用户报缺口和写得好的地方,不逐条背诵。 定位:这是给 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 里被否掉的路线,不再被新会话重新提出——这正是整套系统存在的理由。