32 lines
2.1 KiB
Markdown
32 lines
2.1 KiB
Markdown
---
|
|
name: distill
|
|
description: 从当前任务和项目证据中提炼可复用结论、决策与问题经验，并在用户确认后分流到 .craftkit 知识结构。适用于阶段性知识沉淀；任务交接、Agent 失效复盘、工作日志或未经确认写入知识库不应触发本 Skill。
|
|
---
|
|
|
|
# 提炼任务知识
|
|
|
|
只沉淀有证据、适用范围明确且未来可复用的内容。大多数任务没有值得长期记录的知识是正常结果。
|
|
|
|
## 核实任务
|
|
|
|
读取本次对话和相关项目文件；在 Git 仓库中根据需要检查分支、状态、差异和提交。分别列出已完成、已验证、未完成和未验证内容，不以静态检查替代实际运行结果。
|
|
|
|
## 候选分流
|
|
|
|
按 [分流规则](references/routing.md) 为每个候选确定唯一主要去向。先展示内容摘要、证据、适用范围、目标路径和复用价值，并明确标记“尚未写入”。
|
|
|
|
用户可以逐项确认、调整或拒绝。只写入已确认内容；已有文件必须先完整读取并保守合并，不建立同义平行记录。
|
|
|
|
## 写入要求
|
|
|
|
- 结论与证据分开，推断必须标明，未验证内容不进入长期知识。
|
|
- 使用项目相对路径，不记录凭据、个人信息和无必要的内部地址。
|
|
- 指向源码或文档位置，不复制大段源码、日志或对话。
|
|
- 新证据与既有结论冲突时暂停，交由 `lessons` 的维护规则处理，不能静默覆盖。
|
|
- 写入前检索已有权威知识，优先修订原文。实质修改后按项目文档维护规范更新审核状态；替代旧内容时同步索引和 `replacedBy`。
|
|
- 完成后报告实际写入、未采纳和未写入内容；Git 提交需要独立授权。
|
|
|
|
当提炼由任务关闭流程触发时，读取对应 `task.json`，只处理标记为 `distill` 的文件。目标知识写入并校验后，将来源交回关闭流程重新分类；提炼失败或证据不足时改为 `defer`，不得直接把来源标记为删除。
|
|
|
|
`distill` 不生成接续提示词、不维护当前任务交接文件；需要继续任务时使用 `handoff`。
|