SuperAPI AI 工具集

task-forest

办公与效率

查看项目

更新于 10-15 21:12

技能介绍

用途:维护当前工作区的任务结构、提案、历史与进度,并产出一份首次阅读者无需打开其他任务清单或内部文件即可理解的独立 HTML 交付物。任务内容、提案、报告与 HTML 使用用户语言,未知时默认中文。

主要能力:通过脚本读写任务森林数据,支持 init、list --json、todo --json、proposal-save、proposal-apply、validate、export 等命令;每个节点使用一个主 child_of 父级,contributes_to 表示次要归属,depends_on 表示前置依赖;图变更先保存为提案,用户确认后才执行 proposal-apply --yes;导出 exports/task-forest.html,展示 done、in_progress 及其必要 child_of 祖先,并支持历史回放。

使用方式:将整个 task-forest 目录安装到宿主支持的技能位置,从包含 SKILL.md 的目录解析脚本、引用与资源;使用可用的 Python 3 启动器(python3、python 或 py -3)。示例命令:python3 <skill-dir>/scripts/task_forest.py init;python3 <skill-dir>/scripts/task_forest.py list --json;python3 <skill-dir>/scripts/task_forest.py todo --json;python3 <skill-dir>/scripts/task_forest.py proposal-save --proposal-file /path/to/proposal.json;python3 <skill-dir>/scripts/task_forest.py proposal-apply <proposal-id> --yes;python3 <skill-dir>/scripts/task_forest.py validate;python3 <skill-dir>/scripts/task_forest.py export。默认工作区为当前目录,仅在明确指定其他工作区时使用 --workspace,仅在调用方明确选择非默认根时使用 --root。

适用场景:需要维护仓库本地任务 DAG、保留目标到阶段到模块到具体任务的层级与同级顺序、为 done 或 in_progress 任务保留必要祖先、将额外修复挂到其改进的功能下,并生成只读 HTML 视图时。

限制:只能通过 scripts/task_forest.py 读写数据,不得手工编辑 .agent-workbench/task-forest/ 下的规范文件;HTML 交互保持只读,正式变更必须走提案流程;HTML 不暴露内部讨论、证据、队列、文件系统路径、会话或提案内容;任务数据与发现元数据默认仓库本地,跨工作区发现需用户显式设置 TASK_FOREST_ENABLE_GLOBAL_REGISTRY=1 才启用,且不存储任务内容;全局注册表集成默认关闭,TASK_FOREST_DISABLE_GLOBAL_REGISTRY=1 可显式覆盖。