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

会话总结 v11.0

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

模式与边界

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

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

证据等级

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

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

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

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

信息优先级

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

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

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

小葱技能站7w4.net发现了升级插件。

输出版式

首屏固定为三行以内：

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

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

## 状态
- 已完成：{最多 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，由该文件作为建议类型、触发条件、排序和验收格式的唯一规则源。

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

证据与 UNKNOWN 的最小结构

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

保存与恢复

保存时先读取 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 和模型分档规则仅作历史数据；本版本不自动读取、更新或清理。
• 其他平台缺少工作区或工具可见性时，退化为基于当前对话的只读输出，并明确限制。

这是一个设计成熟、质量可靠的会话总结工具。它把"快速看状态""精简上下文"和"跨任务交接"区分得很清楚，输出内容有证据支撑、建议有明确依据。默认只读、不乱写文件，安全性好。脚本实现了敏感信息检测和原子保存，测试覆盖也比较完整。不足之处是历史会话数据的清理不够完善，可能残留敏感内容；安装脚本需要联网执行，存在一定安全风险。总体来说功能实用、文档清晰，是值得信赖的技能。