Summarize

SKILL.md

---
name: summarize
description: 在 Codex 中总结、精简或交接当前任务，提取目标、状态、决策、验证、风险和下一步，并基于本次证据给出操作、优化与行为建议。用户说“总结”“总结一下”“总结进度”“复盘”“总结精简”“压缩上下文”“交接”“handoff”“compact”“总结 checkpoint”“总结 交接 分层”“总结 诊断 历史”或“summarize”时使用。默认只读；仅在用户明确说“总结 保存”时写入当前工作区。
license: MIT
---

# 会话总结 v11.0

把当前可见上下文压缩成可信、可扫描、可继续执行的状态。先保真，再精炼；建议必须改变行动或明确说明当前没有成立的建议。

## 模式与边界

区分三个核心目的，不要用同一份长模板处理所有请求：

| 用户表达 | 模式 | 目的 |
|---|---|---|
| `总结`、`总结一下`、`总结进度`、`复盘`、`summarize` | 标准 | 让用户快速掌握状态、风险和下一步 |
| `总结 精简`、`压缩上下文`、`compact` | 精简 | 保留当前会话继续执行所需的最小上下文 |
| `总结 交接`、`handoff` | 交接 | 让新任务或新 Agent 无需原对话即可安全接手 |
| `总结 交接 分层` | 分层交接 | 在大型任务中拆分 snapshot、decisions、validation、risks、backlog |
| `总结 checkpoint` | 检查点 | 输出未保存的精简检查点，并明确提醒尚未持久化 |
| `总结 诊断` | 诊断 | 在标准输出上增加有证据的执行风险分析 |
| `总结 诊断 历史 <文件/目录>` | 历史诊断 | 只读比较用户指定的历史信号与当前证据 |
| `总结 保存`、`summarize save` | 保存 | 生成交接报告并显式保存到当前项目 |
| `总结 恢复` | 恢复 | 只读展示上次显式保存的交接报告 |

- 默认只读。不要自动创建文件、写记忆、更新计数器、归档错误或修改规则。
- 不要自行触发本技能，不要根据轮次或工具次数宣称自动压缩或自动保存。
- 不要创建或更新 Codex goal；只有用户明确要求时才使用 goal 写操作。
- 用户同时指定多个模式时，优先级为：`恢复` > `保存` > `交接` > `诊断` > `checkpoint/精简` > `标准`；`分层`是交接的输出修饰词。`保存`使用交接内容；`诊断 保存`先诊断再保存。

## 证据等级

只从当前可见会话、工具结果、已读取文件和用户明确输入中提取事实：

- **已核验**：文件、命令、测试或外部状态有对应工具输出。注明最短证据锚点。
- **用户确认**：只证明用户的目标、约束、决定或授权；不能证明代码、测试或外部事实。
- **未核验**：缺少独立证据的 Agent 陈述、推测或历史信息。使用 `UNKNOWN` 或“未核验”。

需要核验工作区时优先使用只读检查，如 `git status --short`、`git diff --stat`、文件读取和已有测试输出。命令失败、仓库不存在或信息不可见时保留 `UNKNOWN`，不要补猜。

状态仅使用：`未开始`、`进行中`、`受阻`、`待决策`、`已实现未验证`、`已验证`。只有相关验证实际通过时才能使用 `已验证`。

## 信息优先级

按以下顺序保留内容；空间不足时从后往前删减：

1. 状态与唯一最高优先级动作；
2. 阻塞、待决策和未完成事项；
3. 验证结果与 `UNKNOWN`；
4. 决策、原因和已排除路径；
5. 文件、分支和恢复上下文；
6. 不影响后续行动的背景。

不要复述完整对话、长日志、工具调用流水或已被新决定替代的信息。

## 输出版式

首屏固定为三行以内：

```markdown
# {任务名} — {状态}
{一句话结论：完成了什么、剩下什么或为何受阻}
**当前应做：** {唯一最高优先级动作；待决策时写清问题}
**附加状态：** {仅有其他风险时显示：阻塞 N 项 · UNKNOWN N 项 · 未验证 N 项}
```

正文采用渐进披露；空区段隐藏：

```markdown
## 状态
- 已完成：{最多 3 项}
- 未完成：{最多 3 项}
- 验证：{命令/测试及结果，或 UNKNOWN}

## 决策与风险
- 决策：{选择}；原因：{明确依据}；被否：{已排除方案及原因}
- 阻塞：{解除条件}
- 风险：{触发条件与影响}

## 下一步
1. {执行方 + 具体动作 + 验收条件}

## 保存回执
{仅保存成功时：实际绝对路径 + 回读/校验结果}

## 建议
{按 references/recommendations.md 生成；始终是最后一个区段}
```

