proof-of-work

在声明工作完成前强制要求验证与证据

安装使用

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

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

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

使用示例

‘我要提交这个新功能的代码了,帮我过一下proof-of-work检查。’ 它会引导你列出验证过的功能点、关联的测试用例执行结果,并可能要求你附上关键逻辑的代码审查截图或测试通过的报告链接,确保所有必要检查都已完成后,才生成最终的提交说明或PR描述。

介绍

这个Skill旨在解决开发与协作流程中,因缺乏充分验证而导致的代码质量、交付物不达标或返工问题。它通过设定一个强制性的检查点,要求用户在宣称任务完成、创建拉取请求或提交交付物评审前,必须提供明确的验证步骤和证据,从而确保工作的完整性和可靠性。

使用方式非常直接:在AI Agent的工作流中,当用户试图宣告某个开发或任务阶段结束时,Skill会被触发。它会引导用户回答一系列结构化问题,例如“你验证了哪些功能?”、“测试覆盖率是多少?”、“是否有相关的日志或截图作为证据?”,只有用户提供了令人满意的答案后,Skill才会“放行”,允许进入下一阶段。

它非常适合对代码质量和交付流程有严格要求的开发团队、项目经理以及独立开发者。任何需要在正式提交前进行自我检查或团队间交接的场景都能从中受益,尤其有助于培养严谨的工作习惯。

建议将此Skill集成到团队的标准工作流中,作为代码提交或任务完成的必经关卡。需要注意的是,它本身不执行具体的测试或审查,而是督促执行这些动作并留存证据。因此,团队仍需配备相应的测试和审查工具。过度依赖可能导致流程僵化,应结合实际情况灵活调整触发阈值。

核心特点

与一般代码审查或测试工具不同,它不直接分析代码或运行测试,而是专注于流程管控,强制要求在“宣称完成”这个关键节点进行证据留存和验证确认,从行为层面确保质量门禁被执行。

注意事项

不适合用于快速原型探索或创意构思等对流程和证据要求不高的初期自由创作阶段。

常见问题

这个Skill能自动运行测试吗?

不能,它只强制要求你提供已运行测试的证据,测试本身需要你或你的CI/CD工具来执行。

它支持哪些类型的证据?

支持文本描述、代码片段、测试报告链接、截图、日志文件路径等多种形式的证据,关键在于能证明验证工作已完成。

给 AI 助手的安装指引

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

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