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

name, description

name	description
trace	基于对话、项目文件和命令证据复盘 Agent 在当前任务中的偏离、漏读或规则失效，并提出待确认的改进载体。适用于用户明确要求分析 Agent 为什么出错；普通代码缺陷分析、任务总结或自动修改规则不应触发本 Skill。

Agent 偏离复盘

分析失效机制，不追责，也不根据结果反向编造过程。默认只输出复盘和改进建议，任何文件修改都需要后续明确确认。

证据顺序

1. 还原用户目标、授权边界和任务发生时可见的信息。
2. 定位第一个实质偏离点，区分错误判断、错误操作和遗漏动作。
3. 检查当时适用的 AGENTS.md、Skill、.craftkit/standards/、知识条目、对话记录和命令输出。
4. 无法确认的内容标记为未知，不把当前检查到的资料假定为当时已被读取。

失效分类

• missing：所需规则或知识没有被记录。
• unread：规则存在，但任务中没有读取或 Skill 没有触发。
• mismatch：规则措辞或触发范围与真实场景不匹配。
• misapplied：证据已读取，但适用性或优先级判断错误。
• insufficient：当时证据不足，Agent 却没有停下来确认。
• incidental：单次偶发行为，没有证据支持增加永久规则。

输出

依次给出预期与边界、实际偏离、证据、失效分类、影响和改进候选。每项改进只指向一个主要载体：现有 Skill、AGENTS.md、项目规范、项目知识或新的 Skill 提案。

改进清单必须明确标记“尚未执行”。只有用户确认具体文件和内容后才能修改；规则修改、知识沉淀和 Git 提交分别遵循各自授权边界。