AgentSkillsCN

worktree-ux-pr

自动化基于工作树的UX PR工作流：基于origin/dev进行变基，通过Chrome MCP进行验证，并附加相关证据。 当用户提及以下内容时触发： - “基于origin/dev进行变基并运行Chrome MCP” - “每个工作树提交一个PR，并附上截图” - “工作树UX改进PR流程”

SKILL.md
--- frontmatter
name: worktree-ux-pr
description: |
  Automate the worktree-based UX PR workflow: rebase against origin/dev, verify via Chrome MCP, and attach evidence.

  Triggers when user mentions:
  - "rebase against origin/dev and run chrome mcp"
  - "one pr per worktree with screenshots"
  - "worktree ux improvements PR flow"

Quick Usage (Already Configured)

1) Sync repo and rebase worktrees

bash
scripts/rebase-worktrees.sh ux-improvement-01 ux-improvement-02

Worktrees are expected under ./_worktrees at the enterprise root (override with WORKTREE_BASE).

2) Start UI + headless (optional)

bash
scripts/start-ui.sh
scripts/start-headless.sh

3) Capture evidence

  • •Use Chrome MCP to open the UI and navigate to the changed surface.
  • •Take a screenshot and save to /tmp.

4) Upload screenshot and comment on PR

bash
scripts/upload-catbox.sh /tmp/your-screenshot.jpg
scripts/comment-pr.sh 414 "Screenshot: https://files.catbox.moe/xyz.jpg"

What This Skill Does

  • •Ensures worktrees are rebased on origin/dev and force-pushed when history changes.
  • •Guides Chrome MCP verification and screenshot capture.
  • •Provides a simple upload + PR comment workflow for evidence.
  • •Infers behavior based on available config in .env and falls back to safe defaults.

Related skills

  • •For creating worktrees and regular commits, use .opencode/skills/worktree-workflow/SKILL.md.
  • •For UI setup and verification, use .opencode/skills/openwork-testability/SKILL.md and .opencode/skills/openwork-chrome-mcp-testing/SKILL.md.

Scripts

  • •scripts/rebase-worktrees.sh: Rebase each worktree on origin/dev and force-push.
  • •scripts/start-ui.sh: Start the OpenWork UI dev server.
  • •scripts/start-headless.sh: Start headless OpenWork server (optional for remote behavior).
  • •scripts/upload-catbox.sh: Upload a screenshot and return a public URL.
  • •scripts/comment-pr.sh: Comment on a PR with a screenshot URL.

Common Gotchas

  • •If headless fails with a version mismatch, rebuild the server binary via: pnpm --filter openwork-server build:bin
  • •If Chrome MCP cannot create a session, ensure no conflicting dev servers are running.
  • •If GitHub comment fails, verify gh auth status and that the repo is correct.

First-Time Setup (If Not Configured)

  1. •Ensure dependencies are installed (pnpm install).
  2. •Confirm gh auth status is logged in for GitHub comments.
  3. •Optional: set overrides in .env.example and copy to .env.

Reference

Follow the official OpenCode skills docs: https://opencode.ai/docs/skills/