proof-of-work

强制验证与证据后声明工作完成

安装使用

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

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

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

使用示例

'我要提交PR,请帮我执行proof-of-work验证。' AI会检查当前分支是否通过所有单元测试、代码风格是否符合ESLint规则、是否更新了README和CHANGELOG,并生成一份包含通过/失败项的验证报告。如果所有项目都通过,AI会提示可以安全提交;否则列出需要修复的问题。

介绍

开发过程中,经常出现“我觉得做完了”但实际未验证的情况,导致后续返工或代码质量问题。Proof-of-Work 技能强制要求:在声明任务完成、提交PR或交付成果前,必须提供明确的验证证据(如测试通过、代码审查记录、文档更新等),从流程上杜绝“虚假完成”。

使用方式简单:在完成开发后,对AI说“运行proof-of-work”或“提交PR前执行验证”,AI会自动检查当前工作是否符合预定义的质量门禁(如单元测试覆盖率、代码规范检查、依赖安全扫描、变更日志更新等),并生成一份验证报告。只有所有检查项通过,才允许进入下一步。

适合所有需要规范提交流程的开发者,包括后端开发、前端开发、测试工程师和项目经理。尤其适用于团队协作项目、开源贡献、以及需要满足合规要求的场景。对于个人项目或快速原型开发,可能过于严格,建议按需开启。

建议将本技能集成到CI/CD流水线中作为预提交钩子,或作为团队开发规范的一部分。可根据项目的实际需求自定义验证规则(如必须通过哪些测试、必须关联哪些文档),避免过度约束。

核心特点

和其他代码审查或质量检查技能不同,Proof-of-Work 聚焦于“提交前证据链的完整性”,而不是单纯检查代码质量——它要求开发者主动提供完成证据,并拒绝未经验证的声明。

注意事项

不适合快速原型开发、实验性代码或不需要严格流程的个人项目,过度使用可能降低开发效率。

常见问题

如何集成到CI/CD中?

在pipelines中添加proof-of-work命令作为前置步骤,只有验证通过才允许合并或部署。

可以自定义验证规则吗?

可以,通过配置文件(如.proof-of-work.yml)定义所需检查项,支持测试、文档、代码规范等。

给 AI 助手的安装指引

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

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