版式约束：

- 标准模式最多 6 个正文要点、3 个下一步、2 条建议。
- 精简模式必须保留：目标、当前状态、未完成项/阻塞、验证结果、UNKNOWN、唯一下一步；最多 4 个补充要点和 1 条建议。超过预算时只删除背景、重复过程和不影响行动的已排除路径。
- 交接模式以重启安全为准，目标约 600 English words 或 900 个中文字符；遗漏关键信息比超出软上限更严重。
- 同类数据达到 3 行且需要横向比较时才使用表格；其他情况使用短列表。
- 不使用装饰图标、进度条、虚构状态徽章、“第 N 节”标签或空标题。
- `下一步`描述要做什么；`建议`解释为什么调整、如何防复发或应改变什么。禁止重复同一句。
- 首屏只设一个主动作，但有其他阻塞、UNKNOWN 或未验证项时必须显示计数，避免把并行风险隐藏掉。

## 交接模式

交接内容固定覆盖以下字段，并把它们完整写入“继续任务提示”，不能只依赖前文：

1. 目标、范围内/范围外和验收条件；
2. 当前状态及证据等级；
3. 已完成、未完成和 `UNKNOWN`；
4. 关键决策、原因和已排除路径；
5. 阻塞、风险、待用户决定事项；
6. 已核验的工作区、分支、相关文件和需重载上下文；
7. 下一步执行方、具体动作和验收命令/条件。

输出 `## 继续任务提示`，写成可直接粘贴的新任务指令。要求接手者先只读核对 `UNKNOWN` 和工作区状态，再报告判断并继续；不要假定交接文件中的状态仍然新鲜。

## 建议与诊断

每次输出最后都保留 `## 建议`。读取 [references/recommendations.md](references/recommendations.md)，由该文件作为建议类型、触发条件、排序和验收格式的唯一规则源。

- 有成立信号时，输出能改变下一步决策的具体建议。
- 没有成立信号时，明确写“暂无基于当前证据的优化或行为建议”，不要制造通用建议。
- 标准/精简模式最多 2/1 条，交接模式最多 3 条，诊断模式最多 4 条。
- 诊断只报告当前可见证据支持的风险，不自动判罚、累计次数、修复或写入规则。
- `总结 诊断 历史 <文件/目录>` 才允许读取用户明确指定的历史资料；读取 [references/history-diagnostics.md](references/history-diagnostics.md)，把历史内容标为“历史信号”，不得直接当作当前复发。
- `总结 交接 分层` 只在用户明确要求或单文件交接难以维护时使用，读取 [references/layered-handoff.md](references/layered-handoff.md)；默认只输出，不自动创建多个文件。
- `总结 checkpoint` 只输出检查点，不写 `.transfers/`、记忆或规则；末尾明确“尚未保存”，如需持久化必须由用户再次明确说 `总结 保存`。

### 证据与 UNKNOWN 的最小结构

- 已核验项尽量写成：`证据等级：已核验；来源：文件/命令/测试；结果：实际结果；影响：对任务的影响`。
- `UNKNOWN` 必须说明：`原因、影响、验证动作、责任方、解除条件`；原因不明时保留 `原因未知`，不得补猜。
- 建议必须绑定至少一个可执行对象：失败命令、文件路径、测试命令、配置项或待用户提供的信息。无法绑定时写“当前证据不足，先定位，不提出具体修复”。

## 保存与恢复

保存时先读取 [references/operations.md](references/operations.md)。只有用户明确选择保存时：

1. 检查当前项目的工作区规则和可写位置。
2. 生成带 `summarize-handoff` 元数据的交接报告；不要保存原始对话、私密信息、未核验推测或工具密钥。
3. 使用 `scripts/save_handoff.py` 校验敏感信息、加锁、备份并原子替换任务报告和 `{项目根目录}/.transfers/latest.md` 指针；不能确定项目根目录时停止，不要写入技能目录或用户主目录。
4. 写入后读取文件并执行只读校验；只在回测成功时报告实际绝对路径。

恢复时先读指针和任务报告，再用 `scripts/inspect_handoff.py` 比对项目根目录、分支和 HEAD；不匹配时标为“过期参考”，不得直接继续执行。文件不存在时报告“未找到已保存的交接报告”，不要创建空文件。

## 兼容与迁移

- 在 Codex 中遵守当前工作区 `AGENTS.md`、工具权限和会话可见性边界；它们优先于本技能。
- 旧版 `harvests/`、`_counters.md`、`error-ledger.md` 和模型分档规则仅作历史数据；本版本不自动读取、更新或清理。
- 其他平台缺少工作区或工具可见性时，退化为基于当前对话的只读输出，并明确限制。