READMESource: master@36acead2
Session Summarize 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/descriptionfrontmatter,与 dsh 技能契约一致。 - 插件外壳无 npm 依赖,可从 GitHub 直装。
License
MIT
No comments yet. Be the first to write one.