← 返回 Skills 市场
PR-Proof-of-Work
作者
Haoming Yan
· GitHub ↗
· v1.0.0
· MIT-0
92
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install pr-proof-of-work
功能描述
TDD-driven E2E workflow with real Playwright browser screenshots as PR proof. Use when: (1) fix bugs or implement features with test-first approach, (2) crea...
安全使用建议
This skill is mostly what it says: it helps capture Playwright BEFORE/AFTER screenshots and post them on a PR. Before using it, check these things: (1) the SKILL.md and scripts assume you have git and the GitHub CLI (gh) installed and authenticated with push/comment permissions — the registry metadata did not declare these requirements; (2) the shell script will create a branch, commit screenshots into your repo, and run git push --force on a branch named e2e-screenshots-<PR_NUM> — be sure you are comfortable with that (it can overwrite remote branch history); (3) export E2E_SCREENSHOT_DIR or accept the default path; (4) example commands in the doc sometimes use jq and shuf — ensure those binaries exist if you use the examples; (5) review the scripts (assets/screenshot-reporter.ts and scripts/pr-comment-screenshots.sh) and run them in a safe/test repository or on a fork first to confirm behavior. If you need the skill to avoid modifying your repo, do not run the pr-comment script — instead upload images manually or adapt the script to your policies. If anything here is unclear, ask the maintainer for explicit dependency and permission documentation.
能力评估
Purpose & Capability
Name/description align with included files: a TypeScript screenshot helper and a shell script that uploads screenshots to a PR. The files and SKILL.md are coherent with a TDD E2E screenshot-to-PR workflow. However, the skill metadata declares no required binaries or env vars while the instructions and script clearly rely on git, the GitHub CLI (gh), and optionally jq/shuf in examples — this mismatch is a notable omission.
Instruction Scope
SKILL.md stays on-task: it instructs creating tests, capturing BEFORE/AFTER screenshots, and making PRs. The provided shell script reads manifest.json, copies image files into the repo, creates a temporary branch, pushes images, and posts a PR comment via gh. All of these actions are within the described purpose and there is no hidden network exfiltration beyond pushing to the user's GitHub repo / using gh.
Install Mechanism
No install spec — instruction-only with two code files. No external downloads or archive extraction are present. This is low risk from an install-execution standpoint.
Credentials
The skill omits declaring required environment/binary dependencies: it uses E2E_SCREENSHOT_DIR (SKILL.md tells you to export it) and requires git and gh CLI with push permissions (and in one example uses jq/shuf). The script implicitly depends on an authenticated gh and write access to the repository remote. Those credentials/permissions are not listed in requires.env/primaryEnv, which is an important mismatch — the skill will act with your git/GitHub permissions if run.
Persistence & Privilege
The shell script creates a branch in the repository, copies screenshots into the repo, commits them and does a git push --force to a branch named e2e-screenshots-<PR>. It attempts to restore the user's current branch but performs remote force-pushes and modifies repo state. This behavior is coherent with the 'push screenshots and comment' purpose but is privileged (it mutates the user's repo and remote).
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install pr-proof-of-work - 安装完成后,直接呼叫该 Skill 的名称或使用
/pr-proof-of-work触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release introducing a TDD-driven E2E PR workflow powered by Playwright screenshots as PR proof.
- Define a strict "One issue → One PR" process with visual before/after proof for every code change.
- Mandate studying passing tests and prohibit direct DOM modification via page.setContent().
- Require Playwright E2E tests using real browser, capturing BEFORE and AFTER screenshots.
- Document setup, worktree isolation, screenshot management, and strict PR requirements.
- Outline fallback strategies for backend-only changes by connecting code to observable UI outcomes.
- Enforce a hard gate: both BEFORE/AFTER screenshots and passing tests required before opening a PR.
元数据
常见问题
PR-Proof-of-Work 是什么?
TDD-driven E2E workflow with real Playwright browser screenshots as PR proof. Use when: (1) fix bugs or implement features with test-first approach, (2) crea... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 92 次。
如何安装 PR-Proof-of-Work?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install pr-proof-of-work」即可一键安装,无需额外配置。
PR-Proof-of-Work 是免费的吗?
是的,PR-Proof-of-Work 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
PR-Proof-of-Work 支持哪些平台?
PR-Proof-of-Work 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 PR-Proof-of-Work?
由 Haoming Yan(@newtontech)开发并维护,当前版本 v1.0.0。
推荐 Skills