task-breakdown

编写任务拆解

概述

编写全面的任务拆解，假设即将实现规格的专家对我们的项目毫无了解，而且品味值得怀疑。记录他们需要知道的一切：要检查哪些现有文件、每项任务要修改哪些文件，以及如何修改。将完整计划拆分成易于执行的小任务。DRY。YAGNI。TDD。

假设他们是熟练的工作者，但对我们的工具集或问题领域几乎一无所知。假设他们不知道如何验证自己是否做对了。

分析可用的 Agent 技能，并使用所有相关技能来创建任务拆解。

开始时宣布：“我将使用任务拆解技能来制定计划。”

约束：

• 每项任务的最后一步都应验证该任务是否正确完成
• 最后一项任务应验证所有任务完成后，是否已按照规格（如有）正确应用变更并执行操作

利用现有技能

• 找出相关的 Agent 技能——除本技能和 @subagent-task-execution 技能外
• 输出：“我将使用以下技能协助完成任务拆解：@skill1、@skill2、...”
• 加载并使用已找到的技能来创建任务拆解

呈现任务：

• 完成任务拆解后，使用子 Agent 对其进行审查并自我修正——子 Agent 必须使用 websearch 工具作为审查依据
• 然后逐项向用户呈现任务
• 按任务依赖关系呈现任务，例如，任务 B 依赖任务 A 时，必须先呈现任务 A
• 每呈现一项任务后，都询问用户目前看来是否合理
• 准备好根据需要回头澄清；如有必要，可根据用户反馈更新之前的任务
• 用户确认任务看起来合理后，将该任务更新到 docs/YYYY-MM-DD-<feature-name>-tasks.md

细分任务粒度

每个步骤只执行一个操作（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”

步骤 3：编写最精简的实现

def function(input):
    return expected

步骤 4：清理代码变更 如有可用技能，请使用相关技能清理代码变更。

步骤 5：审查代码变更 如有可用技能，请使用相关技能审查代码变更。 确保代码符合项目编码规范，并与规格及任务拆解保持一致。

步骤 6：运行测试，确认其通过

运行：pytest tests/path/test.py::test_name -v 预期：通过

## 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