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

58 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 按需阅读:语义自检(写完笔记后过一遍)
> 脚本管结构,这张清单管意思。写完后自检,只向用户报缺口和写得好的地方,不逐条背诵。
> 定位:这是给 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)
- [ ] 落到可确认表面:哪条路径、什么量级、跑什么命令。
- [ ] 不写"看起来能用"——验收标准要么可勾选,要么明确留给后续。
## 汇报形态
写完自检后,这样汇报(一行一缺口,没缺口就收口):
```markdown
**语义自检:<filename>**
✅ 稳定:动机独立成立 / 有 2 个真备选 / 后果代价收益兼备
⚠️ 缺口:
- Alternatives — 有"做了 vs 不做"稻草人,补一个与现行方案平行的真实选项
- Consequences — "性能提升"要落到哪条路径、什么量级
建议:修以上 2 处后落盘 / 可接受缺口,直接放行
```
用户接受缺口即放行;不接受就修再落盘。意思上的判断不是脚本,别把它撑成另一道检查。
## 这套自检生效了吗(观测判据)
每隔一段时间回看,以下信号说明自检在起作用;信号消失说明它在空转:
- 你向用户提的问题里,**不再出现**翻一下笔记树或 rg 一下就能答的事实性问题。
- 汇报里的每条缺口都带着**具体修法**(改哪节、补什么),而不是"建议再完善"。
- `rejected/` 和 Alternatives 里被否掉的路线,**不再被新会话重新提出**——这正是整套系统存在的理由。