tk-handoff

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Handoff

Apply this skill to explicit requests to create or resume a

handoff

. Do not auto-apply it to general summaries, status questions, or ordinary “continue” requests.

Keep the roles separate.

```
.tigerkit/seed.md
```
: the task contract defining what must be done, why, and under which conditions
```
.tigerkit/handoff.md
```
: the progress
```
snapshot
```
recording what has been done and the current state

Handoff

neither replaces nor copies the

Seed

仅在收到创建或恢复

handoff

的明确请求时应用此技能。请勿自动将其应用于常规总结、状态查询或普通的“继续”请求。

保持角色区分：

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

Handoff

既不替代也不复制

Seed

。

New handoff

新建handoff

Read the current repository evidence.

```
branch
```
/
```
HEAD
```
/
```
worktree
```
the exact
```
path
```
and
```
status
```
of the current
```
Seed
```
, if present
actual changed files
commands actually executed
actual verification results
completed and remaining work
current blockers and next action

Mark only observed facts as

verified

and only decisions confirmed with the user as

confirmed

. Commands not executed, prior claims, and model inferences are

unverified

The default path is

.tigerkit/handoff.md

. Write to a temporary file in the same directory, atomically replace the target, and read it back. Creating the artifact itself does not grant permission to change the product, Git, or remote state.

Preserve at least the following meaning in the Handoff.

text

Goal/Seed: <seed path 또는 current goal reference>
Status: pending | in_progress | completed | aborted | Blocked
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

Do not copy the

Seed

’s

goal/scope/AC/implementation guidance

into the

Handoff

. When needed, reference the exact

Seed

section/path

读取当前仓库的证据：

```
branch
```
/
```
HEAD
```
/
```
worktree
```
当前
```
Seed
```
（若存在）的确切
```
path
```
和
```
status
```
实际已更改的文件
实际执行的命令
实际验证结果
已完成和剩余的工作
当前障碍与下一步行动

仅将观察到的事实标记为

verified

，仅将与用户确认的决策标记为

confirmed

。未执行的命令、先前的声明及模型推断均为

unverified

。

默认路径为

.tigerkit/handoff.md

。在同一目录下写入临时文件，以原子方式替换目标文件，然后重新读取。创建此工件本身并不允许修改产品、Git或远程状态。

在Handoff中至少保留以下信息：

text

目标/Seed: <seed路径或当前目标引用>
状态: pending | in_progress | completed | aborted | Blocked
仓库状态: <branch, HEAD, worktree>
决策: <已确认的与进展相关的决策>
已更改文件: <观察到的路径 | none>
命令: <实际执行的命令 | none>
验证: <检查/结果/证据>
已完成工作: <已完成项 | none>
剩余工作: <未完成项 | none>
待解决问题: <所需决策 | none>
风险: <剩余的失败/回归风险>
下一步: <一个可执行的即时操作>
恢复提示: <环境/顺序/命令提示>
处置状态: reported | applied | pending

请勿将

Seed

的

目标/范围/验收标准/实施指南

复制到

Handoff

中。必要时，引用

Seed

的确切

章节/路径

。

🔴 CHECKPOINT · 🛑 STOP · Write/Resume Boundary

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

Before writing a new

Handoff

or continuing a

--resume

STOP and report
```
Unverifiable
```
when the current
```
Seed
```
,
```
Handoff
```
, branch,
```
HEAD
```
, worktree, or required verification cannot be fresh-read.
STOP and mark
```
Blocked
```
when evidence conflicts or the
```
Seed
```
contract has drifted; do not resolve either condition inside the
```
Handoff
```
.
STOP before writing if atomic replacement cannot be completed or readback fails; use
```
.tigerkit/handoff.md
```
by default and honor an explicit
```
--output <path>
```
exactly.
STOP at any product, Git, or remote publication approval boundary; the artifact does not grant that permission.
If none of these conditions applies, continue without asking an extra question for a routine artifact update.

在编写新

Handoff

或执行

--resume

恢复操作前：

当无法读取最新的当前
```
Seed
```
、
```
Handoff
```
、分支、
```
HEAD
```
、工作区或所需验证信息时，停止操作并报告
```
Unverifiable
```
。
当证据冲突或
```
Seed
```
契约发生偏离时，停止操作并标记为
```
Blocked
```
；请勿在
```
Handoff
```
内部解决这两种情况。
若无法完成原子替换或回读失败，请勿编写；默认使用
```
.tigerkit/handoff.md
```
，并严格遵循显式指定的
```
--output <path>
```
路径。
在任何产品、Git或远程发布审批边界处停止；此工件不授予该权限。
若不存在上述任何情况，则无需额外询问，直接进行常规工件更新。

Resume

恢复

--resume

requests resuming work by comparing the

handoff snapshot

against the current Git and files.

First, fresh-read:

the current
```
Seed
```
and
```
handoff
```
```
branch
```
/
```
HEAD
```
/
```
worktree
```
changed files
relevant verification evidence
current remote state, if a
```
PR
```
exists

Then classify drift.

Classification	Action
None	Continue from `Next step` without additional questions
Nonessential `drift`	Record it and continue
Significant progress `drift`	Update the `Handoff` from current evidence and confirm only the necessary decisions
`Seed` contract `drift`	Do not resolve it in the `Handoff` ; report that re-entering `tk-prep` is required
Conflict	Show the incompatible evidence and mark `Blocked`
unverified	If the required state cannot be confirmed, mark `Unverifiable`

--resume

may authorize continuing the work, but it does not replace approval to change the

Seed

’s

goal/scope/decision/AC

or permission to publish remotely.

--resume

请求通过对比

handoff snapshot

与当前Git及文件状态来恢复工作。

首先，读取最新信息：

当前
```
Seed
```
和
```
handoff
```
```
branch
```
/
```
HEAD
```
/
```
worktree
```
已更改文件
相关验证证据
当前远程状态（若存在
```
PR
```
）

然后对偏离情况进行分类：

分类	操作
无偏离	直接从 `下一步` 继续，无需额外询问
非关键 `drift`	记录偏离情况后继续
重大进展 `drift`	根据当前证据更新 `Handoff` ，仅确认必要的决策
`Seed` 契约 `drift`	请勿在 `Handoff` 中解决；报告需要重新进入 `tk-prep` 流程
冲突	显示不兼容的证据并标记为 `Blocked`
未验证	若无法确认所需状态，标记为 `Unverifiable`

--resume

可能授权继续工作，但不替代修改

Seed

的

目标/范围/决策/验收标准

的许可或远程发布的权限。

Output

输出

After successfully creating a new

handoff

, show only the path, current status, and next action briefly in chat. Do not dump the full

Handoff

body or evidence ledger.

When resuming, explain completed work, remaining work, blockers, and the immediate next action in a way that is easy for a person to understand.

Do not use

.tigerkit/

as an archive, current pointer, or global state. Do not modify

.gitignore

or automatically commit/publish.

成功创建新的handoff后，仅在聊天中简要显示路径、当前状态和下一步行动。请勿输出完整的

Handoff

内容或证据记录。

恢复工作时，以易于理解的方式解释已完成工作、剩余工作、障碍及即时下一步行动。

请勿将

.tigerkit/

用作存档、当前指针或全局状态。请勿修改

.gitignore

或自动提交/发布。