SuperAPI AI 工具集

worktree-ux-pr

部署与运维

查看项目

更新于 10-15 21:10

技能介绍

用途:自动化基于 worktree 的 UX PR 工作流,涵盖变基、界面验证、证据采集与 PR 评论。

主要能力:确保 worktree 变基到 origin/dev,历史变化时强制推送;引导使用 Chrome MCP 验证并截图;提供截图上传与 PR 评论的简单流程;根据 .env 中的配置推断行为,缺失时回退到安全默认值。

使用方式:

  1. 同步仓库并变基 worktree:scripts/rebase-worktrees.sh ux-improvement-01 ux-improvement-02。worktree 预期位于企业根目录下的 ./_worktrees,可用 WORKTREE_BASE 覆盖。
  2. 启动 UI 与 headless(可选):scripts/start-ui.sh、scripts/start-headless.sh。
  3. 采集证据:用 Chrome MCP 打开 UI 并导航到变更界面,截图保存到 /tmp。
  4. 上传截图并评论 PR:scripts/upload-catbox.sh /tmp/your-screenshot.jpg,然后 scripts/comment-pr.sh 414 "Screenshot: https://files.catbox.moe/xyz.jpg"。

首次配置:安装依赖(pnpm install);确认 gh auth status 已登录以便评论 GitHub;可选在 .env.example 设置覆盖项并复制为 .env。

常见问题:headless 因版本不匹配失败时,用 pnpm --filter openwork-server build:bin 重建服务端二进制;Chrome MCP 无法创建会话时,确认没有冲突的开发服务器在运行;GitHub 评论失败时,检查 gh auth status 与仓库是否正确。

相关技能:创建 worktree 与常规提交见 skills/worktree-workflow/SKILL.md;UI 设置与验证见 skills/openwork-testability/SKILL.md 与 skills/openwork-chrome-mcp-testing/SKILL.md。参考官方 OpenCode skills 文档:https://opencode.ai/docs/skills/。

限制:资料未提供收费、价格、平台支持范围与效果保证等信息。