CraftKit/plugins/knowledge/skills/distill/SKILL.md

name, description

name	description
distill	从当前任务和项目证据中提炼可复用结论、决策与问题经验，并在用户确认后分流到 .craftkit 知识结构。适用于阶段性知识沉淀；任务交接、Agent 失效复盘、工作日志或未经确认写入知识库不应触发本 Skill。

提炼任务知识

只沉淀有证据、适用范围明确且未来可复用的内容。大多数任务没有值得长期记录的知识是正常结果。

核实任务

读取本次对话和相关项目文件；在 Git 仓库中根据需要检查分支、状态、差异和提交。分别列出已完成、已验证、未完成和未验证内容，不以静态检查替代实际运行结果。

候选分流

按 分流规则 为每个候选确定唯一主要去向。先展示内容摘要、证据、适用范围、目标路径和复用价值，并明确标记“尚未写入”。

用户可以逐项确认、调整或拒绝。只写入已确认内容；已有文件必须先完整读取并保守合并，不建立同义平行记录。

写入要求

• 结论与证据分开，推断必须标明，未验证内容不进入长期知识。
• 使用项目相对路径，不记录凭据、个人信息和无必要的内部地址。
• 指向源码或文档位置，不复制大段源码、日志或对话。
• 新证据与既有结论冲突时暂停，交由 lessons 的维护规则处理，不能静默覆盖。
• 写入前检索已有权威知识，优先修订原文。实质修改后按项目文档维护规范更新审核状态；替代旧内容时同步索引和 replacedBy。
• 完成后报告实际写入、未采纳和未写入内容；Git 提交需要独立授权。

当提炼由任务关闭流程触发时，读取对应 task.json，只处理标记为 distill 的文件。目标知识写入并校验后，将来源交回关闭流程重新分类；提炼失败或证据不足时改为 defer，不得直接把来源标记为删除。

distill 不生成接续提示词、不维护当前任务交接文件；需要继续任务时使用 handoff。