用途:辅助创建、编辑 TAKT 的 tasks.yaml 条目与任务目录(.takt/tasks/{slug}/order.md),按 TaskRecord 模式生成 YAML 条目、编写 order.md 任务规格书,并校验状态流转规则。前提 takt 版本 v0.30.0。
主要能力:需求听证(任务内容、piece、是否 worktree 隔离、分支、auto_pr/draft_pr、GitHub Issue 号码);多任务时的并行执行策略设计(识别串行区间、共享资源冲突、一致性成本,给出 concurrency 建议);生成任务目录与 slug({YYYYMMDD}-{HHmmss}-{random6});生成 tasks.yaml 条目;验证 order.md 结构与状态流转。
使用方式:Step 1 听证需求;Step 2 多任务时设计并行策略(单任务跳过);Step 3 创建 .takt/tasks/{slug}/order.md,含 ## 目的、## 要件(- [ ] 清单)、## 受け入れ基準;Step 4 追加 tasks.yaml 条目,content、content_file、task_dir 只能指定其一;Step 5 校验。可运行 bash .agents/skills/takt-task/scripts/validate-order-md.sh 验证 order.md。编辑 .takt/pieces/*.yaml 时须运行 bash .agents/skills/takt-piece/scripts/validate-takt-files.sh --pieces。
限制:TAKT 任务间无依赖机制(无 depends_on),并行任务必须设 worktree: true;concurrency 是 takt run 全局设置,不能按任务指定;串行依赖需分多次 takt run。状态不允许 pending→completed、completed→pending 等,需重新建任务。