用途:该技能面向提交 Pull Request 的开发者,帮助生成或改写 PR 标题与描述。它假设评审者每天要看约 50 个 PR,只会给每个 PR 约 60 秒,因此描述只保留能帮助评审者批准、提问或测试的内容。变更原因由工单、PRD 或产物说明,实现方式由 diff 和提交记录体现,描述只补充评审者看不到的信息:变更后的样子、如何运行查看、该读哪些文件。
主要能力:提供 PR 描述模板,包含工单链接与堆叠 PR 行、一句话说明用户可见变化、Before/After 截图表格、Try it 步骤、Review 文件路径、Needs decision 决策项。规定标题格式为 ABC-123: <Area>: <change>,最多 60 字符,使用祈使句或名词短语,单一子句。正文散文最多 80 词(不计图片表格、Try it 步骤和文件路径),要点最多 5 条、每条最多 15 词,除非有 3 组以上截图对否则不用 ## 标题。
视觉类 PR 处理:若 PR 涉及 UI 代码(.tsx、.vue、.swift、.kt、.css)、设计令牌、文案目录、图标或设计系统组件,则视为视觉类 PR,必须提供截图。流程包括:运行分支截取 After 图;在仓库外的临时目录用 git worktree add <tmp>/base $(git merge-base HEAD origin/main) 检出基线并截取 Before 图;保证设备、滚动位置、夹具一致,仅组件变化时裁剪到组件;动效或交互录制短 mp4/mov,视频不能有 alt 文本,放在表格下方单独一行并加粗 Before/After 标签;用 gh 2.102 及以上版本通过 --attach 上传,正文中以  引用,gh 会重写为托管 URL,每条命令最多 50 个文件,截图不提交到仓库,事后用 gh pr view --json body 检查是否仍有未上传的 ./pr-shots/ 路径。截图对使用 1 到 3 组,选变化最大的屏幕;若涉及 40 个屏幕,展示 2 个代表性屏幕并注明其余屏幕同样变化。
Try it 步骤写法:步骤是评审者在运行中的应用里执行的操作,不写单元测试(CI 已报告)。第 1 步说明起点:哪个应用、哪个状态、哪个屏幕。每步以 Expect <可见结果> 结尾。少于 5 步。每个步骤都要先实际运行过,不能猜测如何到达某状态;加载、错误或空状态需在代码中找到真实触发方式(演示控件、夹具账号、mock 开关、调试菜单项)并在步骤中写明。无法运行且代码未说明如何到达的状态应省略,并单独告知用户哪些状态未能到达、哪些步骤只做了代码追踪。使用编号列表而非无人勾选的复选框。
适用场景:日常功能 PR、UI 变更 PR、堆叠 PR、需要评审者做决策的 PR。
限制与注意事项:技能列出应删除的常见模式,如复述标题的 Summary、转述工单的 Linear 段落、与工单重复的“为什么需要”、函数名走查、评审历史、未改动清单、研究证明、兴趣性对比表、第三人称作者表述、带日期署名、行数辩护、其他分支合并冲突预测、代理会话或聊天记录链接、正文中的评审请求、已合并依赖的“Depends on”、环境限制说明(如本机无法运行、无浏览器所以无截图、未本地跑测试)以及“now”“explicitly”“exactly”“this PR”等填充词。评审者通过 gh pr edit --add-reviewer <login> 添加,不在正文中写人名,唯一例外是 Needs decision 下的 @ 提及。堆叠或依赖 PR 需先用 gh pr view <n> --json state 检查状态,已合并的省略;若基分支 PR 已合并,应提示用户将 PR 重定向到默认分支。写作风格要求使用评审者能在屏幕上看到的具体名词,一句一个事实、现在时,代码格式仅用于评审者会搜索的标识符,决策项放在底部、@ 提及相关人、不超过 3 行。执行流程为:收集 git log、diff stat、分支名中的工单 ID、基分支及 PRD 链接;检查堆叠与依赖 PR 状态并去掉已合并项;判断是否视觉类并先截图、边跑 Try it 步骤;填模板并删除不需要的段落;以还有 59 个 PR 在排队的评审者视角逐句审视并核对字数;在临时目录用 gh pr create --body-file body.md --attach … 或 gh pr edit 创建或编辑,并在同一命令加 --add-reviewer;最后向用户展示最终标题与正文,列出未能运行的 Try it 步骤、未能生成的截图或检查,该清单只给用户,不写入 PR 正文。