mcpField
P
principle-sequence-verifiable-units

principle-sequence-verifiable-units

github.com/poteto开发13388 次安装21 周前更新
代码仓库

关于 principle-sequence-verifiable-units

一项指导开发者将工作拆分为可验证小单元的原则技能,适用于批量修改与代码交付。它强调逐项检查,并按能展示问题及解决过程的顺序组织提交。

主要功能

  1. 01每次只处理一个小单元
  2. 02每项修改后立即验证
  3. 03按证明顺序组织提交
  4. 04提交序列呈现问题与修复

适用场景

  1. 01执行迁移或批量编辑
  2. 02安排可独立审查的提交
  3. 03让审查者重现红到绿的验证过程

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/poteto/plugins --skill principle-sequence-verifiable-units

安装后在 Claude Code 中输入/principle-sequence-verifiable-units确认已加载。

详细介绍

将工作拆分为可验证的单元

按顺序将工作拆分为小单元,每个单元结束时都处于可检查的状态,并且在当前单元通过检查前不要继续。无论是执行工作还是交付成果,都应遵循同样的纪律。

原因: 在导致问题的单元中发现故障,定位成本很低。等一批工作完成后才发现故障,问题就会被掩盖,而且你已经在有问题的基础上继续构建。将这些单元按顺序组织成交付内容,让审核者可以重现整个过程,就能把“相信我”变成“看它先变红,再变绿”。

执行。 在全面检查、迁移或任何一系列类似修改中,每完成一项修改,都要先验证,再开始下一项。绝不要先批量修改,最后再统一验证。每个单元都要遵循“修改前后对照”的流程:确认当前状态良好,进行一项修改,运行检查,然后再继续。先将变更变基到干净的主干上,这样每次检查都是针对真实基线进行的。如果由某个工具来执行修改,那么逐单元检查几乎不费力;但仍要运行检查。

交付。 按照能够证明工作有效的顺序组织提交和 PR。标准顺序是先提交失败的测试,再在其上提交修复。第一个单元表明问题确实存在(红),下一个单元表明问题已解决(绿),这样审核者就能同时看到问题和证明。其他顺序包括:先删除,再重塑;先捕获基线,再实施处理;先搭建脚手架,再实现功能。每个提交都应独立成立,整个顺序读起来就像一份论证。

模式:

  • 选择以检查结束的最小单元:一次修改及其测试,或一个可独立成立的提交。
  • 每次继续前都要验证。每个单元都从红变绿,绝不拖到最后统一检查。
  • 安排单元顺序,让整个序列本身就能建立信心:无论是你在执行时,还是审核者阅读提交序列时。

这是对 prove-it-works 原则技能的顺序安排补充;该技能确保每次检查都切实有效,而 build-the-lever 原则技能则让逐单元检查成本更低。

评论

支持 Markdown