SuperAPI AI 工具集

takt-task-builder

通用与其它

查看项目

更新于 10-15 22:39

技能介绍

用途:辅助创建与编辑 TAKT 的 tasks.yaml 条目及任务目录(.takt/tasks/{slug}/order.md),生成符合 TaskRecord 架构的 YAML 条目、编写 order.md 任务规格书,并校验状态迁移规则。前提为 takt v0.47.0。

主要能力:按流程先做需求访谈(任务内容、workflow、worktree 隔离、分支、auto_pr/draft_pr、Issue 编号);多任务时设计并行执行策略,分析直列区间、共享资源竞争与整合性成本,给出任务分割/合并判断与推荐 concurrency;生成 slug(YYYYMMDD-HHmmss-随机6位)与任务目录;生成 tasks.yaml 条目(最小/完整/legacy content 形式);执行验证。

使用方式:在 .takt/tasks.yaml 追加任务记录,不存在时以 tasks: [] 初始化。content、content_file、task_dir 三者必须且只能指定一个,推荐 task_dir。order.md 模板含目的、需求(- [ ] 复选框)、验收标准、参考信息,模板变量由引擎自动注入。可用同捆脚本校验 order.md 结构:bash <技能目录>/scripts/validate-order-md.sh。若编辑了 .takt/workflows/*.yaml,需运行 takt-workflow-builder 的 bash <其目录>/scripts/validate-takt-files.sh --workflows,并确认 loop monitor 的 next 与 cycle 首节点一致、{report:...} 仅引用 cycle 内 step 产物,否则不得置为 completed。

适用场景:TAKT 任务元数据与任务规格书的创建、编辑与校验,含并行任务拆分与状态迁移检查。

限制:并行任务间无 depends_on 等依赖机制,无实时同步,各任务基于克隆时快照工作;并行任务必须设 worktree: true;concurrency 为 takt run 全局设置,不能按任务指定,需分段执行时须多次运行 takt run。状态迁移有严格约束:pending→completed、completed/exceeded/pr_failed→pending 均不允许,需新建任务。其余细节暂未提供。