关于 tk-implement
tk-implement 是用于实现仓库中一个 Ready 工单的技能。它检查工单条件、限制修改范围,并按要求验证、审查,最后仅在成功时提交一次并记录凭据。
主要功能
- 01检查 Ready 工单资格
- 02仅修改指定范围
- 03直接或委派执行
- 04验证及按需审查
- 05提交并记录证据凭据
适用场景
- 01实现已核实的 Ready 工单
- 02前置条件受阻时安全停止
- 03记录检查结果与提交证据
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ mtgvim/ tiger-kit --skill tk-implement安装后在 Claude Code 中输入/tk-implement确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlevals/evals.jsontriggers.json详细介绍
实现 Ready 工单
仅在明确选择 /tk-implement 或 $tk-implement 时执行。
使用 git rev-parse --show-toplevel 确认当前检出的仓库根目录,然后读取
<repository-root>/.tigerkit/tickets.md 中恰好一个 Status: Ready 工单,以及
<repository-root>/.tigerkit/implement.md 中的指示。若没有输入或文档不存在,
则以 Status: Unverifiable 停止。
若状态为 Pending、状态过时、谱系不匹配,或 model/effort 未解决,则分别以
Status: Blocked 精确停止;不得创建更改、暂存内容、commit 或 receipt。
流程
- 确认工单的最新谱系、准确的所有权路径、
Scope、R/AC、Verification、符号化的model和effort均已解决。若为delegated执行,则在创建 worker 前确定model,并按照skills/tk-drive/references/worker-dispatch.md#session-model-routing中规定的 schema 验证可选的.tigerkit/session.md主机路由,为general-purpose实现者 准备 brief/report 路径。若路由缺失或不完整,则提议按嵌套类别精确添加model/effortMarkdown,并设置routing_state=decision-required,然后以Status: Pending停止。审批界面必须包含模型类别、选择器、努力程度和路由来源。 实施前,快照git status --porcelain=v1以及.tigerkit/implement.md的存在状态和字节内容;以字节为单位保留用户更改、索引和现有 receipt 的原始字节,并且仅在成功 commit 后追加内容。所有权路径之外的内容只能读取。 - 对受限的低风险独立任务,建议使用
direct;若需要风险控制、范围隔离或新上下文,则使用delegated。若必须使用delegated,不得悄然改用direct。任何delegated执行若无法调度必需的 worker,则以Status: Blocked精确结束,不得创建或修改更改、暂存内容、commit 或 receipt。general-purposelabel 表示预期的 worker 角色;不得根据返回的 label 事后判断 model/tier。direct使用集中检查和自我审查,不使用 subagent。只有新的general-purposereviewer 确认Spec compliance和Task quality后,delegated才能将 commit 视为成功。 - 实现者仅修改准确的所有权路径,并优先运行针对性检查。
- 仅在
delegated执行,或用户/仓库策略要求独立审查时,才由能力高于 implementer 的 reviewer 检查Spec/AC和Standards/Style。所有direct执行均不得创建此 reviewer。逐字内容或风格不一致均属Blocking。 - 若验证或审查发现差距,则每次都由新的、范围受限的 corrective worker 进行修正,并重新验证。若失败,则以
Status: Fail/Blocked结束,不得暂存、commit 或创建成功的 receipt。 - 仅当所有必需的验证和审查均成功时,才在当前
branch上创建且只创建一个 commit;之后向implement.md追加 receipt,包含 unit/ticket、changed paths、check/review/gap evidence、commit/ancestry、delegatedmodel_class/requested_selector/realized_model/reasoning_effort/worker_id/receipt_source,以及unresolved: none。若主机未公开 realized model,则填写unavailable。禁止 push、publish 或调用其他 workflow/skill。
输出仅简洁报告 receipt 的绝对路径,以及 Status: Pass/Status: Pending/Status: Blocked/Status: Fail/Status: Unverifiable。不要将 receipt 中的证据复制到聊天中。
评论
支持 Markdown