SuperAPI AI 工具集

execution-tracking

智能体与模型

查看项目

更新于 10-15 20:29

技能介绍

用途:作为智能体执行跟踪的抽象层,其他技能(如 spec-management)用抽象术语表达意图,本技能将其翻译为具体 CLI 命令,以外部任务管理工具 bd 作为执行跟踪的唯一事实来源,替代内置待办。

主要能力:接收 spec-management 基于四层跟踪模型(实现、协调、研究、参考)的交接;把实现计划、任务、来源引用、spec 标签、依赖、就绪工作、认领、完成、放弃、升级等抽象术语映射为 bd 命令;维护项目级配置;提供引导安装流程;支持从 superpowers 计划文件批量导入任务;提供“接下来做什么”流程与观察者模式状态视图。

使用方式:首次使用前阅读 references/bd-cheatsheet.md 获取完整命令语法、标志、ID 格式与反模式。配置存于 .agents/execution-tracking.vars.json,首次运行需询问 use_dolt、auto_prime、fallback_format 三项并写入,后续直接读取。引导流程包括检查 bd 可用性(command -v bd),缺失时 macOS 用 brew install beads、Linux 用 cargo install beads;检查 .beads/ 目录,缺失则 bd init;用 bd doctor --json 校验,出错可 bd doctor --fix;use_dolt 为真时 bd dolt start;auto_prime 为真时 bd prime。创建、更新、关闭均加 --json,创建时加 --description,任务标题简短且面向动作,交接笔记写入任务 notes,标签中引用相关工件 ID,禁止使用会打开编辑器的 bd edit。

适用场景:需要跨会话持久化、可查询、可观察的智能体任务跟踪;与 spec-management 配合完成规格到任务的分解;从 superpowers 计划文件导入任务(python3 scripts/ingest-plan.py <plan-file> <origin-ref>,可加 --dry-run 或 --labels)。

限制:bd 仅接受 open、in_progress、blocked、closed 四种状态,拒绝 todo、done 等别名;协调层工件(EPIC、VISION、JOURNEY)不直接跟踪,需先由 spec-management 分解;若 bd 无法安装或不可用,回退到 JSONL 或 Markdown 文本台账,沿用相同状态模型。其他未在资料中说明的细节暂未提供。