docs: 共有技能收归 meta 单一份并加工作区级笔记校验入口
- write-notes-like-deepseek 从三个子仓库的重复副本改为 meta 唯一副本 - 新增 .agents/scripts/verify-notes.ts,从 meta 视角一次校验四个笔记根 - workspace-layout 补「共有技能单一来源」的落位与理由 - .rgignore 排除 archived 历史快照
This commit is contained in:
@@ -0,0 +1,33 @@
|
||||
# 按需阅读:Class 分类
|
||||
|
||||
> SKILL §1 的展开。新建 Note 选 class 时对照。
|
||||
|
||||
## 封闭集(6 个,再加要改检查脚本)
|
||||
|
||||
| Class | 覆盖范围 |
|
||||
|---|---|
|
||||
| `feature` | 新增面向用户或模型的能力 |
|
||||
| `bug-fix` | 修缺陷或补 postmortem 暴露的缺口 |
|
||||
| `simplification` | 不新增能力的前提下删代码/行为/表面 |
|
||||
| `architecture` | 已发布源码的结构性决定——包如何关联、运行时词汇是什么 |
|
||||
| `process` | 代码之外的工具/策略/流程——门禁、包管理、vendoring 等 |
|
||||
| `testing` | 测试 infra 与策略 |
|
||||
|
||||
判定技巧:
|
||||
|
||||
- `architecture` vs `process`:前者是"发出去的源码长什么样",后者是"围绕源码的工具链与工作流"。
|
||||
- `refactor` 不单列——用 `simplification` 的判据"可观察行为变了吗"区分;行为不变即 simplification,行为变了归对应 feature/bug-fix/architecture。
|
||||
- `feature` 不只在"新增能力"时用——**用户/模型可见、不显然的行为或产品选择,changes 够不上架构,也归 `feature`**。判据是"行为是否可被用户或下游观察",而不是"改动了多少代码"。只有局部实现细节、普通重构、行为不变的依赖补丁才不写任何 Note。
|
||||
- 拿不准时看这条 Note 以后会被谁检索:找能力演进看 `feature`,找结构决策看 `architecture`,找门禁/发布看 `process`。
|
||||
|
||||
每条 Note 必带的语义要求(检查脚本管不了的):
|
||||
|
||||
- **Alternatives 只记录真实考虑过的对手方案**:先写它最强的论据再否——只写弱处的拒绝是稻草人。「不做/复用」仅当当时真的权衡过才写,不要编。
|
||||
- **简化必写代价上限**:`simplification` 的 `## Consequences` 要写明"这个取舍的已知上限是什么、什么信号发生时该重访"。没有升级触发条件的简化会悄悄变永久。
|
||||
- **验证要可确认**:写"改对了"时落到可被检查的表面(记"哪条路径、什么量级、跑什么命令确认"),没有基线就不要用相对量词——"提升了/更快了"在没有对比基线时是未验证断言,比不写更糟。
|
||||
|
||||
## 检查脚本
|
||||
|
||||
`scripts/agent-note-tree.ts` 定义 `AGENT_NOTE_CLASSES` 常量;未知 class 文件夹、lifecycle 根下的散落 `.md` 都会报错。新增 class 必须同时改常量和本文档,否则检查直接红。
|
||||
|
||||
分类封闭集与判据对齐 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的 notes 分类实践。
|
||||
Reference in New Issue
Block a user