SuperAPI AI 工具集

task-to-pr

通用与其它

查看项目

更新于 10-16 07:16

技能介绍

用途:把一个任务、工单、bug 或功能从理解推进到 PR,覆盖理解、规划、实现、验证、提交、自审、分支推送与创建 PR 全流程。这是通用入门技能,真实项目应先运行 setup-task-to-pr,用本地命令和交付规则丰富它。不适用场景:纯代码审查用 review-pr;仅提交已完成工作用 commit;仅对已完成功能做浏览器测试用 test-feature;为仓库搭建工作流用 setup-task-to-pr。

交付契约:创建或标记 PR 就绪前,需捕获需求与假设、理解可能改动的文件与归属边界、对非平凡工作给出简短计划、实现覆盖正常路径与重要异常路径及恢复状态、运行相关验证通道或记录跳过原因、用户可见行为有功能验证证据、浏览器或移动端集成行为变化时新增或说明跳过持久化 E2E 覆盖、只暂存并提交任务范围内文件、分支适合评审、PR 正文涵盖问题、改动、测试、边界情况、兼容性、风险与回滚。

阶段:理解时先读需求与仓库说明,如 rg --files -g 'AGENTS.md' -g 'CLAUDE.md' -g 'CONTRIBUTING*' -g 'README*' -g 'docs/**',查看本地技能 find .agents/skills .claude/skills .codex/skills -maxdepth 3 -name SKILL.md 2>/dev/null | sort,并记录 git status --short、git branch --show-current、git rev-parse --short HEAD。规划时给出需求、假设、可能改动文件、实现顺序、验证通道、功能验证与 E2E 决策、兼容性与风险。实现时遵循项目指令、收窄写入范围、优先复用既有模式。验证时按改动类型运行最小有效检查,分开对待 lint、类型检查、单元、集成、E2E、构建、安全、可访问性与功能验证;未配置时用 npm run、pnpm run、yarn run、npm run test、npm run lint、npm run typecheck、npm run build、pytest、go test ./...、cargo test、mvn test、./gradlew test 等发现命令;每条记录命令、范围、结果、证据路径与跳过原因。提交与审查时查看 diff,用 commit 做范围提交,非平凡或安全敏感改动用 review-pr 自审;除非明确授权,不要用 git add .、git add -A、强推、破坏性重置或单边冲突解决。创建 PR 时按策略推送 git push -u origin <branch>,可用 gh pr create,正文默认含 Problem、Requirement、Changes、Testing、Edge Cases、Compatibility、Risk and Rollback、Self-Review。CI 跟进时检查必须通过项,分类失败并只修本任务引入的产品或测试失败。收尾报告 PR URL 或分支、提交 SHA、命令与结果、验证报告路径、E2E 覆盖状态与剩余风险。限制:未提供具体项目命令、CI 平台细节或自改进的具体触发条件,相关事实暂未提供。