task-breakdown

作業のタスク分解

概要

仕様を実装する担当者が、プロジェクトについてまったく背景知識がなく、好みもあまりよくないと想定して、包括的なタスク分解を作成してください。担当者が知っておくべきことをすべて記述します。確認すべき既存ファイル、各タスクで変更するファイルとその変更内容を明記してください。計画全体を、取り組みやすい小さなタスクに分けます。DRY。YAGNI。TDD。

担当者は熟練者ですが、ツールセットや問題領域についてはほとんど知らないものとします。正しく進められているかを確認する方法も知らないと想定してください。

利用可能なエージェントスキルを分析し、関連するスキルをすべて使ってタスク分解を作成してください。

最初に宣言すること： 「タスク分解スキルを使って計画を作成します。」

制約：

• 各タスクには、タスクが正しく完了したことを確認する最後のステップを設けます
• 最後のタスクでは、すべてのタスクを完了した後、仕様がある場合は、変更と作業が仕様どおりに適用されていることを確認します

既存のスキルを活用する

• 関連するエージェントスキルを特定します。ただし、このスキルと @subagent-task-execution スキルは除きます
• 出力：「タスク分解には次のスキルを使います：@skill1、@skill2、...」
• 特定したスキルを読み込み、タスク分解の作成に活用します

タスクの提示方法：

• タスク分解が完成したと思ったら、サブエージェントを使って内容を批評し、自己修正します。サブエージェントは websearch ツールを使って批評の根拠を示す必要があります
• その後、タスクをユーザーに1つずつ提示します
• タスク間の依存関係に基づいて提示します。たとえばタスク B がタスク A に依存している場合、タスク A を先に提示します
• 各タスクの後に、ここまでの内容がよさそうかユーザーに確認します
• 不明点がある場合は、確認のために戻ります。必要であれば、ユーザーからのフィードバックに応じて以前のタスクを更新することも検討します
• ユーザーがタスクに問題がないと確認したら、そのタスクを docs/YYYY-MM-DD-<feature-name>-tasks.md に追記します

適切な粒度のタスク

各ステップは1つの作業（2～5分）です：

• 「失敗するテストを書く」— ステップ
• 「失敗することを確認するためにテストを実行する」— ステップ
• 「テストを通す最小限のコードを実装する」— ステップ
• 「テストを実行し、成功することを確認する」— ステップ

タスク分解ドキュメントのヘッダー

すべてのタスク分解は、必ず次のヘッダーから始めてください：

# [Task Name] Task Breakdown

**Goal:** [One sentence describing what this achieves]

**Approach:** [2-3 sentences about approach]

**Skills:** [List of skills to use]

**Tech Details:** [Key tools, services, technologies/libraries to use]

---

タスクの構成

### Task N: [Component Name]

**Files:**
- Create: `exact/path/to/file.py`
- Modify: `exact/path/to/existing.py:123-145`
- Test: `tests/exact/path/to/test.py`

**Step 1: Write the failing test**

```python
def test_specific_behavior():
    result = function(input)
    assert result == expected

ステップ2：テストを実行し、失敗することを確認する

実行：pytest tests/path/test.py::test_name -v 想定結果：「function not defined」で FAIL

ステップ3：最小限の実装を書く

def function(input):
    return expected

ステップ4：コード変更を整理する コード変更の整理に使えるスキルがあれば使用します。

ステップ5：コード変更をレビューする コード変更のレビューに使えるスキルがあれば使用します。 コードがプロジェクトのコーディング規約に準拠し、仕様およびタスク分解に沿っていることを確認します。

ステップ6：テストを実行し、成功することを確認する

実行：pytest tests/path/test.py::test_name -v 想定結果：PASS

## Remember
- Exact file paths always
- For coding tasks, complete code in task breakdown (not "add validation")
- Exact commands with expected output
- Reference relevant skills with @ syntax
- DRY, YAGNI, TDD

## Execution Handoff

After saving the task breakdown, offer task execution:

**"Task breakdown complete and saved to `docs/YYYY-MM-DD-<feature-name>-tasks.md`.**

**Subagent-based task execution (this session)** - I dispatch fresh subagent per task, review between tasks, fast iteration

- **REQUIRED SUB-SKILL:** Use subagent-task-execution
- Stay in this session
- Fresh subagent per task + code review