前言¶
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
