task-planner

タスクプランナー

このスキルを使うと、曖昧な依頼や大規模な依頼を、担当者と検証方法が明確な、順序立てた計画にまとめられます。

作成する成果物

• 簡潔な問題の説明
• 前提条件と未解決の質問
• 測定可能な成果を含む段階的な計画
• リスクとロールバック／封じ込めの選択肢
• テストと検証の手順

分解の手法

作業を小さな垂直スライスに分割します。

• 各スライスは単独でマージできるようにします
• 各スライスにテストまたは検証を含めます
• 不確実性を減らせる最小単位を優先します

一般的なスライスの種類：

• 仕様テスト（要件、CLI フラグ、エッジケースを確定する）
• 実装の変更（小規模で分離されたもの）
• ドキュメントの更新
• 可観測性とトレーサビリティの改善

依存関係と優先順位のルール

• まずブロッカー（不足している API、失敗するテスト、権限）を特定します。
• 「他の作業を可能にすること」と「不確実性を減らすこと」を基準に順序を決めます。
• 複数のエージェントで作業する場合は、インターフェースを安定させ、スライスごとに入出力の契約を定義します。

複数エージェントへの割り当て

作業を委任する際は、次の内容を指定します。

• 具体的な成果物（ファイル、テスト、出力形式）
• 制約（コミットの禁止、ブランチの制約、時間制限）
• 受け入れテスト（合格必須の項目）

委任メッセージの例：

Please write tests for <feature>.
Constraints:
- Do not change implementation yet
- Use pytest
Acceptance:
- Tests fail before implementation
- Tests cover edge cases: <...>

計画の出力

Plan Card の出力（Canvas）

Mermaid の DAG による可視化とステップごとのステータス追跡を含む視覚的な計画では、 Canvas に Plan Card を投稿します。

# Post plan card with Mermaid DAG and step list
synapse canvas plan '{"plan_id":"plan-auth","status":"proposed","mermaid":"graph TD; A[Tests]-->B[Impl]-->C[Review]","steps":[{"id":"s1","subject":"Write auth tests","agent":"Tester","status":"pending"},{"id":"s2","subject":"Implement auth","agent":"Impl","status":"pending","blocked_by":["s1"]},{"id":"s3","subject":"Review","agent":"Tester","status":"pending","blocked_by":["s2"]}]}' --title "Auth Plan"

分解した計画をチームの Canvas ダッシュボードで可視化する場合に、Plan Card が役立ちます。 DAG による可視化が有用な、3 ステップ以上または複雑な依存関係を含む計画に使用します。

個人の細かなステップ管理用 TodoList

1 つのタスク内で自分の細かなステップを追跡するには、TodoList を使用します。 TodoList の項目は細分化し、コーディングの各ステップにつき 1 項目にします。

• <動作>の失敗するテストを追加する
• テストを通過するように<動作>を実装する
• 対象を絞ったテストを実行する
• ドキュメントを更新する
• テストスイート全体を実行する

進捗の報告

すべての連絡で、明確なステータスを報告します。

• 完了： "認証テストの作成が完了 — 4 件のテストが合格"
• 次の作業： "認証モジュールの実装を開始。テストの確認済み"
• ブロック中： "統合テストは待機中 — 実装がまだ完了していません"