output-contract · diff
git:20260824.a77ebbb to git:20260914.4f9978a
12 added, 27 removed. Audit A to A.
---
name: output-contract
- description: 任務完成前需要一致交付格式、修改清單、測試結果、待確認事項、或使用者明確要求「完成後列出」時使用。適用於程式碼、設定、文件、skills、同步與多步驟任務收尾；本 Skill 不取代內容 readiness 或風險檢查。
+ description: 任務完成前需要一致交付格式、修改清單、驗證結果、風險或待確認事項時使用；適用於程式碼、設定、文件、Skills、同步與多步驟任務收尾，不取代內容或安全檢查。
---
# 交付契約
- ## 使用時機
-
- 在任務完成前啟用，檢查是否已交代使用者需要知道的結果、風險與下一步。
-
- > [!TIP]
- > **Minimal 免檢疫例外**：若任務判定為 `Minimal` 車道 (極簡快車道)，**強制豁免**產出以下完整的標準收尾區塊。改以一句話精簡總結完成狀態與耗時即可，以達到最高執行效率。
+ 收尾時用最少必要資訊讓使用者知道成果是否完成、改了什麼、如何驗證，以及還有哪些限制。
- ## 標準收尾
+ ## 必要欄位
```text
- 任務追蹤 (Telemetry)
- - 工作流路徑 (Routing Path): [例如 Minimal, Standard, Full Orchestrator]
- - 各路徑耗時 (Time Spent): [列出各節點/子代理解決問題的耗時]
- - 載入的 Skill (Skills Loaded): [列出過程中啟用的 Skill 名稱]
-
完成狀態
- ...
修改清單
- - ...
+ - ...（無修改則寫「無」）
- 測試與檢查
- - ...
+ 驗證
+ - 指令／方式：結果
待確認事項
- - ...
+ - ...（無則寫「無」）
```
- ## 規則
-
- - 有修改檔案時列出所有檔案；沒有修改寫「無」。
- - 有測試或檢查時列出指令/方式與結果；未執行需說明原因。
- - 有失敗、跳過、未確認、需人工判斷的事項，明確列出。
- - 不把大量檔案內容貼到回覆中；只列路徑、摘要與結果。
- - **所有本機路徑與遠端連結，都必須使用可點擊的 Markdown 格式** (例如：`[檔名](file:///C:/絕對路徑)`)，方便使用者直接點選開啟。
- - 本 Skill 負責整理交付回報，不負責判斷成果是否通過內容或風險檢查；需要時另行啟用 `checklist-validator`。
- - 若完成同步、commit、push，列出實際成功的動作。
+ - 未執行、失敗、跳過或需人工判斷的項目要明確標示，不把建議寫成已完成。
+ - 不貼大量檔案內容；列出實際路徑與必要連結即可。
## 高風險附加欄位
- 涉及設定、同步、刪除、遠端、憑證、資料搬移時，加上：
+ 涉及設定、同步、刪除、遠端、憑證或資料搬移時，加上：
```text
風險與保護
- ...
```
+
+ 若完成同步、commit 或 push，只回報實際成功的動作；不得暗示未執行的外部變更。