用途:task-tree 用于操作 superRA 的任务树,支持查询前沿(可调度的叶子任务)、DAG 与树视图,创建或重构任务、编辑状态、启动仪表盘,以及迁移旧版 PLAN.md/RESULTS.md 或升级 superRA v1 到 v2。
核心概念:./superRA 下每个含 task.md 的子目录即一个任务;叶子任务是没有含 task.md 子目录的目录。文件系统层级即任务层级,walk_plan() 通过扫描子目录发现子任务。依赖仅限同级,depends_on 取同一父目录下的兄弟目录名。父任务状态由子任务自动汇总:仅当所有活跃(非搁置)子任务均 approved 时父任务才 approved,归档与推迟的子任务不计入。依赖 DAG 决定执行顺序,目录名数字前缀(如 01-load、02-merge)仅决定显示顺序,两者相互独立。
使用方式:在新项目中先引导包装器,<skill-dir> 为包含 SKILL.md 的目录,需替换为真实路径:uv run --script <skill-dir>/scripts/cli.py wrapper init;随后刷新已有包装器(幂等):./superRA/superra wrapper init。之后统一使用已提交的 ./superRA/superra 包装器,例如:./superRA/superra task tree(带状态徽章的树)、./superRA/superra task frontier(可调度的叶子任务)、./superRA/superra task dag 01-data(子树的依赖 DAG,Mermaid)、./superRA/superra task tree --json(JSON 输出)、./superRA/superra dashboard --no-open(幂等,复用运行中的服务器或启动一个,打印 http://localhost:<port>)。仪表盘深链格式为 http://localhost:<port>/?wt=<worktree-basename>#/<task-path>,task-path 与 task read 的定位符相同(无 superRA/ 前缀,树根为空),必须带 ?wt=<worktree-basename>,因为一个仪表盘服务器按该参数服务仓库的所有 worktree。
任务文件格式:YAML front matter 含 title、status、depends_on,正文含 Objective、Results(Key Findings、Notes)、Review Notes 等段落。字段与段落归属详见 references/task-file-contract.md。
路由与限制:创建/重命名/链接/移动任务、批量状态传播、程序化追加结果见 references/commands.md;读取或解决任务评论见 references/commands.md §Comments;校验树结构、修复状态不一致、诊断孤立 depends_on 见 §Diagnostics;迁移与仪表盘机制见 references/internals.md。有意变更任务路径应使用 superra task move(同父级兼容用 task rename),不要用原始 mv/git mv,它会自动处理相对 Markdown 链接与同级 depends_on 边,无需手工改写链接或重连依赖。资料未提供具体收费、价格与平台信息。