gtbwpkwjnb-alt/summarize-skill

会话总结 v1.2 — 高密度总结、精简与交接

面向编码 Agent 的任务总结技能。它把“快速看状态”“精简当前上下文”“跨任务交接”分成不同输出，采用“先结论、后行动、再证据”的高密度排版，按 P0/P1/P2 分类问题，并在末尾给出基于本次证据的建议。

设计原则

- 默认只读：普通 总结 不创建文件、不修改规则、不写跨会话账本。
- 证据优先：区分已核验、会话陈述与未核验信息。
- 交接优先：输出下一步和可复制的继续任务提示，不复述整段对话。
- 行动闭环：建议以“类型 → 操作 → 依据 → 验收”表达；重复错误优先给出根因与防复发措施。
- 分型输出：标准总结用于扫描，精简模式用于继续当前会话且不可丢失关键状态，交接模式用于冷启动恢复。
- 高密度排版：首屏结论、证据覆盖和唯一主动作；正文按状态、问题、决策、下一步、建议渐进展开。
- 事实分层：使用 observed、confirmed、inferred、estimated、unavailable，不以推测替代验证。
- 持久化显式化：只有 总结 保存 才写入当前项目的 .transfers/latest.md，并回读验证。
- 任务隔离：报告按 task_id 保存到 .transfers/handoffs/，latest.md 仅作指针；恢复前比对项目、分支和 HEAD。
- 诊断可选：总结 诊断 只报告当前可见证据支持的风险观察，不进行自动判罚或修复。
- 历史诊断显式化：只有 总结 诊断 历史  才读取用户指定的历史信号，并与当前证据分开。
- 可选分层交接：总结 交接 分层 才拆分 snapshot、decisions、validation、risks、backlog；默认仍为单文件、只读。
- 检查点不持久化：总结 checkpoint 只生成未保存的精简状态。
- 证据可传递：已核验项带来源和结果，UNKNOWN 带原因、影响和解除条件，建议绑定具体对象。

使用

| 命令 | 结果 |
|---|---|
| 总结 / 总结进度 / 复盘 | 简短事实型进度报告，末尾给出行动建议 |
| 总结 精简 / 压缩上下文 / compact | 当前会话继续执行所需的最小上下文 |
| 总结 交接 / handoff | 可粘贴到新任务的完整交接报告 |
| 总结 交接 分层 | 大型任务的 snapshot、decisions、validation、risks、backlog |
| 总结 checkpoint | 未保存的精简检查点 |
| 总结 诊断 | 交接报告加证据化流程风险观察 |
| 总结 诊断 历史  | 比较用户指定的历史信号与当前证据 |
| 总结 保存 | 显式保存交接报告到当前项目 |
| 总结 恢复 | 读取上次显式保存的报告 |

技能标识为 session-summarize；summarize 仍保留为兼容触发词。旧版 harvests/ 中的数据不会自动读取或操作。

安装

将本目录放在宿主 Agent 可发现的 skills 路径（如 ~/.agents/skills/session-summarize、~/.codex/skills/session-summarize），或使用仓库内的安装脚本。安装后可使用 $session-summarize、中文触发词或兼容入口 summarize。

DeepSeek Harness 插件市场

本仓库同时是 DeepSeek Harness（dsh）技能包插件，可通过 dsh 插件系统安装：

dsh plugin --profile web add github:gtbwpkwjnb-alt/summarize-skill

安装后重启 dsh web，技能出现在 Settings → Plugins，按需懒加载（渐进式披露）。技能包由本仓库根目录的 SKILL.md 提供，cordis.patch.yml + index.js 为插件外壳（只读 skill provider，无工具、无凭据、无网络请求）。

- 测试兼容版本：dsh v0.1.1-rc.2（2026-08-22）。预览期版本迭代快，若 API 变更请以官方文档为准。
- 技能格式：kebab-case 名称 + name/description frontmatter，与 dsh 技能契约一致。
- 插件外壳无 npm 依赖，可从 GitHub 直装。

License

MIT