前言¶

DSH 通过插件扩展能力。在智能体开发中，长会话经常需要快速确认状态、压缩上下文，或把当前任务移交给下一个会话。gtbwpkwjnb-alt/summarize-skill 是面向编码 Agent 的任务总结技能，用于高密度总结、精简上下文与跨任务交接。下面介绍它的定位、安装和典型用法。

这是什么¶

gtbwpkwjnb-alt/summarize-skill 由 gtbwpkwjnb-alt 维护，许可证为 MIT。它的定位是：面向编码 Agent 的任务总结技能。

它把常见任务状态整理成三类输出：

• 快速看状态；
• 精简当前上下文；
• 跨任务交接。

输出采用高密度排版，按 P0、P1、P2 分类问题，并在末尾给出基于本次证据的建议。

核心功能¶

默认只读¶

普通总结默认只读，不创建文件、不修改规则、不写跨会话账本。只有显式保存时，才会产生文件写入。

支持多种总结用法¶

插件支持以下用法：

• 总结
• 总结进度
• 复盘
• 精简
• 压缩上下文
• 交接
• 交接分层
• checkpoint
• 诊断
• 诊断历史
• 保存
• 恢复

事实分层¶

输出中使用以下层级区分事实可信程度：

observed
confirmed
inferred
estimated
unavailable

这层表达用于避免把推测写成已验证结论。

显式保存¶

总结 保存 会写入当前项目的 .transfers/latest.md，并进行回读验证。

诊断保持克制¶

总结 诊断 只报告当前可见证据支持的风险观察，不进行自动判罚，也不进行自动修复。

DSH 插件形态¶

安装为 DSH 插件后，技能会出现在 Settings → Plugins，并支持按需懒加载。插件外壳是只读 skill provider，无工具、无凭据、无网络请求。

安装与启用¶

先通过 DSH 插件命令安装仓库：

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

安装后需要重启 dsh web。重启后，技能会出现在 Settings → Plugins，可按需懒加载。

该插件外壳无 npm 依赖，可从 GitHub 直装。已给出的测试兼容版本为：

dsh v0.1.1-rc.2（2026-08-22）

预览期版本迭代较快，若 API 变更，以官方文档为准。

典型用法¶

以下触发词可按场景使用。

看状态¶

总结
总结进度
复盘

用于生成简短事实型进度报告，并在末尾给出行动建议。

精简当前上下文¶

总结 精简
压缩上下文
compact

用于保留当前会话继续执行所需的最小上下文。

跨任务交接¶

总结 交接
handoff

用于生成可粘贴到新任务的完整交接报告。

大型任务分层交接¶

总结 交接 分层

用于大型任务，输出会拆分为：

snapshot
decisions
validation
risks
backlog

检查点¶

总结 checkpoint

用于生成未保存的精简检查点。

诊断¶

总结 诊断

用于在交接报告之外，加入证据化的流程风险观察。

历史诊断¶

总结 诊断 历史 <文件/目录>

用于比较用户指定的历史信号与当前证据。

保存与恢复¶

总结 保存
总结 恢复

总结 保存 会显式保存交接报告到当前项目。
总结 恢复 会读取上次显式保存的报告。恢复前需要比对项目、分支和 HEAD。

安装后可以使用：

$session-summarize

也可以使用中文触发词，或兼容入口：

summarize

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

适用场景与注意¶

适合以下编码 Agent 工作流：

• 长会话中快速确认当前状态；
• 上下文变长后压缩当前会话；
• 把当前任务交接给新会话；
• 大型任务中拆分状态、决策、验证、风险和待办；
• 基于当前证据做风险观察，而不是直接修改系统状态。

注意：

• 它随当前 dsh 进程权限运行，安装前建议检查源码与许可证。
• 普通总结默认只读。
• 只有 总结 保存 会写入当前项目的 .transfers/latest.md。
• 总结 诊断 不进行自动判罚或修复。
• summarize 仅作为兼容触发词保留。

链接¶

GitHub：

https://github.com/gtbwpkwjnb-alt/summarize-skill