to-tasks について
to-tasks は、確定した変更セットから作業を記録する開発スキルです。許可されたトラッカー向けにタスクを準備して公開内容を検証し、実装とは分離して管理します。
主な機能
- 01設定済みのトラッカーを選択
- 02作業を適切な単位に分割
- 03タスクの依存関係を管理
- 04公開前にタスクを準備
- 05公開済みタスクを検証
活用シーン
- 01承認済み変更セットのタスク化
- 02大規模作業を検証可能な単位に分割
- 03タスクトラッカーで依存関係を記録
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ venhdev/ skills --skill to-tasksインストール後、Claude Code で/to-tasksを入力して読み込まれたか確認します。
同梱ファイルreferences/issue-tracker-local.mdreferences/task-template.md
詳細
to-tasks — タスクの記録と条件付き分解
運用上の不変条件
- 記録範囲:タスクの定義と追跡メタデータのみを公開し、本番コードには手を加えず、提示された方針を維持します。
- トラッカーの選択:設定済みのトラッカーのみを使用します。設定がない場合はローカルの Markdown を既定で使用し、複数のトラッカーに公開しません。
- 承認の境界:ファイルやリモートのイシューに書き込む前に、具体的なタスクと公開先を提示します。既存の公開承認に従います。タスクの公開によって実装が承認されることはありません。
ドメインの基準
入力とタスクの規模
確定した変更セット、成果、受け入れ基準、制約、裏付けとなる証拠や参照情報を受け取ります。小規模な作業は1つのタスクとして記録します。中規模または大規模な作業は、独立して検証可能な単位、依存関係、または別々の実行セッションによって追跡が有用になる場合にのみ分割します。タスク数を増やすこと自体は目的ではありません。
分割した各タスクでは、完全な垂直的機能を実現し、それに対応する変更セットを担当します。依存関係は非循環にします。前提となるリファクタリングは必要な場合にのみ行います。大規模な移行では、任意の水平分割ではなく、拡張/移行/縮小の順序を維持します。
トラッカーと永続化
.agents/task-tracker.md を読み込んで、タスクを提示する前に公開先とそのネイティブな操作方法を確認します。ファイルがない場合は、.agents/tasks/<feature-slug>/ にローカルタスクを提示し、references/issue-tracker-local.md をコピーして .agents/task-tracker.md を作成します。この設定は、公開が承認されている場合にのみ書き込みます。既存のリモート設定が既定の設定より優先されます。リモートにアクセスできない場合はブロッカーとして扱い、黙ってトラッカーを切り替えてはいけません。
保存するタスクでは、リポジトリ相対の POSIX パスを使用します。ローカルタスクには、依存関係の順序で <NN>-<slug>.md を使用します。リモートタスクには、ネイティブな依存関係、または明示的な Blocked by ID を使用します。完了前に公開済みのタスクを再度読み込み、内容、識別子、依存関係を検証します。
状態とタスクのライフサイクル
STAGED:タスクの定義、件数、依存関係、公開先を確認でき、公開は保留中です。DONE:タスクが公開され、その存在と内容が検証済みです。実装は引き続き保留中です。UNRESOLVED:入力、トラッカーへのアクセス、または公開上の問題により、確実な記録ができません。部分的に公開した場合は、その旨と識別子を報告します。
保存する実装タスクでは、ready、in-progress、done を維持します。実行可能と見なされるには、状態が ready であり、すべての先行タスクが done である必要があります。ブロック状態は派生させるものであり、永続化するライフサイクル状態ではありません。このスキルの報告が DONE であっても、タスクを公開した後の状態は ready のままです。
正式な出力仕様
# Task Recording: <Feature> · <STAGED | DONE | UNRESOLVED>
Tracker: <Configured destination or local default.>
| Task | Scope / Acceptance | Blocked by | Destination |
| :--- | :--- | :--- | :--- |
| <ID> | <Complete deliverable and criterion> | <IDs or None> | <Path or issue link> |
<Why splitting is useful; omit when one task suffices.>
Gap: <Blocker or partial publication; omit if none.>
タスク本文を準備する際は references/task-template.md を読み込みます。各タスクの変更セットを埋め込み、後の実行に備えて証拠や制約を維持します。
振り分け
- 入力の変更セットに未解決の要件がある → (/clarify 経由)。
- 入力の方針が古くなっている、または再設計が必要 → (/architect-decision 経由)。
- 呼び出し元が、実行可能で別途承認済みのタスクの実装を依頼している → (/forge 経由)。
実行プロトコル
- 入力の変更セットを現在のコンテキストと照合します。方針が古くなっている、または未解決の場合は、タスクを捏造せず、相違点を報告します。
- トラッカーを特定し、タスクを1つにまとめるか、有用な単位に分割して
STAGEDとして提示します。具体的なタスクの範囲と公開先がすでに承認されていない限り、公開前に停止します。 - 設定された操作方法で公開し、保存された記録を検証して、
DONEまたはUNRESOLVEDを報告します。公開によって記録の依頼は完了しますが、実装には別途承認が必要です。