tk-implement について
tk-implementは、リポジトリ内のReadyチケットを1件実装するスキルです。チケット条件と変更範囲を確認し、必要な検証やレビューを経て、成功時に限り1回のコミットと証跡を記録します。
主な機能
- 01Readyチケットの適格性確認
- 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 のチケットを正確に 1 件と、
<repository-root>/.tigerkit/implement.md の指示を読み取ります。入力がないか、ドキュメントが
存在しない場合は、Status: Unverifiable で停止します。
Pending、古い状態、系譜の不一致、未解決の model/effort の場合は、それぞれ正確に
Status: Blocked で停止し、変更・ステージング・commit・receipt を作成しません。
手順
- チケットの最新の系譜、正確な所有パス、
Scope、R/AC、Verification、記号化されたmodelとeffortがすべて解決済みであることを確認します。delegated実行の場合は、 worker の生成前にmodelを決定し、任意の.tigerkit/session.mdにあるホスト別ルーティングをskills/tk-drive/references/worker-dispatch.md#session-model-routingの定義済み スキーマに照らして検証し、general-purpose実装者向けの brief/report パスを準備します。 ルーティングがないか不完全な場合は、ネストされたクラスごとのmodel/effortの正確な Markdown 追記とrouting_state=decision-requiredを提案し、Status: Pendingで停止します。 承認画面には、モデルクラス、セレクター、努力レベル、ルーティング元がすべて必要です。 実装前にgit status --porcelain=v1と.tigerkit/implement.mdの存在およびバイト列をスナップショットし、ユーザー変更・インデックス・既存 receipt の既存バイト列をバイト単位で保持し、 成功した commit の後にのみ追記します。所有パス外は読み取りのみとします。 - 制限された低リスクの単独作業には
directを推奨し、リスク・範囲・隔離・新しい コンテキストが必要な場合はdelegatedを使用します。delegatedが必須の場合、directに黙って置き換えてはなりません。delegated実行で必須 worker を dispatch できない場合は、正確にStatus: Blockedで終了し、変更・ステージング・commit・receipt を作成または変更しません。general-purposelabel は意図された worker の役割であり、返された label から model/tier を 事後判定しません。directでは subagent を使わず、対象を絞った検査と自己レビューを行います。delegatedでは、新しいgeneral-purposereviewer がSpec complianceとTask qualityを 確認するまで、commit を成功として扱いません。 - 実装者は正確な所有パスのみを変更し、対象を絞った検査を最初に実行します。
delegatedの場合、またはユーザー/リポジトリのポリシーが独立したレビューを求める場合にのみ、 implementer 以上の capability を持つ reviewer がSpec/ACおよびStandards/Styleを検査します。すべてのdirect実行では、この reviewer を生成しません。verbatim またはスタイルの不一致はBlockingです。- 検証・レビューで gap が見つかった場合は、その都度、範囲を限定した新しい corrective worker で修正し、
再検証します。失敗した場合は
Status: Fail/Blockedで終了し、ステージング・commit・成功 receipt を作成しません。 - 必須の検証とレビューがすべて成功した場合にのみ、現在の
branchに正確に 1 件の commit を作成し、 その後implement.mdに unit/ticket、変更パス、check/review/gap の証拠、 commit/ancestry、delegated のmodel_class/requested_selector/realized_model/reasoning_effort/worker_id/receipt_source、unresolved: noneの receipt を追記します。 ホストが realized model を公開しない場合はunavailableとします。push、publish、他の workflow/skill の呼び出しは禁止です。
出力には receipt の絶対パスと Status: Pass/Status: Pending/Status: Blocked/Status: Fail/Status: Unverifiable のみを簡潔に記載します。receipt 内の証拠をチャットにコピーしません。
コメント
Markdown 対応