name: summarize description: 在 Codex 中總結、精簡或交接當前任務，提取目標、狀態、決策、驗證、風險和下一步，並基於本次證據給出操作、最佳化與行為建議。使用者說“總結”“總結一下”“總結進度”“復盤”“總結精簡”“壓縮上下文”“交接”“handoff”“compact”“總結 checkpoint”“總結 交接 分層”“總結 診斷 歷史”或“summarize”時使用。預設只讀；僅在使用者明確說“總結 儲存”時寫入當前工作區。 license: MIT

會話總結 v11.0

把當前可見上下文壓縮成可信、可掃描、可繼續執行的狀態。先保真，再精煉；建議必須改變行動或明確說明當前沒有成立的建議。

模式與邊界

區分三個核心目的，不要用同一份長模板處理所有請求：

• 預設只讀。不要自動建立檔案、寫記憶、更新計數器、歸檔錯誤或修改規則。
• 不要自行觸發本技能，不要根據輪次或工具次數宣稱自動壓縮或自動儲存。
• 不要建立或更新 Codex goal；只有使用者明確要求時才使用 goal 寫操作。
• 使用者同時指定多個模式時，優先順序為：恢復 > 儲存 > 交接 > 診斷 > checkpoint/精簡 > 標準；分層是交接的輸出修飾詞。儲存使用交接內容；診斷 儲存先診斷再儲存。

證據等級

只從當前可見會話、工具結果、已讀取檔案和使用者明確輸入中提取事實：

• 已核驗：檔案、命令、測試或外部狀態有對應工具輸出。註明最短證據錨點。
• 使用者確認：只證明使用者的目標、約束、決定或授權；不能證明程式碼、測試或外部事實。
• 未核驗：缺少獨立證據的 Agent 陳述、推測或歷史資訊。使用 UNKNOWN 或“未核驗”。

需要核驗工作區時優先使用只讀檢查，如 git status --short、git diff --stat、檔案讀取和已有測試輸出。命令失敗、倉庫不存在或資訊不可見時保留 UNKNOWN，不要補猜。

狀態僅使用：未開始、進行中、受阻、待決策、已實現未驗證、已驗證。只有相關驗證實際通過時才能使用 已驗證。

資訊優先順序

按以下順序保留內容；空間不足時從後往前刪減：

1. 狀態與唯一最高優先順序動作；
2. 阻塞、待決策和未完成事項；
3. 驗證結果與 UNKNOWN；
4. 決策、原因和已排除路徑；
5. 檔案、分支和恢復上下文；
6. 不影響後續行動的背景。

不要複述完整對話、長日誌、工具呼叫流水或已被新決定替代的資訊。

輸出版式

首屏固定為三行以內：

# {任務名} — {狀態}
{一句話結論：完成了什麼、剩下什麼或為何受阻}
**當前應做：** {唯一最高優先順序動作；待決策時寫清問題}
**附加狀態：** {僅有其他風險時顯示：阻塞 N 項 · UNKNOWN N 項 · 未驗證 N 項}

正文采用漸進披露；空區段隱藏：

## 狀態
- 已完成：{最多 3 項}
- 未完成：{最多 3 項}
- 驗證：{命令/測試及結果，或 UNKNOWN}

## 決策與風險
- 決策：{選擇}；原因：{明確依據}；被否：{已排除方案及原因}
- 阻塞：{解除條件}
- 風險：{觸發條件與影響}

## 下一步
1. {執行方 + 具體動作 + 驗收條件}

## 儲存回執
{僅儲存成功時：實際絕對路徑 + 回讀/校驗結果}

## 建議
{按 references/recommendations.md 生成；始終是最後一個區段}

版式約束：

• 標準模式最多 6 個正文要點、3 個下一步、2 條建議。
• 精簡模式必須保留：目標、當前狀態、未完成項/阻塞、驗證結果、UNKNOWN、唯一下一步；最多 4 個補充要點和 1 條建議。超過預算時只刪除背景、重複過程和不影響行動的已排除路徑。
• 交接模式以重啟安全為準，目標約 600 English words 或 900 箇中文字元；遺漏關鍵資訊比超出軟上限更嚴重。
• 同類資料達到 3 行且需要橫向比較時才使用表格；其他情況使用短列表。
• 不使用裝飾圖示、進度條、虛構狀態徽章、“第 N 節”標籤或空標題。
• 下一步描述要做什麼；建議解釋為什麼調整、如何防復發或應改變什麼。禁止重複同一句。
• 首屏只設一個主動作，但有其他阻塞、UNKNOWN 或未驗證項時必須顯示計數，避免把並行風險隱藏掉。

