summarize-skill

Readme

# 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 插件系统安装：

```bash
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