前言¶
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