SuperAPI AI 工具集

choosing-a-workflow

智能体与模型

查看项目

更新于 10-27 00:56

技能介绍

用途

choosing-a-workflow 是 packages/pi-thinkrail-workflow 中工作流技能族群的根路由技能。它只做两件事:对新的、可适用工作流的工作进行分类,并指明管辖该工作的具体工作流技能名称。已经路由过的工作会继续其进行中的工作流,而不重新路由。被路由到的技能,其具体步骤只存在于该技能自身中;应阅读该技能,而不是凭记忆执行。

主要能力:分类

对于一项新工作,阅读请求并利用已知信息回答三个问题:

  1. 是否为项目上手?——尚无规格图(spec graph),即空或实际上为空的工作区、用户带来一个原始想法,或正在首次搭建或编写规格的现有代码库。
  2. 是否为 PR 生命周期?——已完成的工作以拉取请求形式交付,或现有 PR 正在被维护:创建、更新到最新、补充截图、观察其检查、处理其评审意见。源自 PR 自身评审意见的修复也归入此类。
  3. 是否改变产品行为?——新增功能、行为变更或缺陷修复,无论多小,即使请求已经写明设计。详细的请求会缩短访谈,但不会跳过访谈。

如果以上均不适用,则无需工作流:直接进行,不做工作流声明。只有不改变行为的工作才属于这一类:非 PR 的问题、解释或检查;错别字、文档或仅配置的修改;重命名等机械式重构。

如果仅凭请求确实无法判断路由,应提出一个简短的澄清问题(ask_user_question,按 asking-user-questions 概念技能编写),而不是猜测。

使用方式:路由

  • 项目上手、尚无规格图 → 阅读并遵循 setting-up-a-project
  • PR 生命周期工作 → 阅读并遵循 shipping-a-pr
  • 功能、行为变更或缺陷修复 → 阅读并遵循 brainstorming
  • 以上都不是 → 无匹配工作流,直接进行,不宣布路由结果

一项工作只走一条路由。如果请求把未完成的实现与 PR 工作捆绑在一起,先路由实现部分,等实现落地后再回到 shipping-a-pr。

危险信号——停下并重新路由

  • 你没有经过 brainstorming 就开始实现功能、行为变更或缺陷修复。
  • “它很小”或“请求已经很具体”——两者都不是跳过的理由;工作流会缩小规模,但不会关闭。
  • 你为不改变行为的工作(重命名、错别字、问题)加载了 brainstorming。
  • 你在继续已分配给某个工作流的工作时再次进入此路由。
  • 你凭记忆遵循被路由技能的步骤,而不是阅读该技能。

交接

此技能结束时用且仅用一个名称收尾:setting-up-a-project、shipping-a-pr、brainstorming,或无匹配工作流(直接进行)。向该族群添加工作流,就是在上表中增加一行——参见 writing-workflow-skills 技能。