用途
Configure 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 查找 AGENTS.md、CLAUDE.md、README、CONTRIBUTING、package.json、pnpm-workspace.yaml、turbo.json、nx.json、各构建与测试配置、pom.xml、Gradle、Xcode、pyproject.toml、go.mod 等),并用 find 搜索 e2e、tests、test、specs、tests 目录。
阅读信号最强的文件:根级 agent 或贡献者说明、包管理器脚本、测试配置、PR 模板(如存在)、既有本地技能(如存在)、以及仓库暗示的移动端、桌面端、API 或部署文档。
在向团队提问前,先推断出显而易见的内容。不要问能从文件中得到答案的问题。
阶段 2 - 访谈团队
只问那些答案会改变所生成技能的问题,并分组以便一次性回答。
必问问题:
- 此工作流应支持哪些界面:web、PWA、API、iOS、Android、React Native、桌面、CLI、库、数据管道、基础设施还是 monorepo?
- 哪些命令能证明本项目正确性:lint、format、typecheck、单元、集成、E2E、build、安全扫描、移动模拟器测试、契约测试或其他?
- 哪些命令昂贵、易波动、具破坏性或需要审批?
- 本地功能验证应如何工作:应用 URL、认证路径、测试用户、种子数据、浏览器、设备、模拟器或 API 客户端?
- 任务完成后应产出什么证据:截图、视频、HTML 报告、测试日志、覆盖率、trace、无障碍输出、部署链接还是工单评论?
- PR 正文要求什么:工单链接、问题、变更、测试、截图、风险、回滚、兼容性、安全、无障碍、性能、可观测性还是发布说明?
- 适用哪些分支、提交与推送规则:分支前缀、分支含工单 ID、conventional commits、签名提交、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。不要给通用正文追加含糊的「Project Overrides」小节。
每个技能必须包含:
- 带 name、description 和可选 argument-hint 的 frontmatter。
- 清晰的触发与反触发行为。
- 项目契约:技术栈、界面与假设。
- 精确命令与路径,仅在必要时提供回退。
- 必需证据与报告位置。
- 失败处理与具体后续动作。
- 自我改进说明:若工作流过时,修补本地技能。
专用化规则:
- 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 - 验证
编写技能后:
- 确认每个生成的技能 frontmatter 从第 1 行开始且有效。
- 确认每个 name 与其目录匹配。
- 确认描述足够具体以正确触发,又不至于过宽而抢占无关任务。
- 运行适合仓库的语法检查:
find .agents/skills .claude/skills .codex/skills -name SKILL.md 2>/dev/null | sort。 - 写完后通读每个生成的技能,找出矛盾。
- 若仓库有技能校验器,运行它。
配置期间不要运行破坏性项目命令。仅执行只读检查与安全验证,除非用户明确批准更多操作。
最终报告
报告:
- 使用的本地技能目录。
- 创建或更新的技能。
- 创建的任何拆分测试技能及其原因。
- 已配置的命令与关卡。
- 留待运行时确认的问题。
- 任何风险、缺失凭据、不可用工具链或应改进的项目文档。