SuperAPI AI 工具集

configure-task-to-pr

编程与开发

查看项目

更新于 10-16 08:16

技能介绍

用途

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

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

最终报告

报告内容包括:所用本地技能目录;创建或更新的技能;创建的任何拆分测试技能及其原因;配置的命令与门禁;留待运行时确认的问题;以及任何风险、缺失凭据、不可用工具链或应改进的项目文档。

限制

该技能只负责配置项目本地技能,不执行实现、提交、功能测试或流程讲解。资料未提供其收费、价格、平台兼容范围或性能数据。