deslop | 清理差異中的生成式冗餘
本頁以 pstack-claude 0.9.126 的移植版技能為準。deslop 不在本次核對的 Cursor 原版 pstack 技能目錄中，不應被說成原版 pstack 內建技能。移植版參考總覽將它歸於整合的 cursor-team-kit 技能。
定位與適用情境
deslop 清理分支相對 main 新引入、又不符合專案慣例的生成式冗餘。它不是重新設計整個程式，也不是把所有防禦檢查與註解一律刪掉。
例如新增的設定載入功能在已驗證的內部路徑重複檢查欄位，再用 as any 繞過型別，外面還包一層吞錯的 try/catch。輸入是分支差異、呼叫端與既有驗證邊界。輸出應是有證據的最小清理及行為保持檢查。
準備
- 確認
main是正確比較基準。若專案使用其他基底，明確指定，不悄悄改用任意分支。 - 閱讀檔案周邊風格、入口驗證與錯誤傳遞。不能只因重複就推定某個檢查無用。
- 準備能觀察成功與失敗路徑的既有測試或命令。
- 先列受保護內容。必須保留專案要求的準確繁體中文功能註解、有效文件、TODO、license 與被註解的舊程式。
操作步驟
- 界定新引入的冗餘。 對照
main，標出多餘註解、內部重複防禦、異常try/catch、僅為繞過型別的any轉型與過深巢狀。既存無關程式不順便整理。 - 查證用途。 追蹤欄位從哪裡進來、誰已驗證、錯誤原本該傳到哪裡。外部輸入邊界的必要檢查不能按「乾淨」偏好移除。
- 最小化修改。 僅清除已證實冗餘，必要時以提早返回簡化巢狀。保留失敗語意、清理副作用及受保護註解。發現真實錯誤時分開說明，不把行為修正藏在風格清理中。
- 驗證並簡短回報。 檢查最終差異與相關成功、失敗案例。用 1 至 3 句說明清理內容、保持行為的證據及未處理缺口。
可直接使用的提示詞
Claude Code 可用 /pstack:deslop，Codex 插件可選 $pstack:deslop。自然語言需求可這樣寫。
用 pstack:deslop 清理目前分支相對 main 的設定載入差異。
先讀呼叫端、輸入驗證與周邊風格，再判斷重複防禦及 as any 是否無用。
只改此次差異中已證實冗餘的部分，不廣泛重構。
保留行為、錯誤傳遞與資源清理。
保留專案要求的準確繁體中文功能註解、有效文件、TODO、license 與被註解的舊程式。
無法證明用途的註解或檢查先保留並回報，不按名稱猜測刪除。
跑既有的相關本機驗證，最後用 1 至 3 句回報證據與缺口。
不提交、不推送，不安裝新依賴。預期結果與驗收
- 差異只包含本次新引入冗餘的聚焦清理，不混入無關改名或整檔格式化。
- 移除內部檢查有前置驗證證據，移除吞錯邏輯也有失敗路徑的行為說明。
- 不再用
any隱藏型別問題，但也不改成另一個沒有驗證的轉型。 - 受保護內容完整保留。刪除行數不是品質指標，也不能當作通過依據。
- 若無法跑測試，簡短回報仍要說明未驗證範圍，不能直接宣稱行為不變。
限制與權限
原文允許修復明確錯誤，但不是所有清理任務都授權改行為。若使用者只要求行為不變，先提出另項修復，不自行擴大範圍。
deslop 是會修改程式的技能，不是唯讀審查。它不需要假設專用多代理工具存在，也不自動取得 commit 或 push 權限。「提交前清理」只描述時機，不是提交授權。
本頁採專案的內容保留規則。原文提到刪除多餘註解，不構成刪除準確功能註解、有效文件、TODO、license 或註解舊程式的授權。用途不明時保留並回報。