mcpskills.net
技能MCP智能体提示词
mcpskills.net — A curated directory of AI agent Skills and MCP servers
TermsPrivacy
← 返回技能
Development

规划与任务拆解

将工作拆解为有序的任务。适用于你已有规范或明确需求,需要将工作拆解为可实现任务时。

作者:Addy Osmani仓库 →来源 →

将工作分解为带有明确验收标准的、小而可验证的任务。

使用场景

  • 你已有规范,需要将其拆解为可实现的单元
  • 某个任务感觉太大或太模糊,难以下手
  • 工作需要在多个代理或会话间并行
  • 你需要向人类传达范围
  • 实现顺序并不显而易见

规划流程

第 1 步:进入规划模式

在编写任何代码之前,以只读模式操作:

  • 阅读规范和相关的代码库部分
  • 识别现有的模式和约定
  • 梳理组件之间的依赖关系
  • 记录风险和未知项

规划阶段不要编写代码。

第 2 步:识别依赖关系图

梳理什么依赖于什么:

Database schema
    │
    ├── API models/types
    │       │
    │       ├── API endpoints
    │       │       │
    │       │       └── Frontend API client
    │       │               │
    │       │               └── UI components
    │       │
    │       └── Validation logic
    │
    └── Seed data / migrations

第 3 步:垂直切片

一次构建一条完整的功能路径:

不好(水平切片):

Task 1: Build entire database schema
Task 2: Build all API endpoints
Task 3: Build all UI components
Task 4: Connect everything

好(垂直切片):

Task 1: User can create an account (schema + API + UI)
Task 2: User can log in (auth schema + API + UI)
Task 3: User can create a task (task schema + API + UI)
Task 4: User can view task list (query + API + UI)

第 4 步:编写任务

每个任务遵循以下结构:

## Task [N]: [Short descriptive title]

**Description:** One paragraph explaining what this task accomplishes.

**Acceptance criteria:**
- [ ] [Specific, testable condition]
- [ ] [Specific, testable condition]

**Verification:**
- [ ] Tests pass: `npm test -- --grep "feature-name"`
- [ ] Build succeeds: `npm run build`
- [ ] Manual check: [description of what to verify]

**Dependencies:** [Task numbers this depends on, or "None"]

**Files likely touched:**
- `src/path/to/file.ts`
- `tests/path/to/test.ts`

**Estimated scope:** [Small: 1-2 files | Medium: 3-5 files | Large: 5+ files]

第 5 步:排序与设置检查点

安排任务的顺序,使得:

  1. 依赖关系得到满足
  2. 每个任务完成后系统仍处于可工作状态
  3. 每完成 2-3 个任务后设置验证检查点
  4. 高风险任务安排在前(尽早失败)

任务规模指南

| 规模 | 文件数 | 范围 | 示例 | |------|-------|-------|---------| | XS | 1 | 单个函数或配置变更 | 添加一条验证规则 | | S | 1-2 | 一个组件或端点 | 添加一个新的 API 端点 | | M | 3-5 | 一个功能切片 | 用户注册流程 | | L | 5-8 | 多组件功能 | 带筛选的搜索 | | XL | 8+ | 太大了——继续拆分 | — |

规划文档模板

# Implementation Plan: [Feature/Project Name]

## Overview
[One paragraph summary of what we're building]

## Architecture Decisions
- [Key decision 1 and rationale]
- [Key decision 2 and rationale]

## Task List

### Phase 1: Foundation
- [ ] Task 1: ...
- [ ] Task 2: ...

### Checkpoint: Foundation
- [ ] Tests pass, builds clean

### Phase 2: Core Features
- [ ] Task 3: ...
- [ ] Task 4: ...

### Checkpoint: Core Features
- [ ] End-to-end flow works

## Risks and Mitigations
| Risk | Impact | Mitigation |
|------|--------|------------|
| [Risk] | [High/Med/Low] | [Strategy] |

并行化机会

  • 可安全并行: 相互独立的功能切片、测试、文档
  • 必须串行: 数据库迁移、共享状态变更
  • 需要协调: 共享同一 API 契约的功能

验证

在开始实现之前:

  • [ ] 每个任务都有验收标准
  • [ ] 每个任务都有验证步骤
  • [ ] 任务依赖已识别并正确排序
  • [ ] 没有任务触及超过约 5 个文件
  • [ ] 主要阶段之间存在检查点
  • [ ] 人类已审查并批准该计划