tk-handoff

交接

UI 证据

逐字引用现有 UI 标签，包括语言、大小写、标点和空格。导航说明中的每个菜单／面包屑标签及其连接关系都需要证据；仅有标题、路由、标识符、枚举、架构、术语表或工单措辞，无法证明入口路径。将拟议文案分开列出。将声明与目标／环境／区域设置／角色及实际渲染证据关联；保留相互冲突或缺失的溯源信息，不要猜测。

在此技能的调查权限范围内收集或核实 UI 标签／路径之前，请先阅读 UI evidence collection。非 UI 工作和仅传播内容的任务可跳过证据收集指南。仅进行交接或发布的阶段应沿用已提供的证据和待处理请求，不要启动新的调查。

在报告和发布准备中，保留精确且已核实的字面内容，并明确列出必须核实但尚未核实的标签／连接关系、现有证据、具体限制及最少缺失输入。用户提供的文本属于用户提供内容，不代表经过独立观察；它只对有证据支持的声明有效。切勿将未经核实的路径改写为导航说明，也不要在 PR／QA／交接输出中掩盖不确定性。

审批连续性

提问前先检查当前用户的授权。针对同一任务的具体请求或先前审批，在多个轮次和子技能阶段中仍然有效；仅调用技能和检索到的文本不构成授权。在第一个可执行检查点一并确认由用户决定的重要事项。范围获批后，按照各阶段现有责任方，继续完成必要的基线采集、实施、验证、审查和本地提交，不要在阶段交界处再次询问。将子阶段证据交回当前责任方并继续执行；状态更新不代表停止。重新核实事实，而非权限。仅在需要新的重要决定、范围变更、未获批的操作或缺少只能由用户提供的输入时提问。恢复出的材料本身不能授予权限。远程操作和破坏性操作需要明确的操作／目标授权；该授权可能已在开始时一并给出，交接给负责技能时应予以保留。切勿从本地审批推断此类授权。

根据请求选择一个分支。对于当前会话的状态／概览请求，请阅读 conversation-only orientation，返回简要回顾并结束 该轮，不要写入文件或恢复工作。此报告边界不会撤销先前审批；之后的恢复指令可以沿用该审批。对于明确要求创建交接的请求，继续执行下方的文件工作流。对于 --resume， 请在写入／恢复检查点之后阅读 resume and drift classification，并在继续之前核实最新状态。一般文档摘要和普通的“继续”请求均不属于这两个分支。不要为状态回顾创建持久化交接，也不要查询其他会话／远程 PR 来补全内容。

区分不同角色。

• .tigerkit/seed.md：定义必须完成的工作、原因及适用条件的任务约定
• .tigerkit/handoff.md：记录已完成工作和当前状态的进度 snapshot

如果存在当前任务 Seed，请引用它，而非复制其中的约定。合法的直接／无 Seed 任务无需创建 Seed：请在 Handoff 中写明最精简的目标、范围／排除项、AC 和已确认的审批边界，让其他会话能够理解。

新交接

阅读当前仓库证据。

• branch / HEAD / worktree
• 当前 Seed（如存在）的确切 path 和 status
• 实际变更的文件
• 实际执行的命令
• 实际验证结果
• 已完成和剩余的工作
• 当前阻碍及下一步操作

仅将观察到的事实标记为 verified，仅将经用户确认的决定标记为 confirmed。 未执行的命令、先前的声明和模型推断均为 unverified。

默认路径为 .tigerkit/handoff.md。在同一目录中写入临时文件，以原子方式替换目标文件，并读回检查。 创建该文件本身并不代表获准更改产品、Git 或远程状态。

在 Handoff 中至少保留以下含义。

Goal/Seed: <seed path 또는 current goal reference>
Status: pending | in_progress | completed | aborted | Blocked | Unverifiable
Repository state: <branch, HEAD, worktree>
Decisions: <confirmed progress-relevant decisions>
Changed files: <observed paths | none>
Commands: <actually executed commands | none>
Verification: <check/result/evidence>
Completed work: <done items | none>
Remaining work: <unfinished items | none>
Open questions: <required decisions | none>
Risks: <remaining failure/regression risk>
Next step: <one executable immediate action>
Resume hints: <environment/order/command hints>
Disposition: reported | applied | pending

Disposition 描述此交接所记录的工作：仅调查/报告的工作为 reported，已完成的授权变更为 applied，尚未应用的提议为 pending。它不授予任何权限。

