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

2026-08-25 16:50:43 +08:00
parent 00f7a66918
commit da5678f260
21 changed files with 314 additions and 14 deletions
@@ -0,0 +1,28 @@
+---
+name: distill
+description: 从当前任务和项目证据中提炼可复用结论、决策与问题经验，并在用户确认后分流到 .craftkit 知识结构。适用于阶段性知识沉淀；任务交接、Agent 失效复盘、工作日志或未经确认写入知识库不应触发本 Skill。
+---
+
+# 提炼任务知识
+
+只沉淀有证据、适用范围明确且未来可复用的内容。大多数任务没有值得长期记录的知识是正常结果。
+
+## 核实任务
+
+读取本次对话和相关项目文件；在 Git 仓库中根据需要检查分支、状态、差异和提交。分别列出已完成、已验证、未完成和未验证内容，不以静态检查替代实际运行结果。
+
+## 候选分流
+
+按 [分流规则](references/routing.md) 为每个候选确定唯一主要去向。先展示内容摘要、证据、适用范围、目标路径和复用价值，并明确标记“尚未写入”。
+
+用户可以逐项确认、调整或拒绝。只写入已确认内容；已有文件必须先完整读取并保守合并，不建立同义平行记录。
+
+## 写入要求
+
+- 结论与证据分开，推断必须标明，未验证内容不进入长期知识。
+- 使用项目相对路径，不记录凭据、个人信息和无必要的内部地址。
+- 指向源码或文档位置，不复制大段源码、日志或对话。
+- 新证据与既有结论冲突时暂停，交由 `lessons` 的维护规则处理，不能静默覆盖。
+- 完成后报告实际写入、未采纳和未写入内容；Git 提交需要独立授权。
+
+`distill` 不生成接续提示词、不维护当前任务交接文件；需要继续任务时使用 `handoff`。
@@ -0,0 +1,4 @@
+interface:
+  display_name: "Distill Task Knowledge"
+  short_description: "从当前任务提炼并分流可复用项目知识"
+  default_prompt: "使用 $distill 从本次任务提炼有证据的长期知识，确认前不要写入。"
@@ -0,0 +1,11 @@
+# 知识分流
+
+| 内容 | 目标 | 不应进入的内容 |
+| --- | --- | --- |
+| 已验证、可复用的问题模式 | `.craftkit/knowledge/pitfalls/` | 单次偶发错误、未验证猜测 |
+| 重要技术选择及其约束 | `.craftkit/knowledge/decisions/` | 临时实现细节 |
+| 长期有效的项目事实 | `.craftkit/knowledge/` 的现有主题 | 可从源码立即得出的重复说明 |
+| 对开发决策有约束力的规则 | `.craftkit/standards/` | 仅本任务适用的偏好 |
+| Agent 使用与读取约定 | `.craftkit/agents/` 或 `AGENTS.md` | 业务知识正文 |
+
+当前任务状态、下一步动作和接续提示属于 `handoff`；Agent 为什么偏离属于 `trace`；经验条目的初始化、合并、审计和提升属于 `lessons`。