用途
configure-task-to-pr 用于配置一个项目专属的 task-to-PR 流水线。它把通用的 Supatest AI task-to-PR 技能套件,转化为了解当前仓库命令、校验门禁、评审规则、产物路径、界面形态和运维约束的项目本地技能。
它会在目标项目中创建或更新本地技能,而不是写一份集中式配置文件;每个被配置的技能都应读起来像是为该项目的场景专门编写。
何时不使用
资料明确列出以下不适用场景:
- 不用于执行实现任务,应使用 task-to-pr。
- 不用于只提交当前改动,应使用 commit。
- 不用于只测试已完成的功能,应使用 test-feature。
- 不用于一次性解释该工作流,此时应直接说明已安装的技能。
目标输出
在首个受支持的本地技能目录下创建或更新项目本地技能:
.agents/skills/<skill-name>/SKILL.md.claude/skills/<skill-name>/SKILL.md.codex/skills/<skill-name>/SKILL.md
当仓库已使用 .agents/skills 或尚无既定技能目录时,优先使用 .agents/skills;若项目已记录某个目录,则使用该目录。
默认配置以下技术栈:
task-to-pr、test-feature、automate-e2e-tests、agent-browser、commit、review-pr
仅当校验机制确实存在差异时,才创建界面专属的测试技能:test-web-feature、test-mobile-feature、test-ios-feature、test-android-feature、test-api-feature、test-desktop-feature。
拆分依据是工具链与证据要求,而不是产品标签。例如,同样使用 Playwright 的 Web 应用与 PWA 可以共用 test-feature;原生 iOS 与 Android 应用通常应配置为各自独立的技能。
阶段 1 - 检查仓库
在提问前先阅读仓库,运行聚焦的探查命令:
pwd
git status --short
rg --files -g 'AGENTS.md' -g 'CLAUDE.md' -g 'README*' -g 'CONTRIBUTING*' -g 'package.json' -g 'pnpm-workspace.yaml' -g 'turbo.json' -g 'nx.json' -g 'vite.config.*' -g 'next.config.*' -g 'playwright.config.*' -g 'cypress.config.*' -g 'pom.xml' -g 'build.gradle*' -g 'settings.gradle*' -g 'pyproject.toml' -g 'go.mod' -g '*.xcodeproj' -g '*.xcworkspace' -g 'Package.swift'
find . -maxdepth 3 -type d \( -name e2e -o -name tests -o -name test -o -name specs -o -name __tests__ \) 2>/dev/null | sort
阅读信息量最高的文件:根级 agent 或贡献者说明、包管理器脚本、测试配置、PR 模板(若存在)、现有本地技能(若存在),以及当仓库暗示存在移动端、桌面端、API 或部署界面时对应的文档。
先推断显然的信息再向团队提问,不要提文件中已有答案的问题。
阶段 2 - 访谈团队
只提那些答案会改变所生成技能的问题,并把问题分组以便一次性回答。
必问问题:
- 该工作流应支持哪些界面:Web、PWA、API、iOS、Android、React Native、桌面端、CLI、库、数据管道、基础设施还是 monorepo?
- 哪些命令能证明本项目正确:lint、format、typecheck、单元、集成、E2E、构建、安全扫描、移动模拟器测试、契约测试或其他检查?
- 哪些命令昂贵、不稳定、具破坏性或需要审批?
- 本地功能校验应如何工作:应用 URL、认证路径、测试用户、种子数据、浏览器、设备、模拟器、仿真器还是 API 客户端?
- 已完成任务应产出哪些证据:截图、视频、HTML 报告、测试日志、覆盖率、trace、无障碍输出、部署链接还是工单评论?
- PR 正文需要什么:工单链接、问题、改动、测试、截图、风险、回滚、兼容性、安全、无障碍、性能、可观测性还是发布说明?
- 适用哪些分支、提交与推送规则:分支前缀、分支中带工单 ID、约定式提交、签名提交、squash 策略、禁止推送策略,还是推送前评审?
- 适用哪些企业约束:受监管数据、客户隔离、审批门禁、禁止生产访问、迁移护栏、密钥策略、审计证据还是安全评审?
仅对会使技能不安全或无用处的歧义追问。若用户无法回答,则在相关技能中写入运行时确认步骤,而不是猜测。
阶段 3 - 选择技能拓扑
决策表:
- 单一主要产品界面:仅配置 test-feature。
- Web 与 PWA 共享浏览器工具:配置 test-feature 并划分界面小节。
- Web 与原生移动端工具不同:配置 test-web-feature 加 test-mobile-feature 或平台专属技能。
- iOS 与 Android 使用不同命令/设备:配置 test-ios-feature 与 test-android-feature。
- 仅 API 服务:配置 test-api-feature;仅在存在文档/管理 UI 时保留 agent-browser。
- 库/包:除非存在示例/文档 UI,否则不配置浏览器测试技能。
- 含独立应用的 monorepo:task-to-pr 按所触界面路由;命令不同时拆分测试技能。
首次配置应小到可用。当团队给出因界面而异的具体命令、工具或证据要求时,再添加拆分技能。
阶段 4 - 编写项目本地技能
为每个本地技能编写一份完整连贯的 SKILL.md,不要给通用正文追加含糊的“项目覆盖”小节。
每个技能必须包含:
- 含 name、description 和可选 argument-hint 的头部元数据。
- 明确的触发与反触发行为。
- 项目契约:技术栈、界面与假设。
- 精确的命令与路径,仅在必要时给出回退方案。
- 必需证据与报告位置。
- 失败处理及具体后续动作。
- 自我改进指令:若工作流过时,则修补本地技能。
专项化规则:
- task-to-pr:编排需求、规划、实现、校验、测试证据、提交、自评审、推送与 PR。
- test-feature:校验已完成的面向用户行为,并写出功能校验报告。
- automate-e2e-tests:使用项目的 E2E 框架,把已验证行为转化为持久回归覆盖。
- agent-browser:教授可用浏览器自动化工具的浏览器机制。若 Agent Browser CLI 是标准,则保持精简,并调用
agent-browser skills get agent-browser --full获取最新说明。 - commit:固化项目的提交、分支、暂存、签名与推送策略。
- review-pr:固化本地评审维度、严重性模型与领域风险。
阶段 5 - 保留上游来源信息
在所生成本地技能靠近底部处添加简短的来源小节:
## Source
Generated from Supatest AI supa-skills `<skill-name>` v<version> by `configure-task-to-pr`.
Project-specific behavior is intentionally local to this repository.
更新已有配置技能时,保留有价值的本地知识,替换过时命令、移除矛盾内容,并保持来源/版本为最新。
阶段 6 - 校验
编写技能后:
- 确认每个生成的技能头部元数据有效且从第 1 行开始。
- 确认每个 name 与其目录一致。
- 确认 description 足够具体以正确触发,又不至于宽泛到抢走无关任务。
- 运行契合仓库的语法检查:
find .agents/skills .claude/skills .codex/skills -name SKILL.md 2>/dev/null | sort - 写完后逐个通读生成的技能,以发现矛盾。
- 若仓库有技能校验器,则运行它。
配置期间不要运行破坏性项目命令。除非用户明确批准更多操作,否则只运行只读检查与安全校验。
最终报告
报告内容包括:所用本地技能目录;创建或更新的技能;创建的任何拆分测试技能及其原因;配置的命令与门禁;留待运行时确认的问题;以及任何风险、缺失凭据、不可用工具链或应改进的项目文档。
限制
该技能只负责配置项目本地技能,不执行实现、提交、功能测试或流程讲解。资料未提供其收费、价格、平台兼容范围或性能数据。