planlisted
Install: claude install-skill chengxuniucode/ForgeTeam
# Plan Skill
## 目标
将已确认的需求（proposal 或直接请求）拆解为可逐步执行的任务列表，
每个任务粒度到"一次提交能完成"。
## 执行步骤
### Step 1: 分析需求
**Standard Route**:
- 直接从用户请求提取需求点
- 参考 project-map 了解现有结构
**Full Route**:
- 读取 `specs/active/{slug}/proposal.md`
- 基于已确认的方案进行设计
### Step 2: 设计（Full Route Only）
生成 `specs/active/{slug}/design.md`：
```markdown
# Design: {title}
## 架构变更
{新增/修改的模块、组件、接口}
## 数据模型
{新增/修改的数据结构}
## 接口定义
{API endpoints / function signatures}
## 依赖关系
{新增的依赖包、外部服务}
## 文件变更清单
{将要创建/修改/删除的文件列表}
```
### Step 3: 任务拆解
拆解原则：
1. 每个 task 是一个原子操作（创建文件 / 修改函数 / 添加测试）
2. task 之间的依赖关系显式标注
3. 可并行的 task 标记为同一波次
4. 每个 task 有明确的验证标准
5. 对可自动化验证的行为，先列出失败测试；无法测试时在 task 中写明豁免理由
6. 业务系统变更必须声明适用的验收维度：权限、流程、数据、审计、集成；不适用项需要说明原因
### Step 3.1: 业务交付约束（业务系统变更）
在 `tasks.md` 顶部写入仅对本需求生效的全局约束，并为跨任务依赖写明接口。不要要求用户理解 Agent 编排；这些内容用于保证业务交付可验收。
```markdown
## Global Constraints
- 权限：{可操作角色与越权拒绝规则}
- 流程：{状态、前置条件、异常/撤回路径}
- 数据：{校验、迁移、幂等、回滚要求}
- 审计：{需要记录的操作者、时间、对象和结果}
- 集成：{数据源、超时、重试、失败补偿；无则写不适用}
## Task Interfaces
| Task | 输入契约 | 输出契约 | 下游任务 |
|------|----------|----------|----------|
| Task N | {依赖的数据/API/页面} | {新增或修改的契约} | {Task N+1} |
```
### Step 4: 生成 tasks.md
使用 `parallel:` 标记声明无相互依赖、可同时执行的任务组：
```markdown
# Tasks: {slug}
## Route: {micro|standard|full}
## Status: planned
## Created: {timestamp}
## Estimated: {task_count} tasks, {size} effort
---
## Wave 1
parallel:
- [ ] Task 1: {描述}
- type: create|modify|delete
- files: {文件路径列表}
- depends: none
- verify: {验证方式}
- [ ] Task 2: {描述}
- type: create