SuperAPI AI 工具集

planning-and-task-breakdown

通用与其它

查看项目

更新于 10-16 06:26

技能介绍

用途

该技能是规范化的“计划阶段”技能,用于把一份规格说明(spec)拆解为原子化、可独立验证的任务,并给出明确的验收标准、依赖排序与时间估算。适用于:规格已获批准、准备进入实现之前;某个功能大到无法一次完成;多人或多个智能体需要协作处理相关改动;以及在使用 incremental-implementation 或 test-driven-development 之前的准备阶段。

主要能力

  • 任务层级组织:Epic(完整功能)→ Phase(逻辑分组,约 1 天工作量)→ Task(原子单元,约 30 分钟)→ Subtask(仅当任务仍过大时使用)。
  • 原子任务字段:ID、Title(行动导向命名)、Depends On(阻塞任务 ID)、Files(需修改或创建的确切文件)、Acceptance Criteria(定义“完成”的复选框)、Spec Reference(关联用户故事与验收标准)、Estimated Time、Complexity(Low/Medium/High)。
  • 依赖排序与阶段划分:识别阻塞关系,将任务分组为阶段,同一阶段内的任务可并行执行,且每个阶段应产出可构建、可测试的状态。
  • 覆盖性校验:确认每条规格验收标准都至少被一个任务覆盖,检查依赖图无环,且没有任务过大或过于含糊。

使用方式

流程分为五步:

  1. 读取规格:提取全部用户故事与验收标准,识别非功能性需求,记录约束与边界。
  2. 将故事映射为任务:每个用户故事拆为若干实现任务,每个任务对应一次内聚改动,尽量可在一小时内完成,并尽可能可独立验证。
  3. 按依赖排序:识别阻塞关系,分组为可并行的阶段,确保每个阶段可构建、可测试。
  4. 估算与校验:分配时间估算,验证计划覆盖所有规格验收标准,检查任务是否过大或过模糊。
  5. 创建任务:
    • 首选 Solo(如可用)。先检测环境:
      # Check if Solo directory exists and CLI is available
      test -d ~/Github/Solo && which solo >/dev/null 2>&1
      
      若可用,使用 solo task create 命令逐个创建任务:
      solo task create \
        --title "Task title" \
        --description "Full task description with acceptance criteria and files" \
        --priority medium \
        --deps T-1,T-2 \
        --tags feature-name,phase-1 \
        --json
      
      Solo 任务字段映射:--title 对应 Task Title;--description 对应验收标准 + 文件 + 规格引用;--priority 由复杂度推导(Low→low,Medium→medium,High→high);--deps 为前序创建得到的 Solo 任务 ID,逗号分隔;--tags 为功能名与阶段标签。Solo 会返回分配的任务 ID(例如 T-142),用于后续任务的依赖引用。
    • 回退方案:文件式任务(Solo 不可用时)。在 specs/{feature}/tasks/ 下创建独立任务文件,如 T-001.md、T-002.md 等,格式包含标题、Depends On、Priority、Estimated Time、Complexity、Acceptance Criteria、Files、Spec Reference 等部分。

输出约定

默认输出仅返回结果、阻塞项和所需证据;省略前言、过程叙述、重复上下文、置信度评分与后续提议。除非必需的产物或 schema 需要更多内容,否则最多使用五条要点。

验证清单

  • 每条规格验收标准都至少由一个任务覆盖
  • 每个任务包含全部必需字段
  • 依赖图无环
  • 每个阶段产出可构建、可测试的状态
  • 任务已在 Solo 中创建(如可用),或保存为 specs/{feature}/tasks/*.md(回退方案)
  • 记录 Solo 任务 ID 以便依赖跟踪(如使用 Solo)

限制

资料未提供该技能的具体运行环境依赖、支持平台、收费或价格信息,暂未提供。文档中提及的 Solo 可用性检测命令与任务创建命令仅为资料给出的原始内容,未提供其安装方式或替代方案说明。