SuperAPI AI 工具集

cy-create-tasks

编程与开发

查看项目

更新于 10-16 03:17

技能介绍

用途:把需求文档分解为细粒度、可独立实施的任务文件,并通过代码库探索为任务补全实现细节。所在目录为 .compozy/tasks/<name>/。

必要输入:用于标识任务目录的功能名;该目录下至少有 _prd.md 或 _techspec.md。若两者都缺失,技能停止并提示先创建至少一个。

工作流:先加载类型注册表,读取 .compozy/config.toml;若含 [tasks].types 则以其为允许的类型值,否则使用内置默认值 frontend、backend、docs、test、infra、refactor、chore、bugfix。随后读取 _prd.md、_techspec.md 以及 adrs/ 下已有 ADR 以理解决策背景。缺少 TechSpec 时会发出警告,改为依据 PRD 功能需求与用户故事派生任务,并更依赖代码库探索来填写实现细节、相关文件与依赖文件,同时在任务中明确标注缺失的实现细节,而非臆造。

拆解规则:将 TechSpec 实现章节分解为可独立实施的任务;每个任务在依赖满足后可独立实施,不得需要未声明的工作;不允许循环依赖。每个任务含标题、类型、复杂度和依赖。复杂度标准为:low(单文件、无新接口、无并发)、medium(2-4 文件、可能引入接口或结构体)、high(5+ 文件、新子系统或较大重构、并发)、critical(跨包影响、回归风险高、需与其他任务协调)。直接对应或受 ADR 约束的任务需在相关 ADR 小节引用。测试要求嵌入每个任务,不单独建仅用于测试的任务。结构遵循 references/task-template.md,元数据见 references/task-context-schema.md。

生成与审批:先以标题、描述、复杂度、依赖链展示任务拆解,等待用户反馈并迭代,直至用户明确批准。之后写入 tasks.md 主任务表,以及 task_01.md 到 task_N.md 的独立任务文件(使用 task 前缀,无前导下划线)。任务文件以 YAML frontmatter 开头,含 status、title、type、complexity、dependencies,无依赖时写 dependencies: []。编号在 _tasks.md 与单文件中保持一致。

补全与校验:为每个任务文件检查是否已有 ## Overview、## Deliverables、## Tests,三者齐全则跳过补全。补全时映射 PRD 需求与 TechSpec 指引,调用 Agent 探索相关文件、依赖文件、集成点与项目规则,填写模板全部小节,包括概述、critical 块、requirements 块、3-7 条子任务、实现细节、相关文件、依赖文件、相关 ADR、交付物、测试与成功标准;复杂度过探索后若有变化则更新。单个任务补全失败时继续处理下一个,最后统一报告。完成后运行 compozy validate-tasks --name <feature>,非零退出则修复并重跑,直至退出码为 0。

反模式:避免超大型任务(超过 7 个文件或 7 个子任务应拆分);不得复制 TechSpec 的接口定义、代码片段或架构图,改为按小节名称引用;测试用例须具体描述输入、条件或行为,不得只写“测试正常路径”。

限制:具体安装方式、收费与平台支持等资料暂未提供。