交接模式

交接內容固定覆蓋以下欄位，並把它們完整寫入“繼續任務提示”，不能只依賴前文：

1. 目標、範圍內/範圍外和驗收條件；
2. 當前狀態及證據等級；
3. 已完成、未完成和 UNKNOWN；

   來源於7w4.net。

4. 關鍵決策、原因和已排除路徑；
5. 阻塞、風險、待使用者決定事項；
6. 已核驗的工作區、分支、相關檔案和需過載上下文；
7. 下一步執行方、具體動作和驗收命令/條件。

輸出 ## 繼續任務提示，寫成可直接貼上的新任務指令。要求接手者先只讀核對 UNKNOWN 和工作區狀態，再報告判斷並繼續；不要假定交接檔案中的狀態仍然新鮮。

建議與診斷

每次輸出最後都保留 ## 建議。讀取 references/recommendations.md，由該檔案作為建議型別、觸發條件、排序和驗收格式的唯一規則源。

• 有成立訊號時，輸出能改變下一步決策的具體建議。
• 沒有成立訊號時，明確寫“暫無基於當前證據的最佳化或行為建議”，不要製造通用建議。
• 標準/精簡模式最多 2/1 條，交接模式最多 3 條，診斷模式最多 4 條。
• 診斷只報告當前可見證據支援的風險，不自動判罰、累計次數、修復或寫入規則。
• 總結 診斷 歷史 <檔案/目錄> 才允許讀取使用者明確指定的歷史資料；讀取 references/history-diagnostics.md，把歷史內容標為“歷史訊號”，不得直接當作當前復發。
• 總結 交接 分層 只在使用者明確要求或單檔案交接難以維護時使用，讀取 references/layered-handoff.md；預設只輸出，不自動建立多個檔案。
• 總結 checkpoint 只輸出檢查點，不寫 .transfers/、記憶或規則；末尾明確“尚未儲存”，如需持久化必須由使用者再次明確說 總結 儲存。

證據與 UNKNOWN 的最小結構

• 已核驗項儘量寫成：證據等級：已核驗；來源：檔案/命令/測試；結果：實際結果；影響：對任務的影響。
• UNKNOWN 必須說明：原因、影響、驗證動作、責任方、解除條件；原因不明時保留 原因未知，不得補猜。
• 建議必須繫結至少一個可執行物件：失敗命令、檔案路徑、測試命令、配置項或待使用者提供的資訊。無法繫結時寫“當前證據不足，先定位，不提出具體修復”。

儲存與恢復

儲存時先讀取 references/operations.md。只有使用者明確選擇儲存時：

1. 檢查當前專案的工作區規則和可寫位置。
2. 生成帶 summarize-handoff 後設資料的交接報告；不要儲存原始對話、私密資訊、未核驗推測或工具金鑰。
3. 使用 scripts/save_handoff.py 校驗敏感資訊、加鎖、備份並原子替換任務報告和 {專案根目錄}/.transfers/latest.md 指標；不能確定專案根目錄時停止，不要寫入技能目錄或使用者主目錄。
4. 寫入後讀取檔案並執行只讀校驗；只在回測成功時報告實際絕對路徑。

恢復時先讀指標和任務報告，再用 scripts/inspect_handoff.py 比對專案根目錄、分支和 HEAD；不匹配時標為“過期參考”，不得直接繼續執行。檔案不存在時報告“未找到已儲存的交接報告”，不要建立空檔案。

相容與遷移

• 在 Codex 中遵守當前工作區 AGENTS.md、工具許可權和會話可見性邊界；它們優先於本技能。
• 舊版 harvests/、_counters.md、error-ledger.md 和模型分檔規則僅作歷史資料；本版本不自動讀取、更新或清理。
• 其他平臺缺少工作區或工具可見性時，退化為基於當前對話的只讀輸出，並明確限制。

這是一個設計成熟、質量可靠的會話總結工具。它把"快速看狀態""精簡上下文"和"跨任務交接"區分得很清楚，輸出內容有證據支撐、建議有明確依據。預設只讀、不亂寫檔案，安全性好。指令碼實現了敏感資訊檢測和原子儲存，測試覆蓋也比較完整。不足之處是歷史會話資料的清理不夠完善，可能殘留敏感內容；安裝指令碼需要聯網執行，存在一定安全風險。總體來說功能實用、文件清晰，是值得信賴的技能。