SuperAPI AI 工具集

sus-task

智能体与模型

查看项目

更新于 11-05 04:30

技能介绍

用途

Sus Task 用于把一份已经就绪(status: ready)的 Suspec 规格拆分成多个“防冲突”的任务包,使得受规格约束的工作可以被划分为相互独立的并行切片。其核心原则是“没有独立性,就不拆分”。

主要能力

  • 只接受状态严格为 ready 的规格,并读取规格及其提及的每一个来源。
  • 枚举所有限定范围内的需求,将每个需求恰好分配到一个任务包;对于按平台或仓库划分的场景,只有在每个上下文都独立验证完整义务时才允许重复同一需求 ID。
  • 将变更计划中的保留保证分配给所有可能违反该保证的任务包。
  • 为每个任务包生成固定结构,包含来源、范围、保留范围、不可更改项、受影响区域、验证、智能体指令、运行顺序、发现项和运行摘要。
  • 要求逐需求复制原文需求块和 Verify with: 行,并标注源快照标识;源发生实质变更后需重新切分。
  • 在并行前比较每对受影响区域,只有在无依赖、无文件读写交叉、不共享公共接口/模式/生成面、不触碰共享构建或 CI 配置时才允许并行。
  • 要求先完成接口定义类工作,并在每个任务包中写明完整运行顺序及本包的依赖位置。
  • 对缺失决策造成的实质性歧义,强制转为人工选择,并在选择前阻塞拆分。

使用方式

在明确请求拆分时,或在人工为 Suspec 产物选择任务包后进入。工具会通过原生选择器或编号选项加“其他”来提出必要问题,推荐项放在首位,提供三个真实选项(二元时两个),并附上简明理由和成本。

产物写入 ~/.agents/artifacts/<workspace>/ 的绝对路径下,其中 <workspace> 由仓库或工作目录基名推导。每个切片写一个任务包,附属文件与其管辖任务包放在一起。遇到命名冲突或工作区不明确时,提供人类可读的名称选项;写入受阻时,提供授权重试、更换用户目录或取消三种处理。不得覆盖,也不得回退到仓库、供应商目录或临时路径。

每个任务包以指定 frontmatter 开头,并包含以下章节:Source、Scope、Preservation scope、Do not change、Affected areas、Verify、Agent instructions、Run order、Findings、Run summary。

在交接前,需删除重复、软化、仪式性和结构膨胀内容,但不得改变契约、标识符、逐字源文本、证据或行为;重新运行适用的检查。输出时只返回每个任务和附属文件的可点击 Markdown 链接,使用紧凑的 ~/.agents/... 标签和完全展开的绝对目标路径。仅解释阻塞项、创建失败、验证不完整或不可逆操作确认。

适用场景

适用于需要将 Suspec 规格治理下的工作拆分为独立并行切片的场景,尤其是多平台或多仓库分别实现同一需求、或需要按变更计划分波次推进的转换工作。任务包仅用于可独立分派的并行切片、每个平台或仓库独立实现一个需求、或变更计划中可分别分派的转换波次;单一来源和单一实现者不构成任务包。

限制

  • 只能处理 status: ready 的规格;任何阻塞性决策都会终止分派。
  • 任务包大小本身不能证明拆分合理。
  • 存在未知范围时视为与一切冲突,不能并行。
  • 没有独立评审时,状态停留在 review-ready;只有发现项协调完毕且人工验收记录后才可关闭。
  • 无法确定的信息(如具体收费、价格、平台支持等)资料未提供。