DeepSeek Harness 最佳實踐

把產品事實與團隊策略分開

先閱讀小範圍內容，再執行操作

1. 01

   先讀專案指令

   定位倉庫級與巢狀指令檔案，並確認哪些規則適用於目標路徑。

2. 02

   只檢查相關表面

   先閱讀目標檔案、測試、配置和現有本地改動，必要時再擴大搜尋。

3. 03

   說明改動與證明方式

   列出範圍內檔案、預期可觀察結果、驗證命令和回滾點。

4. 04

   按可回滾增量工作

   每次只完成一個連貫改動，檢查 diff 後再跨到下一個邊界。

使用足夠完成任務的最小權限

讓憑據遠離提示與倉庫

• 只傳入目前操作必需的最小憑據，優先使用有範圍的 Provider 或短期 token。
• 不要把秘密貼上到聊天、專案指令、日誌、截圖、fixture 或已提交的環境檔案。
• 分享 diff 或製品前，掃描已跟蹤與未跟蹤改動中的秘密和敏感本地路徑。
• 如果可能已經洩露，先撤銷或輪換；刪除檔案不能讓已複製的憑據失效。

讓每項改動都可以回滾

1. 01

   記錄基線

   記錄目前 revision、配置、測試以及操作可能改變的外部狀態。

2. 02

   優先非破壞性操作

   使用有範圍的 upsert、增量 migration、可恢復檔案移動與精確目標，避免寬泛刪除或 reset。

3. 03

   檢查完整 diff

   區分預期編輯與使用者已有工作，並確認生成檔案和它的來源一致。

4. 04

   在重要路徑測試恢復

   對於包、migration 或部署，應在釋出前演練解除安裝、反向 migration、版本回滾或快照恢復。

驗證真實行為，不依賴完成宣告

1. 執行能證明已編輯行為的最小測試。
2. 根據風險執行類型、格式、建置和更廣的迴歸檢查。
3. 在生產建置與實際涉及的瀏覽器、執行時、資料庫或包路徑中操作。
4. 檢查 console、network、日誌、資料庫結果與輸出製品，而不是隻看退出碼。
5. 如實記錄失敗；只有理解原始原因後，重試才構成有效證據。

把 Skill 與外掛當作供應鏈輸入

Skill 是可複用的指令包，外掛則可以增加可執行能力。使用前應檢查來源與所需能力，儘量固定不可變版本，核實許可與校驗和，在隔離環境中測試，記錄維護責任，並定義更新和移除路徑。不能只因名稱相同就對後續版本永久信任。

從邊界向內系統診斷

1. 用最小輸入和乾淨或一次性工作區復現。
2. 確認活動 Profile、外掛版本、Provider 配置、工作區根目錄、權限預設以及報告的沙箱 enforcement。
3. 把模型輸出問題與工具、shell、網路、憑據、UI 或持久化故障分開。
4. 檢查結構化事件與日誌，再與已知正常基線比較。
5. 每次只改變一個變數，重複同一個證明，並在確定原因前保留失敗證據。