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

This commit is contained in:
zhiye.sun
2026-08-25 16:50:43 +08:00
parent 00f7a66918
commit da5678f260
21 changed files with 314 additions and 14 deletions
@@ -0,0 +1,11 @@
# 按经验审计项目
审计只使用条目“扫描规则”中的明确范围、判据、排除和风险口径。缺少可执行判据的条目列为人工提醒,不根据叙事自行发明扫描规则。
1. 只读盘点条目并按文件域形成扫描计划。
2. 展示每个域的来源条目、范围、命令或语义检查方法,等用户选择后执行。
3. 优先使用 `rg` 等只读工具;需要语义判断时逐项核对代码上下文。
4. 每个发现记录相对文件、行号、证据、命中原因、排除核对和风险等级。
5. 输出到用户确认的报告位置;没有约定时先建议 `.craftkit/knowledge/audits/<date>/`,写入前确认。
审计不修改代码、经验条目或规范。误报、修复建议和经验判据调整分别列出,等待后续确认。
@@ -0,0 +1,11 @@
# 维护经验条目
新增前按症状、根因和影响组件检索现有条目。使用 `assets/entry.md` 作为字段提示,不强制保留空章节。
- 重复:补充现有条目,不新建同义文件。
- 同一机制的多个案例:保留一个机制主条目,案例作为证据或子节。
- 新证据推翻旧结论:标记为待复核,展示冲突后让用户选择纠正、废弃或保留历史说明。
- 完全失效:删除仍需确认;需要历史时优先保留状态和替代链接。
- 分类困难:保持扁平,不为了目录整齐强行归类。
每次修改都记录最后验证证据和适用范围。项目特定案例可以保留,但不得把它错误提升为跨项目规则。
@@ -0,0 +1,9 @@
# 初始化经验库
1. 检查 `.craftkit/knowledge/pitfalls/`、知识索引和适用的 Agent 说明。
2. 目录已有内容时不重组,只报告索引缺口和冲突。
3. 目录不存在时展示拟创建的 `INDEX.md` 内容;用户确认后仅创建目录和索引,不创建空分类。
4. 项目尚无 `.craftkit` 时先使用项目初始化约定建立最小目录,不自行复制完整模板树。
5. 检查 `.craftkit` 没有被整体忽略,且 `pitfalls/` 属于可共享内容;发现忽略冲突时停止处理。
索引基于 `assets/index.md` 独立生成,并根据项目已有领域词汇补充;不得预置特定框架、组件或业务分类。
@@ -0,0 +1,11 @@
# 提升经验
把项目经验中的通用结论提炼为项目规范或 CraftKit 改进建议,不直接修改目标载体。
1. 确认源条目范围,并区分项目事实、通用工程规则和未验证推断。
2. 读取目标仓库适用的 `AGENTS.md`、Skill 入口和规范索引,动态寻找唯一权威落点。
3. 已有等价规则时建议补证据或链接,不重复写入。
4. 生成建议 patch:目标文件、章节位置、建议条款、适用范围和源条目证据。
5. 用户逐文件确认后才允许修改;修改插件、项目规范和源经验收敛是三个独立确认范围。
提升时删除业务字段、专有路径和单项目偶然细节,只保留有跨项目证据的判断与规避动作。目标是 CraftKit 插件时仍须遵守该仓库迁移与知识产权规则。