SuperAPI AI 工具集

tsk-cli

通用与其它

查看项目

更新于 10-16 09:29

技能介绍

tsk 是用户的任务板。任务有人类可读状态(open · ready · started · blocked · review · done),归属 desk(无项目)或某个项目(Git 仓库根目录,以 basename 命名),并可带 thread 标签。用户通过 TUI 查看看板,助手不打开它,所有读写都经 CLI 完成。可用 tsk --help 查语法;会话中首次使用某命令前先运行 tsk help <command>。若 tsk 未安装(tsk --version 不可用),把 https://gettsk.sh/docs/install.md 给用户并停止,除非用户要求,绝不自行运行安装器或构建。

读用 tsk list --json 并配合 --ready、--open、--all、--desk、-p <project>、--done、--archived、--deleted 等;查单任务用 tsk list T12 --json。T12、t12、12 与 UUID 等价,优先用 T12。

状态属于用户:你的工作完成后置为 review;只有用户说完成或要求关闭才置 done,绝不能按自己的进度标 done。项目名需可唯一解析,未知或有歧义会拒绝;创建新项目只能用已存在的绝对目录。tsk edit 不能移动任务,需在正确范围重新添加并归档游离任务。

始终给 tsk list 加 --json,人类输出仅供展示或排错。未被要求时绝不传 --state-dir。忽略看板中 N1… 之类的通知行。以 - 开头的值需用 = 形式,如 --title="-fix parser"。

退出码:0 成功或已为真;1 部分条目被拒(只重试被拒子集);2 用法或解析错误(未持久化);3 存储 I/O 不确定。不要盲目重试:add、status、edit、archive 幂等,steps toggle/remove 非幂等,重试前先 tsk list T12 --json。

可批量抓取:cat plan.json | tsk add,仅 title 必填。精炼任务时先提出改写并获用户同意再写入;edit --notes 会整体替换正文。任务标题动词开头、约 60 字符内。不要在未被要求时开始构建或提供构建方案。