SuperAPI AI 工具集

task-planning

编程与开发

查看项目

更新于 10-16 07:30

技能介绍

用途

task-planning 用于从设计(design)出发规划实现任务(Task),属于规划轮次。它覆盖里程碑范围内(in-scope)的故事(story),目标是在每个标记为 NEEDS TASKS 的故事都由一个任务承接后结束;标记为 COVERED 的故事已有任务服务,仅作参考,绝不返工。若指令中没有里程碑范围(Milestone scope)部分,则对整个设计中所有需要工作的组件进行规划,规则相同。

主要能力

  • 以设计组件为工作单元:一个组件对应一个任务。故事由引用它的组件承接(故事位于 components/<name>/design.json,源自 cell),因此应规划或扩展该组件的任务。不得凭空发明组件;若某故事没有任何组件引用,属于设计的缺口,应在最终文本中说明并建议扩展设计,而不是创建一个无归属的任务。
  • 任务标题:按工作内容命名,全新实现用“Implement order-service”,增量用“Add refunds to order-service”,标题需唯一且可读。
  • rationale:一句话说明该任务为何存在。
  • dependsOn:取自设计中的组件依赖边。若 order-service 调用 user-service,则其任务 dependsOn 为 ["user-service"]。不得使用 issue 编号,也不得包含平台基础设施(数据库、网关、IDP)。对每条组件边 A→B,A 的任务列出 B,dependsOn 承载构建顺序;出现环会被拒绝,需打破环。
  • 依赖种类与门禁:组件(component)依赖由消费方任务在 dependsOn 中列出提供方,rationale 记录构建顺序边;org-service 依赖不产生排序效果,提供方位于另一个项目,rationale 记录跨项目绑定;external 依赖不产生排序效果,rationale 记录取值门禁;platform-resource 依赖不产生排序效果,rationale 记录供给门禁。门禁只做标记,绝不创建:平台负责编写门禁 issue,你不为门禁输出任务。每条设计依赖必须且仅被记录一次——组件类进入 dependsOn,其余三类进入 rationale。
  • 平台自动填充:平台根据设计的引用关系为每个任务盖上“Serves stories”块,你无需编写。

使用方式

全新规划与增量变更遵循同一流程:

  • 受影响组件存在待处理任务 → 用 updateTask 更新(重述范围、刷新 dependsOn、重写正文),而不是规划重复任务。
  • 组件工作已完成、又有新故事到来 → 仅为新工作规划一个增量任务,标题需明显区分。
  • 进行中的工作 → 用 updateTask 加注说明变更叠加在其上,绝不静默重写其范围。
  • 未受影响的组件与 COVERED 故事 → 不做任何操作,保持沉默是正确的。
  • 已废弃组件(有任务但已从设计中移除)→ 用 updateTask 加废弃说明,由人工关闭。
  • 仅当单个 PR 在物理上无法承载工作时(例如迁移必须先于功能代码合并),才把一个组件拆成多个任务。

规划完成后,必须在同一轮次结束前通过 updateTask 写入每个已规划任务的完整正文,包含:## Scope(具体工作,引用组件的 design.json 及其 openapi.yaml/wireframes.dsl)、## Acceptance(完成的含义,处于工作层面——产品验收由 validation oracle 负责)、## References(编码智能体读取的规格路径)。没有正文的任务属于未完成的规划。

适用场景

适用于从设计规划实现任务的规划轮次,尤其是需要按里程碑范围覆盖故事、按组件建立构建顺序、区分组件依赖与跨项目/外部/平台资源依赖,以及处理全新与增量混合变更的工程流程。

限制

  • 不得发明组件;无组件引用的故事应作为设计缺口上报。
  • 不得为门禁创建任务,门禁由平台编写。
  • dependsOn 不得使用 issue 编号或平台基础设施。
  • 不得重复创建任务或静默重写进行中任务的范围。
  • 工具拒绝时按其提示修正后重新提交:UNKNOWN_COMPONENT 会列出已知组件,UNKNOWN_REF 会列出可寻址引用,DUPLICATE_TITLE 表示需换一个不同标题,DEPENDENCY_CYCLE 会显示需要打破的路径;不得重新提交已成功的操作。

关于该技能的收费、价格、支持平台等具体信息,资料中暂未提供。