用途:为 swain 项目提供任务跟踪与实现执行能力。当某个 SPEC 需要实施计划、用户询问下一步做什么,或需要实际执行工作时调用本技能。
主要能力:将其他技能(如 swain-design)用抽象术语表达的意图翻译为具体 CLI 命令;创建实施计划(tk create "Title" -t epic --external-ref <SPEC-ID>)和任务(tk create "Title" -t task --parent <epic-id>);建立依赖(tk dep <child> <parent>)、认领(tk claim <id>)、完成(tk add-note <id> "reason" 后 tk close <id>)等;支持状态查询(tk ready、ticket-query '.status == "open"')。
使用方式:操作前先检查活跃会话(bash "$REPO_ROOT/.agents/bin/swain-session-check.sh"),若状态非 active 则提示用 /swain-init 启动。首次使用前需阅读 references/tk-cheatsheet.md。任务创建必须带 --description;计划 epic 用 --external-ref SPEC-NNN 标注来源,子任务用 --tags spec:SPEC-NNN 关联。
适用场景:SPEC 实施计划与任务分解、跨会话的工作续接、查询未阻塞任务与进行中任务、识别计划与实际执行不一致时的对账。
限制:tk 仅接受 open、in_progress、closed 三种状态;协调层级产物(EPIC、VISION、JOURNEY)不直接跟踪;工单为临时执行脚手架,不作为归档证据。缺失事实:官方未提供的具体配置项、backend 切换细节等暂未提供。