SuperAPI AI 工具集

collaborative_task_design

编程与开发

查看项目

更新于 10-16 03:51

技能介绍

用途

Collaborative task design 用于把产品意图转化为可执行的工程工作。它的输出既不是 PRD,也不是补丁,而是产品意图与实现之间的桥梁。当你已有 PRD、技术规格、bug 描述或已确认的发现简报,并希望将其转成有序的实现任务时,可使用该技能。

主要能力

  • 将 PRD 转化为有序的工程任务。
  • 采用真实的多模型评审流程。
  • 应用规范驱动开发(spec driven development)、领域驱动设计、整洁架构与测试驱动开发等规则。
  • 按配置的面板阶段依次推进:architecture_mapping、test_strategy、task_slicing、dependency_review、convergence。
  • 将任务切分为垂直切片(tracer bullets),依据用户可见价值与架构接缝划分。
  • 识别可安全并行的工作,避免在未明确合并计划时并行处理同一文件、迁移、共享契约或安全敏感路径。
  • 产出支持红、绿、重构执行顺序的任务序列。

使用方式

在运行任何面板阶段之前,需先阅读共享脚手架文件 ../_shared/collaborative-panel-runner.md,其中包含输入、路由与可配置性、本地面板运行器与标志、原生响应助手、面板状态分类、完成门槛等内容。本技能文件仅保留任务设计特有的部分。

角色命名包括 synthesis_anchor、adversarial_anchor、architecture、testing、interface、backend、delivery。模型与角色的映射可在 assets/routing.toml 中编辑。产物与提示词位于 .codex_workflow/task_design 下。

在运行 architecture_mapping 和 task_slicing 之前,需阅读 references/engineering_rules.md,其中包含本技能应用的规范驱动开发、领域驱动设计、整洁架构与测试驱动开发规则。在编写阶段产物之前,需阅读 references/output_contract.md,其定义了每个产物必须包含的逐阶段存在性审计结构。

执行步骤:

  1. 阅读 PRD 与代码库适配产物。若不存在,则创建最小假设部分并标记缺失输入。
  2. 映射目标架构:识别领域层、应用用例、端口、适配器、基础设施、展示层、数据边界与依赖方向。
  3. 按顺序运行配置的面板阶段:architecture_mapping、test_strategy、task_slicing、dependency_review、convergence。
  4. 按用户可见价值与架构接缝将任务切分为垂直切片(tracer bullets)。避免过宽的任务(如“实现后端”)和过细的任务(如“重命名一个变量”),除非该变量是阻塞性的领域概念。
  5. 每个任务需包含:目标、可能触及的文件、先写的测试、实现说明、验收标准、验证命令、依赖、回滚说明、预期评审重点。
  6. 识别可安全并行的工作。
  7. 产出支持红、绿、重构执行顺序的任务序列。

除非用户明确要求仓库脚手架,否则不要在本技能中实现代码,也不要更改工作流产物目录之外的文件。

核心规则

每个阶段必须包含 synthesis anchor 与 adversarial anchor,且该阶段列出的每个角色都必须产生真实响应后,阶段才算完成。若某专家角色与当前计划无关,它仍需参与并说明为何没有实质性关切。

质量门槛

任务只有在另一个智能体无需重新解释产品需求即可执行时才就绪。每个任务必须有明确的测试优先入口点与有边界的 diff 表面。

必需输出

除非用户要求其他路径,在 .codex_workflow/task_design 下创建以下文件:

  • architecture_plan.md
  • tasks.md
  • test_plan.md
  • parallelization_plan.md
  • risk_register.md
  • decision_log.md
  • panel_summary.json

适用场景

适用于需要将规范、PRD 或 bug 描述转化为工程任务计划,并强调测试先行、架构映射与多模型评审的团队或工作流。

限制

本技能不实现代码,也不更改工作流产物目录之外的文件(除非用户明确要求仓库脚手架)。各角色与模型的映射、路由配置等具体细节暂未提供,需参考对应配置文件。