SuperAPI AI 工具集

safe-pr

编程与开发

查看项目

更新于 10-15 20:08

技能介绍

用途:safe-pr 是 red-green-refactor 流程的收尾阶段,把已通过测试的切片整理成一份证据充分、便于资深工程师审查的 PR,目标分支为 main。

主要能力:提供 PR 正文模板 assets/pr-body-template.md 与脚本 scripts/collect-evidence.mjs。脚本可收集证据到已提交的 evidence 目录并生成 PR 正文:Web 切片嵌入截图并链接录像与 HTML 报告;非 Web 切片(--type cli|api|service 配合 --transcript)把终端记录以代码块嵌入。模态可自动检测(Playwright 产物视为 Web)或用 --type 强制指定。脚本分两阶段运行:提交证据前用 --copy-only 复制并扫描密钥,提交后用 --body-only 生成正文并把链接固定到证据提交。它会自动检测仓库可见性,私有仓库把截图渲染为可点击的 blob 链接。

使用方式:需已认证的 GitHub CLI(gh)和 GitHub 远程仓库,先确认 gh auth status 与 git remote -v。前置条件:切片为绿、CI 工作流存在、位于功能分支 feat/<feature-slug>/<NN>-<slice-slug>、工作树已提交。先真实运行测试产出证据,再执行 node "${CLAUDE_SKILL_DIR}/scripts/collect-evidence.mjs" --feature <feature-slug> --slice <NN-slice-slug> --copy-only(Web 需加 --report-dir/--results-dir;非 Web 加 --type 与 --transcript)。检查密钥后提交证据,再以 --body-only 生成 PR_BODY.md,填写占位符,确认后推送并创建 PR:gh pr create --base main --head feat/<feature-slug>/<NN-slice-slug> --title "..." --body-file PR_BODY.md。

适用场景:TDD 切片完成、需要附带可验证证据的 PR 提交。

限制:推送与创建 PR 前必须获得用户明确确认;禁止 force-push、改写共享历史或直接推送 main;仅在测试全绿且有证据时开 PR;不得包含密钥、令牌或超出必要证据的大型二进制文件;视频应保持简短。默认丢弃原始 trace(*.zip)与 HAR 文件,除非显式传入 --include-traces。其他未在资料中说明的细节暂未提供。