SuperAPI AI 工具集

configure-task-to-pr

编程与开发

查看项目

更新于 10-16 22:42

技能介绍

用途

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。
  • 写完后通读每个生成的技能,找出矛盾。
  • 若仓库有技能校验器,运行它。

配置期间不要运行破坏性项目命令。仅执行只读检查与安全验证,除非用户明确批准更多操作。

最终报告

报告:

  • 使用的本地技能目录。
  • 创建或更新的技能。
  • 创建的任何拆分测试技能及其原因。
  • 已配置的命令与关卡。
  • 留待运行时确认的问题。
  • 任何风险、缺失凭据、不可用工具链或应改进的项目文档。