SuperAPI AI 工具集

manage-taskboard

通用与其它

查看项目

更新于 10-15 17:34

技能介绍

用途:本技能面向本地优先的 Codex Taskboard 产品(含其配置的局域网与云服务),用于管理其中的项目、议题、关系与评论。仅当任务明确指向 Codex Taskboard,或对话已确立该范围时才适用;单纯的议题标识、仓库或“管理任务、同步状态、添加评论”类泛化请求不足以确立范围。面向 GitHub、Phabricator 等外部跟踪系统时应使用对应工具,除非用户明确要求做看板操作。目标不明确时先澄清再运行 taskctl。

主要能力:在范围内,所有项目、议题、关系与评论操作均通过 taskctl 完成,并消费其 JSON 输出。使用看板返回或提示中给出的精确议题标识,不得假设、推导或改写标识前缀。需要命令语法时只打开 references/cli.md 的相关章节。

使用方式:使用任务或注入运行时提供的精确 taskctl 二进制与 Taskboard URL,不要替换为全局 CLI、默认端口或其它看板。Windows 上未注入二进制且已安装桌面应用时,可用 & "$env:LOCALAPPDATA\Codex Taskboard\bin\taskctl.cmd" issue get ID --json;若该打包路径不存在,应停止并询问实际的 taskctl.cmd 路径。macOS 用 '/Applications/Codex Taskboard.app/Contents/Resources/bin/taskctl' issue get ID --json(保留单引号)。Linux 上当 Codex 由桌面应用启动时用 taskctl issue get ID --json。若命令因沙箱限制无法访问环回服务,应以相同命令申请所需权限重试,不要切换二进制或端点。

核心流程:对已有议题先运行 issue get 和 comment list,并运行 attachment list --task;首次交接省略 --after 读取完整结果,分别保存各自的 nextCursor。恢复同一任务时重跑 issue get,再用 --after 传入各游标获取新增或变更条目。评论列表包含所返回评论的附件。阅读描述与最新评论后再决定是否开始。backlog 视为未批准执行,未获明确授权不得认领或改变状态。可开始时先认领再读代码或分析。用当前版本把可认领的 todo 移到 in_progress,移动成功前不要继续。版本冲突时重跑 issue get 与 comment list,仅在仍为可认领 todo、未绑定其它会话、未归档且描述与最新评论未变时用最新版本重试一次。

绑定与状态:当前会话认领或继续的议题必须存储完整 threadBinding(threadId、codexProjectId、codexProjectKind、codexHostId、workspacePath),认领及后续保留所有权的移动都要传入五个显式 --binding-* 选项;身份字段缺失时应停止。已有完整绑定时按其保存值原样保留。新持久需求先运行 context current。完成后添加评论说明变更、验证结果与剩余风险,再移到 in_review;仅当用户明确接受或要求完成时才移到 done。

术语:“local companion”指用于云模式的设备本地环回服务,中文可保留英文或写作本地 companion、本地配套服务、环回代理,不可译为“伴侣”。普通任务、评论、附件 HTTP 路由属于 Taskboard HTTP API,不是 companion API。

限制:仅执行议题分支或工作树中绑定的工作;不得在 Taskboard 中镜像外部跟踪系统议题,除非用户要求。部分运行时细节(如其它命令的具体参数)暂未提供。