proof-of-work

在声明工作完成前,强制要求验证和提供证据。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:proof-of-work。
它的用途是:在声明工作完成前,强制要求验证和提供证据。
完整的 Skill 内容见:https://321skill.com/skills/proof-of-work/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

‘我要提交这个新功能的PR了,请帮我做一次Proof-of-Work检查。’ 它会引导你列出为证明功能完成所做的所有验证,例如:‘你运行了哪些单元测试和集成测试?覆盖率是多少?’、‘代码是否通过了静态分析和安全扫描?’、‘是否有相关的文档更新?’。你需要提供这些问题的答案和证据(如测试报告链接、扫描结果截图),AI会帮你整理成一份清晰的验证清单,附在PR描述中,确保评审者对你的工作质量有充分的了解。

介绍

Proof-of-Work Skill 旨在解决开发、交付和协作过程中因缺乏验证和证据而导致的返工、沟通成本高和质量风险问题。它通过设定一个强制性的检查点,要求用户在宣称任务完成(如提交代码、创建PR、交付成果物)之前,必须提供明确的验证步骤和完成证据。

使用时,用户可以在关键节点(如功能开发完毕、准备提交PR、交付成果物给评审前)调用此Skill。它会引导用户回顾并列出为证明“完成”所执行的具体验证操作(如运行了哪些测试、检查了哪些指标、通过了哪些审查),并要求附上相应的证据(如测试报告截图、代码覆盖率数据、审查通过记录)。

该Skill非常适合追求高质量交付和规范流程的开发者、测试工程师、项目经理以及任何需要向他人交付确定性成果的角色。它尤其适用于团队协作环境,有助于在交付物传递到下一环节前建立共同的质量认知。

建议将此Skill集成到团队的标准工作流中,例如作为PR模板的一部分或项目里程碑的检查清单。需要注意的是,它本身不执行具体的验证工作,而是管理和记录验证过程,因此用户仍需具备相应的测试或审查能力来生成有效证据。过度形式化可能增加初期的时间成本,需在流程严谨性和效率间取得平衡。

核心特点

与一般的代码质量或测试Skill不同,它不聚焦于具体的代码检查或测试执行,而是专注于建立“声明完成”前的强制性证据收集流程,确保“完成”状态有据可查,填补了从“做完”到“可交付”之间的流程管理空白。

注意事项

不适合用于快速原型开发或探索性编程等对流程和证据要求不高的场景。

常见问题

Proof-of-Work Skill 能自动运行测试吗?

不能。它主要负责引导和记录验证过程,具体的测试执行、代码审查等验证活动需要用户自行完成或借助其他工具。

这个Skill适合个人开发者使用吗?

适合。个人开发者可以用它来规范自己的工作习惯,确保在提交代码或交付项目前进行了充分的自我验证,提升工作质量。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/proof-of-work/raw/index.md 读取 proof-of-work 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。