mcpField
T
track-tasks

track-tasks

github.com/venhdevエージェントワークフロー110 回インストール今日更新
リポジトリ

track-tasks について

track-tasksは、設定済みのローカルまたはリモートのトラッカーにタスクを記録し、ライフサイクルを同期するスキルです。重複を避け、依存関係に応じた状態を管理し、保存後に記録を確認します。プロダクションコードは変更しません。

主な機能

  1. 01設定済みトラッカーの判別
  2. 02依存関係に基づくタスク状態管理
  3. 03作成前の重複確認
  4. 04書き込み後の記録検証
  5. 05受け入れ条件と検証手順の記載

活用シーン

  1. 01タスク分解結果のトラッカーへの保存
  2. 02依存関係に沿ったタスク状態の同期
  3. 03新規タスク記録の保存確認

インストール

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

$npx skills add https://github.com/venhdev/skills --skill track-tasks

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

同梱ファイルreferences/issue-tracker-local.mdreferences/task-template.md

詳細

track-tasks — タスクの永続化とライフサイクルの同期

運用上の不変条件

  • ストレージの限定：タスクレコードの変更は、.agents/task-tracker.md で設定されたトラッカー（ローカル Markdown .agents/tasks/、GitHub Issues、GitLab、Linear）のみで行い、本番コードには決して触れないでください。
  • 状態の整合性：正規の状態 ready、in-progress、done を維持します。blocked は前提タスクに基づく派生状態として扱います。先行する依存タスクがすべて done の場合にのみ、タスクを ready とします。
  • 冪等な同期：作成前に既存の課題やファイルを確認し、書き込み後に再読み込みして、ID と永続化を確認します。
  • 自己完結したペイロード：受け入れ条件、検証コマンド、インラインの証拠をタスク本文に埋め込み、サブエージェントがローカルの一時ファイルに依存せず独立して実行できるようにします。
  • 完了時の削除：すべてのタスクが done になり、検証されたら、.agents/tasks/<feature-slug>/ を削除します（またはリモートのチケットをクローズします）。
  • 呼び出し出力の適応：人間向けに永続化の概要表を表示し、自律型ランナー向けには簡潔なマイクロトークンを出力します。

ドメイン基準

1. トラッカーの解決

.agents/task-tracker.md を読み込みます。存在しない場合は、.agents/tasks/<feature-slug>/ の下に <NN>-<slug>.md という命名規則でローカル Markdown ストレージを準備します（references/issue-tracker-local.md を参照）。認証済みの CLI アクセスが確認できる場合は、リモートトラッキング（gh、glab、Linear）を優先します。タスク本文の形式は、references/task-template.md に従います。

2. 状態とタスクのライフサイクル遷移
  • STAGED：タスクが分割され、永続化の承認を得る準備ができています。
  • DONE：トラッカーストレージへのタスクの永続化が確認されています。実装はまだ保留中です。
  • UNRESOLVED：トラッカーとの通信に失敗したか、承認が不足しています。

正規の出力仕様

# Task Persistence: <Feature / Scope> · <STAGED | DONE | UNRESOLVED>

Tracker Backend: <Local Markdown | GitHub | GitLab | Linear>
Target Collection: <Path or Project Name>

| Slice ID | System Ref | Persisted Status | Blocked By | Verification Checksum |
| :--- | :--- | :--- | :--- | :--- |
| S-01 | .agents/tasks/auth/01-token.md (#102) | ready | None | <hash or pass> |
| S-02 | .agents/tasks/auth/02-refresh.md (#103) | ready (blocked) | S-01 | PENDING |

Sync Delta: <C> created, <U> updated, <D> unchanged.
*(omit if clean)* Gap: <Tracker communication failure or missing credentials.>

自律型マイクロトークン仕様：

SYNCED | tracker: <backend> | created: <C> | updated: <U> | ready: <ID>
振り分け
  • 永続化が確認され、対象タスクの即時実装が承認されている →（/forge 経由）。
  • 要件の矛盾により信頼できる記録ができない →（/clarify 経由）。
  • トラッカーの認証情報がない、またはサービスに到達できない → UNRESOLVED を報告します。

実行プロトコル

  1. .agents/task-tracker.md を読み込み、アクティブな永続化先を特定します。
  2. /split-tasks または呼び出し元から Task DAG マニフェストを取り込みます。
  3. タスクの重複チケットを避けるため、既存のタスクを確認します。
  4. タスクファイルを書き込むか、トラッカー API を呼び出し、検証コマンドと親タスクの由来情報を埋め込みます。
  5. 保存されたタスクを再読み込みして永続化を確認し、Markdown テーブルまたは自律型マイクロトークンを出力します。

コメント

Markdown 対応