前言¶
DSH(DeepSeek Harness)插件開發中,交付物的準確性直接關係到信用。很多錯誤源於過度信任構建腳本,而不是直接打開文件驗證。delivery-checklist 插件解決了這個問題,它通過打開真實文件來檢查,而不是依賴腳本。
插件簡介¶
這是 ChenneyZhuang 維護的一個工作流插件,用於在交付前驗證文件。它不依賴腳本的輸出,而是打開實際文件進行物理檢查。核心價值在於用幾分鐘的檢查時間,避免幾天甚至更久的錯誤修復。
核心功能¶
- 打開真實文件驗證:檢查文件的行數和去重後的行數。
- 佔位符掃描:掃描 TODO、XXX、[X]、test、N/A 等殘留內容。
- 增量 Diff 對比:將增量文件與聲明的基準文件進行對比,驗證”全部新增”等聲明。
- 臺賬記錄:將批次記錄在臺賬中,並區分候選和可發送數量。
安裝與啓用¶
使用官方提供的命令克隆倉庫到 Claude 的技能目錄:
git clone https://github.com/ChenneyZhuang/delivery-checklist ~/.claude/skills/delivery-checklist
典型用法¶
場景:一個增量工作表聲稱”全部新增”。
- 打開兩個工作表,顯示 240 行和 5100 行。
- 在 name+location 鍵上執行去重,得到 239 行和 5046 行,發現同一工作表內存在 54 行重複。
- 與聲明的基準文件 diff,重疊 = 0,驗證了”全部新增”的聲明。
- 掃描佔位符,結果清潔。
關鍵區分¶
區分文件內的重複行與批次間的重複:
* 同一文件內的重複行:是缺陷,必須在發貨前修復。
* 同一實體出現在兩個批次:是漏斗常態,應在臺賬中記錄。
搞混這兩者,要麼把缺陷發出去,要麼把正常歷史刪掉。
侷限性說明¶
- 去重鍵是啓發式:去重鍵使用 name+location,同名同地的不同實體可能會被合併。在發貨前建議抽查合併項。
- 臺賬維護依賴:臺賬對賬功能假設臺賬存在且被維護。如果臺賬損壞,需要先重建。
結尾¶
這個插件通過物理打開文件和嚴格的對賬流程,幫助 DSH 開發者確保交付物的質量。它適用於所有 agent 能打開的表格文件(xlsx / csv)。安裝後需配合臺賬維護使用。
- 插件目錄:https://www.skillhub.cn/plugins/ChenneyZhuang/delivery-checklist
- GitHub 倉庫:https://github.com/ChenneyZhuang/delivery-checklist