feat(knowledge): 新增复盘提炼与经验维护 Skill

plugins/knowledge/skills/lessons/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: lessons
+description: 初始化和维护 .craftkit 问题经验库，并按已确认的经验判据审计项目或提出规范提升建议。适用于经验条目的创建、合并、过时处理、回扫和提升；普通任务总结、直接修改代码或自动改写插件不应触发本 Skill。
+---
+
+# 项目问题经验
+
+统一维护 `.craftkit/knowledge/pitfalls/`。经验必须来自可复核证据，并明确现象、根因、处理、验证和适用范围；不把猜测或一次性任务细节升级为长期规则。
+
+## 选择模式
+
+- `init`：首次建立经验索引，读取 [初始化规则](references/init.md)。
+- `curate`：新增、合并、纠正或标记过时经验，读取 [维护规则](references/curate.md)。
+- `audit`：按条目中明确的扫描规则只读回扫项目，读取 [审计规则](references/audit.md)。
+- `promote`：把项目经验提炼为项目规范或 CraftKit 改进建议，读取 [提升规则](references/promote.md)。
+
+用户未说明模式时，根据目标提出建议并确认。初始化授权不包含重组，审计授权不包含修复，提升授权不包含修改目标规范或插件。
+
+## 共同边界
+
+- 先读取适用的 `AGENTS.md`、`.craftkit/README.md`、知识索引和已有经验，不建立第二套经验目录。
+- 不预建空分类；条目较少时保持扁平，只有检索确有困难时才提议分类。
+- 已有条目、索引和用户章节保守合并，不整文件覆盖。
+- 重命名、合并、删除、纠正和移动条目前展示影响并取得确认。
+- 不记录凭据、个人信息、机器绝对路径或大段源码与日志。
+- 写入完成后报告实际文件和未采纳建议；不自动暂存、提交或推送。

plugins/knowledge/skills/lessons/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Maintain Project Lessons"
+  short_description: "初始化、维护、审计并提升项目问题经验"
+  default_prompt: "使用 $lessons 维护项目问题经验，先确认模式和拟修改内容。"

plugins/knowledge/skills/lessons/assets/entry.md

@@ -0,0 +1,22 @@
+# 问题或决策信号
+
+- 状态：有效
+- 适用范围：
+- 最后验证：
+
+## 现象
+
+## 根因
+
+## 处理
+
+## 验证
+
+## 证据
+
+## 扫描规则（可选）
+
+- 范围：
+- 判据：
+- 排除：
+- 风险：

plugins/knowledge/skills/lessons/assets/index.md

@@ -0,0 +1,13 @@
+# 问题经验索引
+
+本目录保存经过验证、可跨任务复用的问题经验。文件名应直接表达症状或决策信号；条目较少时保持扁平，只有检索困难时才建立分类目录。
+
+## 分类
+
+当前尚未建立分类。新增分类时记录目录、收录边界和检索信号，不使用与当前项目无关的预设技术分类。
+
+## 使用方式
+
+1. 先按当前症状搜索文件名和正文关键词。
+2. 阅读条目的适用范围、证据和状态。
+3. 结论与当前代码或规范冲突时停止套用，并按维护流程确认纠正、保留或废弃。

plugins/knowledge/skills/lessons/references/audit.md

@@ -0,0 +1,11 @@
+# 按经验审计项目
+
+审计只使用条目“扫描规则”中的明确范围、判据、排除和风险口径。缺少可执行判据的条目列为人工提醒，不根据叙事自行发明扫描规则。
+
+1. 只读盘点条目并按文件域形成扫描计划。
+2. 展示每个域的来源条目、范围、命令或语义检查方法，等用户选择后执行。
+3. 优先使用 `rg` 等只读工具；需要语义判断时逐项核对代码上下文。
+4. 每个发现记录相对文件、行号、证据、命中原因、排除核对和风险等级。
+5. 输出到用户确认的报告位置；没有约定时先建议 `.craftkit/knowledge/audits/<date>/`，写入前确认。
+
+审计不修改代码、经验条目或规范。误报、修复建议和经验判据调整分别列出，等待后续确认。

plugins/knowledge/skills/lessons/references/curate.md

@@ -0,0 +1,11 @@
+# 维护经验条目
+
+新增前按症状、根因和影响组件检索现有条目。使用 `assets/entry.md` 作为字段提示，不强制保留空章节。
+
+- 重复：补充现有条目，不新建同义文件。
+- 同一机制的多个案例：保留一个机制主条目，案例作为证据或子节。
+- 新证据推翻旧结论：标记为待复核，展示冲突后让用户选择纠正、废弃或保留历史说明。
+- 完全失效：删除仍需确认；需要历史时优先保留状态和替代链接。
+- 分类困难：保持扁平，不为了目录整齐强行归类。
+
+每次修改都记录最后验证证据和适用范围。项目特定案例可以保留，但不得把它错误提升为跨项目规则。

plugins/knowledge/skills/lessons/references/init.md

@@ -0,0 +1,9 @@
+# 初始化经验库
+
+1. 检查 `.craftkit/knowledge/pitfalls/`、知识索引和适用的 Agent 说明。
+2. 目录已有内容时不重组，只报告索引缺口和冲突。
+3. 目录不存在时展示拟创建的 `INDEX.md` 内容；用户确认后仅创建目录和索引，不创建空分类。
+4. 项目尚无 `.craftkit` 时先使用项目初始化约定建立最小目录，不自行复制完整模板树。
+5. 检查 `.craftkit` 没有被整体忽略，且 `pitfalls/` 属于可共享内容；发现忽略冲突时停止处理。
+
+索引基于 `assets/index.md` 独立生成，并根据项目已有领域词汇补充；不得预置特定框架、组件或业务分类。

plugins/knowledge/skills/lessons/references/promote.md

@@ -0,0 +1,11 @@
+# 提升经验
+
+把项目经验中的通用结论提炼为项目规范或 CraftKit 改进建议，不直接修改目标载体。
+
+1. 确认源条目范围，并区分项目事实、通用工程规则和未验证推断。
+2. 读取目标仓库适用的 `AGENTS.md`、Skill 入口和规范索引，动态寻找唯一权威落点。
+3. 已有等价规则时建议补证据或链接，不重复写入。
+4. 生成建议 patch：目标文件、章节位置、建议条款、适用范围和源条目证据。
+5. 用户逐文件确认后才允许修改；修改插件、项目规范和源经验收敛是三个独立确认范围。
+
+提升时删除业务字段、专有路径和单项目偶然细节，只保留有跨项目证据的判断与规避动作。目标是 CraftKit 插件时仍须遵守该仓库迁移与知识产权规则。