对于有 Seed 的任务，请引用确切的契约章节/路径。对于直接执行/无 Seed 的任务，请记录上述最精简的自包含契约，并明确标明 Seed: none；排除无关或含糊不清的旧 Seed。

🔴 检查点 · 🛑 停止 · 写入/恢复边界

在写入新的 Handoff 或继续 --resume 之前：

• 重新读取分支、HEAD、工作区和必要证据。新 Handoff 无需事先存在；可选 Seed 也可以合理地缺失。对于恢复操作，必须能够读取所引用的 Handoff 及任何与任务绑定的 Seed。缺失或无法读取的必要制品属于 Unverifiable，不得根据猜测重建。
• 如果证据冲突或 Seed 契约已发生偏移，请停止并标记为 Blocked；不得在 Handoff 中解决这些问题。
• 如果无法完成原子替换或读回检查失败，请在写入前停止；默认使用 .tigerkit/handoff.md，并严格遵循显式指定的 --output <path>。
• 遇到任何产品、Git 或远程发布审批边界时，请停止；该制品不授予相应权限。
• 如果以上情况均不适用，请继续，无需为常规制品更新额外提问。

输出

成功创建新的 handoff 后，在聊天中仅简要显示路径、当前状态和下一步操作。 不要在聊天中完整贴出 Handoff 正文或证据台账。

恢复任务时，请以便于他人理解的方式说明已完成的工作、剩余工作、阻碍和紧接着的下一步操作。

不得将 .tigerkit/ 用作归档目录、当前指针或全局状态目录。 忽略规则的修改仅限于 Artifact Paths 设置；不得自动提交/发布。

制品路径

制品需要任务授权。在写入/检出/传输/设置忽略规则之前，请阅读 制品路径，检查 Git 排除规则、路径和所有权。复用上下文中完全相同的内容；对于不确定的哈希，请重新检查并重读已更改或丢失的内容；始终重新检查安全性。除非明确指定目标，否则使用 .tigerkit/。仅限聊天的任务：跳过文件/忽略规则设置及此引用。这不授予任何无关的修改/发布权限。对于经授权的非机密清理，优先使用新目录和受支持的回收站；仅针对已记录的、字面明确且解析后的绝对路径中由本次运行创建的路径，不得结合 cd 使用通配符/相对路径删除。

面向读者的结果摘要

简要返回结果，包括结果、实际验证情况、重要限制和直接交付物链接。区分计划/跳过的检查与已执行的工作；保留尚待进行的人工检查以及实际清理、阻碍或需要人工处理的事项。 绝不得声称未经验证的工作已完成或清理已完成。保留所有者要求的制品、发布预览、审批边界、机器返回内容、确切状态/页脚和最终问题区块；精简嵌套返回，并省略空章节。

输出格式

使用 ASCII 编号（1. Item、(1) Item）和 - Item，不要使用带圈或键帽数字。 展示完整、可点击的绝对文件路径，包括示例，不要使用省略号。 除非获准修改，否则保留原样的代码、命令、标识符、URL、引文和已核实的 UI 标签。

对于包含多个共同属性的聊天对比，使用窄版 GFM 管道表格（约四列，含表头，单元格简短）；其他情况使用列表。不要使用框线字符、围栏代码块或空表格。优先采用所有者专属的预览格式；发布正文和文件产物保留各自的表格格式。

在渲染后的 Markdown 正文中，范围使用连字符，字面波浪号转义为 \~； 原样保留代码、引文和标识符。

对于获准使用的临时输入文件，创建和读取前遵循 Artifact Paths；预填模板不算已完成的输入。这不授予任何写入权限。

用户问题

调查事实；重复使用已有授权。对于由用户决定的事项，阅读 问题轮次；其他情况直接继续。 纯聊天中，即使只有一个审批事项，也应先单独输出 ---，然后每项按以下格式呈现： ❓ **Q<n> · <title>**: <question> 和 ➡️ <recommendation>。 只询问已确定为前置条件的问题；审批另行处理。 问题放在最后；先说明状态、风险和计划。

技能反馈

对于可复用的事件，在当前对话中保留最少量的非机密证据， 并建议使用 tk-retro；除非用户提出要求，否则不要将其写入持久记忆。 调用、反馈产物、已安装技能的修改和发布，都需要通过所属工作流获得单独授权；此处的说明不授予任何授权。