用途:tk-handoff 用于三类场景——简要确认当前会话现状、为其他会话创建交接资料、或显式恢复既有交接(--resume)。普通文档摘要与一般性“继续”请求不适用。
角色分工:.tigerkit/seed.md 是任务契约,说明要做什么、为何做、在什么条件下做;.tigerkit/handoff.md 是进度快照,记录已完成内容与当前状态。已有 Seed 时引用而非复制;无 Seed 的直接任务把最小目标、范围/排除项、验收标准与已确认的授权边界写进 Handoff 本身。
主要能力:新交接会读取当前仓库证据(分支/HEAD/worktree、Seed 的准确路径与状态、实际变更文件、实际执行过的命令、实际验证结果、已完成与剩余工作、当前阻碍与下一步),只把观察到的事实标为已验证,只把用户确认的决策标为已确认。默认写入路径为 .tigerkit/handoff.md,先写同目录临时文件再原子替换并回读。Handoff 需保留 Goal/Seed、Status、仓库状态、决策、变更文件、命令、验证、已完成、剩余、开放问题、风险、下一步、恢复提示、Disposition 等含义。
用法要点:创建成功后仅在聊天中简短显示路径、当前状态与下一步,不倾倒完整正文。恢复时用人易懂的方式说明已完成、剩余、阻碍与紧邻动作。写入或恢复前需重新读取分支、HEAD、worktree 与所需证据;证据冲突或 Seed 契约漂移时应标记 Blocked,而不是在 Handoff 内自行解决;原子替换失败或回读失败时停止写入。.tigerkit/ 不作为归档、当前指针或全局状态使用。
限制:创建该产物本身不授予修改产品、Git 或远程状态的权限;远程与破坏性操作需显式授权。UI 证据要求逐字引用既有标签,未验证的路径不得写成导航指令。授权检查先于提问,同一任务此前的批准跨轮次有效,但仅凭调用或检索文本不构成授权。输出标记使用 ASCII 编号,不使用 Unicode 带圈数字或键帽 emoji;表格用 GFM 管道表且列数宜少。发现可复用问题时只建议 tk-retro 复盘,不自动调用或修改已安装技能。以上资料未提供收费、价格、支持平台等信息。