---
name: trace
description: 基于对话、项目文件和命令证据复盘 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 提交分别遵循各自授权边界。