mcpField
T
tk-implement

tk-implement

github.com/mtgvim開発192 回インストール1 日前に更新
リポジトリ

tk-implement について

tk-implementは、リポジトリ内のReadyチケットを1件実装するスキルです。チケット条件と変更範囲を確認し、必要な検証やレビューを経て、成功時に限り1回のコミットと証跡を記録します。

主な機能

  1. 01Readyチケットの適格性確認
  2. 02指定範囲内での実装
  3. 03直接または委任での実行
  4. 04検証と必要に応じたレビュー
  5. 05コミットと証跡の記録

活用シーン

  1. 01確認済みReadyチケットの実装
  2. 02前提条件が未達の場合の安全な停止
  3. 03検証結果とコミット証跡の記録

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/mtgvim/tiger-kit --skill tk-implement

インストール後、Claude Code で/tk-implementを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
evals/
evals.json
triggers.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 を作成しません。

手順

  1. チケットの最新の系譜、正確な所有パス、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 の後にのみ追記します。所有パス外は読み取りのみとします。
  2. 制限された低リスクの単独作業には direct を推奨し、リスク・範囲・隔離・新しい コンテキストが必要な場合は delegated を使用します。delegated が必須の場合、 direct に黙って置き換えてはなりません。delegated 実行で必須 worker を dispatch できない場合は、正確に Status: Blocked で終了し、変更・ステージング・commit・receipt を作成または変更しません。 general-purpose label は意図された worker の役割であり、返された label から model/tier を 事後判定しません。direct では subagent を使わず、対象を絞った検査と自己レビューを行います。 delegated では、新しい general-purpose reviewer が Spec compliance と Task quality を 確認するまで、commit を成功として扱いません。
  3. 実装者は正確な所有パスのみを変更し、対象を絞った検査を最初に実行します。
  4. delegated の場合、またはユーザー/リポジトリのポリシーが独立したレビューを求める場合にのみ、 implementer 以上の capability を持つ reviewer が Spec/AC および Standards/Style を検査します。すべての direct 実行では、この reviewer を生成しません。verbatim またはスタイルの不一致は Blocking です。
  5. 検証・レビューで gap が見つかった場合は、その都度、範囲を限定した新しい corrective worker で修正し、 再検証します。失敗した場合は Status: Fail/Blocked で終了し、ステージング・commit・成功 receipt を作成しません。
  6. 必須の検証とレビューがすべて成功した場合にのみ、現在の 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 内の証拠をチャットにコピーしません。

コメント