SuperAPI AI 工具集

workflows-work

编程与开发

查看项目

更新于 10-16 07:29

技能介绍

用途

workflows-work 是一条工作流执行命令,接收一份工作文档(计划、规格说明或 todo 文件)作为输入,并将其系统地落地执行。它的核心目标是在快速理解需求、遵循既有模式、持续保证质量的前提下,交付完整的功能,而不是停留在半成品状态。

主要能力

整条工作流分为四个阶段。

第一阶段:快速启动。 完整阅读工作文档及其引用的链接,若有不清楚或含糊之处,立即提出澄清问题并取得用户批准再继续;检查当前分支并决定继续现有分支、新建分支还是使用 worktree;随后用 TodoWrite 将计划拆解为可执行、可完成、含依赖关系和测试质量检查的具体任务。

第二阶段:执行。 按优先级逐项处理任务,标记进行中与已完成,阅读计划引用的文件、参照代码库中的相似模式实现,为新功能编写测试,并运行“系统级测试检查”:追踪改动触发的回调、中间件、事件处理器(向外追溯两层),确认测试是否走真实链路而非全部 mock,检查失败是否会留下孤立状态,检查其它接口是否需要同步实现,以及各层错误策略是否一致。每完成一项还要评估是否适合做增量提交,并始终在计划文档中把 - [ ] 改为 - [x]。

第三阶段:质量检查。 运行完整测试套件与 lint,对复杂、高风险或大范围改动可选启用 reviewer agents,做最终校验(任务全部完成、测试与 lint 通过、遵循既有模式、Figma 设计一致等),并为每次变更在 PR 描述中补充“部署后监控与验证”章节。

第四阶段:交付。 以约定式提交格式创建 commit,UI 变更必须用 agent-browser CLI 截图并通过 imgup 上传,创建 Pull Request(含摘要、测试说明、部署后监控、前后截图等),更新计划状态并通知用户。

此外还提供可选的 swarm 模式:当计划包含 5 个以上相互独立的任务、需要多种角色(实现、测试、审查)或存在清晰阶段时,可创建团队、按依赖关系建立任务列表、并行生成 implementer 与 tester 等子代理协同执行,最后统一清理。

使用方式

命令接收输入文档 <input_document> #$ARGUMENTS。文中给出的相关命令包括检查分支的 git branch --show-current、创建分支的 git pull origin [default_branch] 与 git checkout -b feature-branch-name,以及截图流程 agent-browser open、agent-browser snapshot -i、agent-browser screenshot output.png,上传示例 imgup -h pixhost screenshot.png。启用 swarm 模式可通过口头指令,例如“Make a Task list and launch an army of agent swarm subagents to build the plan”。具体安装与运行方式暂未提供。

适用场景

适合需要按计划文档系统推进功能开发、并希望内建测试与质量把关的工程任务,尤其是涉及回调、中间件、错误处理或多接口暴露的改动,以及需要并行拆分的复杂功能计划;也适用于带 Figma 设计的 UI 实现与需要 PR 部署后监控说明的交付流程。

限制

资料中未提供安装命令、具体运行参数或对特定平台的要求。该工作流依赖 TodoWrite、agent-browser、imgup 等工具与若干 skill(如 git-worktree、linting-agent、orchestrating-swarms);reviewer agents 需要从 compound-engineering.local.md 读取配置,若无设置文件则需先运行 setup skill 创建。不应对简单叶子节点改动(无回调、无状态持久化、无并行接口)执行系统级检查;reviewer agents 不建议默认启用。