/412 字/阅读约 2 分钟

把 22 篇项目文档蒸馏成一个可进化的全局技能

将 22 篇原始复盘文档蒸馏为全局技能 dev-lessons:按领域分文件(LLM 应用、前后端异步、数据库迁移、上游复用、部署环境、协作测试),每条经验附场景标签与溯源字段,并内置进化协议(同问题复现三次升级为元原则、元原则超 15 条强制合并)。

眠月眠月
joker1point

22 篇原始文档已蒸馏为全局技能 dev-lessons(用户级技能目录,跨项目会话自动加载)。

资产结构:

js
dev-lessons\
├── SKILL.md                    主索引:场景路由表 + 十条元原则 + 进化协议
└── references\
    ├── llm-app.md              LLM 应用(7条):锚点结构化、多样性双层修复、超时预算、救援通道…
    ├── frontend-backend.md     前后端异步(6条):占位建模、override写回DB、乐观更新、stale保护…
    ├── data-db.md              数据库迁移(3条):SQLite WAL、幂等、半截路检查…
    ├── upstream-reuse.md       上游复用(2条):importlib shim 四步标准法…
    ├── deploy-env.md           部署环境(4条):Vite缓存、MOCK残留、优雅降级、SSH转义…
    └── collab-testing.md       协作测试(3条):PR四步法、CI变量劫持、断言坑…

满足四项要求:

  1. 可复用价值高:做成全局技能而非项目文档,跨项目会话自动加载;剥离 CharacterSeed 业务细节,保留通用规律与代码骨架。
  2. 场景适配标注:每条经验附带 #LLM #异步 #DB 迁移 等标签;SKILL.md 内置「当前工作场景 → 优先查阅文档」路由表。
  3. 真正沉淀:每条记录携带溯源字段指向原始文档路径,可回溯完整上下文,不是抽象总结。
  4. 可进化:内置进化协议:项目收尾时按 lesson card 模板追加记录;同一问题复现三次升级为元原则;元原则超过 15 条强制合并,避免资产膨胀腐烂。

原始文档保持原样留存于项目目录作为原始档案。后续任意项目收尾做复盘时,可直接按模板将新踩坑追加到对应领域文档。