Menu
功能任务规划。将技术方案拆解为细粒度、可执行的开发任务清单 (Task List)。
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
功能开发阶段使用。明确具体功能的业务需求和验收标准，产出功能需求文档 (FRD)。
设计功能的技术实现方案。在功能需求明确后使用，产出包含API、数据库、核心逻辑的详细技术方案 (TDD)。
生成项目导航文档。基于项目核心文档生成 AGENT.md，作为 AI 助手的项目导航。
记录和查阅 AI 错题本。当发生错误或需要预警时使用，建立自我进化的反馈闭环，避免重复错误。
交互式 BUG 排查专家。通过持续提问和引导，逐步缩小问题范围，辅助用户定位 BUG 根源。
存量项目接入。扫描现有代码库，逆向生成标准化的全局指引文档 (specs/*)。
| name | feature-task-planning |
| description | 功能任务规划。将技术方案拆解为细粒度、可执行的开发任务清单 (Task List)。 |
你的目标是将《技术设计文档》拆解为细粒度、可执行的开发任务清单，生成《开发任务计划文档》，即 3_任务规划.md。
我们已经有了明确的需求（docs/{功能名称}/1_需求文档.md）和详细的设计（docs/{功能名称}/2_技术方案.md）。现在需要制定执行计划，指导开发人员（或 AI）按部就班地完成编码。
docs/{功能名称}/2_技术方案.md (技术设计文档)docs/{功能名称}/1_需求文档.md (功能需求文档 - 用于验收标准对照)请严格遵守通用边界守卫规则：specs/GUARDRAILS.md 当前阶段: 规划与管理阶段 (Planning & Management)
docs/{功能名称}/2_技术方案.md 是否存在且完整docs/{功能名称}/prototypes/ 或 docs/product_prototypes/ 下是否存在对应的 HTML 原型文件。"基于技术方案，我已拆解出 [N] 个开发任务，预计总工时 [X] 小时。在生成文档前，您是否还有其他要求？（例如：优先级调整、任务合并等）"
docs/{功能名称}/3_任务规划.md（与需求文档和技术方案在同一目录下）。# 开发任务计划: [功能名称]
## 0. 任务概览 (Task Overview)
* **总任务数**: [N] 个
* **预计总工时**: [X] 小时（约 [Y] 个工作日）
* **关键里程碑**:
* 阶段一完成：[日期或工时]
* 阶段二完成：[日期或工时]
* 整体完成：[日期或工时]
* **风险任务**: [列出技术难度高的任务编号]
* **阻塞任务**: [列出被多个任务依赖的关键任务编号]
## 1. 准备工作 (Preparation)
- [ ] **Prep-01**: 创建功能分支 `feature/xxx`
* 说明：从 main/develop 分支创建新分支
* 验证：分支创建成功
- [ ] **Prep-02**: 确认依赖库/环境就绪
* 说明：检查技术方案中提到的新依赖是否已安装
* 验证：项目可正常启动
## 2. 开发任务 (Development Tasks)
> 按依赖顺序排列，每个任务耗时 < 4h
### 阶段一：数据层 (Data Layer)
> 先完成数据库设计和数据访问层
- [ ] **Task-01**: [任务标题]
* **说明**: 创建 xxx 表 / 修改 xxx 表结构
* **涉及文件**: `migrations/xxx.sql` 或 `models/xxx.js`
* **参考**: 技术方案 Sec 3.1
* **对应AC**: AC-001
* **提示词**: "帮我编写 migration 脚本，创建 xxx 表，参考技术方案 Sec 3.1"
* **预估工时**: 1h
* **依赖**: 无
* **验证标准**:
- [ ] 数据库迁移脚本执行成功
- [ ] 表结构符合设计文档
- [ ] **Task-02**: [任务标题]
* **说明**: 实现 xxx 数据访问层（DAO/Repository）
* **涉及文件**: `repositories/xxx.js`
* **参考**: 技术方案 Sec 3.1
* **对应AC**: AC-001
* **预估工时**: 2h
* **依赖**: Task-01
* **验证标准**:
- [ ] 单元测试覆盖 CRUD 操作
- [ ] 测试通过率 100%
### 阶段二：业务逻辑层 (Business Logic Layer)
> 实现核心业务逻辑和 API 接口
- [ ] **Task-03**: [任务标题]
* **说明**: 实现 xxx API 接口
* **涉及文件**: `controllers/xxx.js`, `services/xxx.js`
* **参考**: 技术方案 Sec 2.2
* **对应AC**: AC-002
* **提示词**: "实现 xxx API 接口，参考技术方案 Sec 2.2，注意参数校验"
* **预估工时**: 3h
* **依赖**: Task-02
* **风险标注**: ⚠️ 涉及复杂业务逻辑
* **验证标准**:
- [ ] API 返回格式符合设计文档
- [ ] 正常流程测试通过
- [ ] 异常场景测试通过（参数校验、权限校验）
- [ ] **Task-04**: [任务标题]
* **说明**: 实现 xxx 核心算法
* **涉及文件**: `services/xxx.js`
* **参考**: 技术方案 Sec 4.1
* **对应AC**: AC-003
* **预估工时**: 4h
* **依赖**: Task-03
* **阻塞标注**: 🔒 后续多个任务依赖此任务
* **验证标准**:
- [ ] 算法逻辑正确
- [ ] 边界条件测试通过
- [ ] 性能满足要求（< 200ms）
### 阶段三：表现层 (Presentation Layer)
> **注意**: 必须基于已有的 UI 原型进行开发，禁止在此阶段重新设计原型。
- [ ] **Task-05**: [任务标题]
* **说明**: 实现 xxx 页面组件 (基于现有原型)
* **涉及文件**: `components/xxx.jsx`, `pages/xxx.jsx`
* **UI 来源**: `docs/product_prototypes/[文件名].html` 或 `docs/{功能名称}/prototypes/[文件名].html`
* **参考**: 技术方案 Sec 2.2
* **对应AC**: AC-004
* **提示词**: "读取 docs/.../xxx.html，使用项目约定的技术栈实现组件。注意：完全还原原型布局和样式。"
* **预估工时**: 1h
* **依赖**: Task-03
* **验证标准**: (必须包含 UI 还原度检查)
- [ ] 组件视觉效果与 `[文件名].html` 原型一致
- [ ] 响应式表现符合预期
- [ ] 交互逻辑（点击、跳转）正常
- [ ] **Task-06**: [任务标题]
* **说明**: 实现 xxx 交互逻辑
* **涉及文件**: `components/xxx.jsx`
* **参考**: 技术方案 Sec 2.2
* **对应AC**: AC-005
* **预估工时**: 2h
* **依赖**: Task-05
* **验证标准**:
- [ ] 用户操作流程正常
- [ ] 错误提示显示正确
- [ ] 加载状态显示正常
### 阶段四：异常处理与优化 (Error Handling & Optimization)
> 完善异常处理和性能优化
- [ ] **Task-07**: [任务标题]
* **说明**: 实现异常场景处理
* **涉及文件**: `services/xxx.js`, `components/xxx.jsx`
* **参考**: 技术方案 Sec 5
* **对应AC**: AC-006 (异常场景)
* **预估工时**: 2h
* **依赖**: Task-06
* **验证标准**:
- [ ] 网络失败时显示重试按钮
- [ ] 权限不足时跳转到无权限页
- [ ] 数据为空时显示空状态页
- [ ] **Task-08**: [任务标题]
* **说明**: 性能优化和缓存实现
* **涉及文件**: `services/xxx.js`, `utils/cache.js`
* **参考**: 技术方案 Sec 6
* **对应AC**: 非功能需求
* **预估工时**: 2h
* **依赖**: Task-07
* **验证标准**:
- [ ] 响应时间 < 200ms
- [ ] 缓存命中率 > 80%
### 阶段五：测试与集成 (Testing & Integration)
> 补充测试和联调
- [ ] **Task-09**: 补充单元测试
* **说明**: 为核心逻辑补充单元测试
* **涉及文件**: `tests/unit/xxx.test.js`
* **参考**: 技术方案 Sec 4
* **对应AC**: 所有AC
* **提示词**: "为 xxx 模块编写单元测试，覆盖核心逻辑"
* **预估工时**: 3h
* **依赖**: Task-08
* **验证标准**:
- [ ] 测试覆盖率 > 80%
- [ ] 所有测试通过
- [ ] **Task-10**: 集成测试与联调
* **说明**: 前后端联调，端到端测试
* **涉及文件**: `tests/integration/xxx.test.js`
* **参考**: 需求文档验收标准
* **对应AC**: 所有AC
* **预估工时**: 2h
* **依赖**: Task-09
* **验证标准**:
- [ ] 完整流程走通
- [ ] 所有验收标准通过
- [ ] **Task-11**: Bug 修复与边缘情况处理
* **说明**: 修复测试中发现的问题
* **涉及文件**: 根据 Bug 确定
* **参考**: 测试报告
* **对应AC**: 所有AC
* **预估工时**: 2h
* **依赖**: Task-10
* **验证标准**:
- [ ] 所有已知 Bug 修复
- [ ] 回归测试通过
## 3. 验收标准检查清单 (AC Checklist)
> 确保所有验收标准都有对应的任务
| 验收标准ID | 验收标准描述 | 对应任务 | 状态 |
| :--- | :--- | :--- | :--- |
| AC-001 | [描述] | Task-01, Task-02 | ⬜ 待完成 |
| AC-002 | [描述] | Task-03 | ⬜ 待完成 |
| AC-003 | [描述] | Task-04 | ⬜ 待完成 |
## 4. 验证计划 (Verification Plan)
### 4.1 开发阶段验证
- [ ] 每个任务完成后，运行相关单元测试
- [ ] 每个阶段完成后，进行阶段性集成测试
### 4.2 最终验证
- [ ] 运行全量单元测试（覆盖率 > 80%）
- [ ] 运行集成测试（所有 API 测试通过）
- [ ] 按照验收标准逐项手工验证
- [ ] 性能测试（响应时间、并发量）
- [ ] 安全测试（权限校验、数据校验）
### 4.3 上线前检查
- [ ] 代码审查（Code Review）
- [ ] 文档更新（API 文档、README）
- [ ] 数据库迁移脚本验证
- [ ] 回滚方案准备
## 5. 风险与注意事项 (Risks & Notes)
* **技术风险**: [列出风险任务及应对方案]
* **依赖风险**: [列出外部依赖或阻塞任务]
* **时间风险**: [如果工时超出预期，哪些任务可以延后]
* **质量保证**: [如何确保代码质量]
验证标准 (Verification Criteria) 字段，且必须至少包含 2 条具体的检查项。禁止仅列出 "Task-XX" 而没有验证标准。docs/{功能名称}/3_任务规划.md。