# 实施计划

> 实施计划 is an Agent Skill for productivity published in the maka-agent/maka-agent repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

为软件功能或项目制定分步实施计划时使用，澄清目标、拆解任务与依赖、排里程碑、定义验收标准

- Skill name: `实施计划`
- Category: [Productivity](https://www.openparable.com/skill/productivity/1)
- Source: https://github.com/maka-agent/maka-agent/blob/HEAD/apps/desktop/resources/bundled-skills/create-plan/SKILL.md
- Repository: maka-agent/maka-agent (675 GitHub stars when collected)

## SKILL.md

# 实施计划

把一个模糊的目标（"给网站加个推荐功能"、"重构遗留系统"）转成一份可执行、可追踪、可验收的实施计划。计划不是任务清单的堆砌，而是回答四个问题：要做成什么样、按什么顺序做、什么时候能做完、怎么判断做对了。

## 目标

产出一份结构化的 Markdown 实施计划，让任何一个团队成员读完就能开始动手，让 leader 读完就能判断进度和风险。一份合格的计划必须包含：明确的目标与非目标、拆解到可估时的任务、任务间的依赖关系、里程碑与时间线、风险与应对、可验证的验收标准。

## 工作流步骤

### 步骤 1：澄清目标与约束

不要拿到需求就开始拆任务。先花时间把边界钉死，否则后面所有拆解都建在流沙上。

需要确认的信息（缺失的要主动向用户提问，不要臆测）：

- **目标（Goal）**：这个功能/项目要解决什么问题？成功长什么样？用一句话说清楚。
- **范围（Scope）**：这次要做什么，明确不做什么。"非目标"和"目标"同样重要，它挡住范围蔓延。
- **约束（Constraints）**：技术栈、现有架构、团队规模、截止日期、预算、合规要求。
- **现状（Baseline）**：从零开始还是改造存量？如果涉及已有代码，用 Read 读关键文件了解现状，不要凭想象。
- **成功指标（Metrics）**：如果有可量化目标（性能、覆盖率、转化率），先记下来，它会变成验收标准。

如果用户给的信息足够，直接进入下一步；如果关键信息缺失（比如没说技术栈、没说 deadline），列出你需要补充的问题再继续。

### 步骤 2：拆解任务与依赖

把目标拆成可执行的工作单元。拆解的颗粒度原则：**每个任务能被一个人在 0.5–3 天内完成，并且完成与否有客观判据。** 太大的任务估不准也追踪不了，太小的任务管理成本高。

拆解方法：

1. **按交付物或功能模块横切**，再在每个模块内**按技术分层纵切**（如：数据层 → 服务层 → 接口层 → 前端 → 联调）。
2. 对每个任务标注：任务 ID、简述、负责角色、预估工作量（人天）、前置依赖（依赖哪些任务 ID）。
3. **识别依赖类型**：硬依赖（B 必须等 A 完成，如接口定义完才能写前端）、软依赖（有 A 会更顺但不阻塞）。只有硬依赖影响排期。
4. **标出可并行的任务**——没有相互依赖的任务应该并行推进，这是压缩总工期的关键。

如果任务超过 3 天还拆不动，说明理解不够，回到步骤 1 补信息。

### 步骤 3：排里程碑与识别风险

**里程碑（Milestone）** 是有明确交付物的检查点，不是时间点本身。好的里程碑可以对外汇报（"完成了 X，可以演示/验证 Y"）。

- 根据任务依赖和工作量估算，把任务归入 2–5 个里程碑。里程碑之间应该是"能独立验证的阶段性成果"。
- 每个里程碑给出：交付物、预计完成时间（可用相对周次 W1/W2，除非用户给了绝对日期）、进入下一阶段的前置条件。
- 大项目建议采用**分阶段/增量交付**：先做一个能端到端跑通的最小闭环（MVP），再迭代增强，而不是所有模块并行做到 80% 再联调。

**风险识别**——每个项目至少列出 3 条真实风险，覆盖这些维度：

- 技术风险（新技术不熟、第三方依赖不稳定、性能瓶颈、数据迁移一致性）
- 进度风险（关键路径上的任务、外部依赖、人力冲突）
- 范围风险（需求变更、验收标准模糊）

每条风险给出：**影响**（发生了会怎样）、**概率**（高/中/低）、**应对措施**（预防或缓解的具体动作）。涉及不可逆操作（数据迁移、上线切换）的，必须写**回滚/应急预案**。

### 步骤 4：定义验收标准

没有验收标准的计划无法判断"做完了没有"。为每个里程碑和整体目标定义可验证的验收条件。

- 验收标准必须**客观可测**：不是"性能提升"，而是"P95 响应时间 < 200ms"；不是"质量提高"，而是"核心模块单测覆盖率 ≥ 80%，CI 全绿"。
- 覆盖功能正确性、非功能指标（性能/安全/兼容）、测试策略（单测/集成/验收测试）。
- 把步骤 1 记下的成功指标落到这里。

### 步骤 5：组装并输出计划

按下面的输出格式组装成一份完整 Markdown 文档，用 Write 保存（除非用户只要求在对话里给出）。文件名建议 `implementation-plan-<项目名>.md`。

## 输出格式

用如下 Markdown 结构输出：

```markdown
# 实施计划：<项目/功能名称>

## 1. 目标与范围
- **目标**：<一句话>
- **成功指标**：<可量化的成功标准>
- **本次范围（做什么）**：<列表>
- **非目标（明确不做）**：<列表>

## 2. 约束与前提
- 技术栈 / 架构 / 团队 / 时间 / 其它约束

## 3. 任务拆解

| ID | 任务 | 负责角色 | 工作量(人天) | 依赖 |
|----|------|---------|------------|------|
| T1 | ...  | 后端    | 2          | -    |
| T2 | ...  | 前端    | 1.5        | T1   |

## 4. 依赖与并行
- 关键路径：T1 → T2 → T5 ...
- 可并行：{T3, T4} 与 {T2} 互不阻塞

## 5. 里程碑与时间线

| 里程碑 | 交付物 | 预计完成 | 进入条件 |
|-------|-------|---------|---------|
| M1 数据层就绪 | ... | W2 | ... |

## 6. 风险与应对

| 风险 | 影响 | 概率 | 应对措施 |
|------|------|------|---------|
| 第三方 API 不稳定 | 联调阻塞 | 中 | 加超时重试 + mock 兜底 |

## 7. 验收标准
- [ ] <可验证条件 1>
- [ ] <可验证条件 2>

## 8. 未决问题
- <需要用户/相关方确认的开放问题>
```

规则：任务表、里程碑表、风险表一律用表格，便于追踪；验收标准用可勾选清单；相对时间用周次（W1、W2），有绝对 deadline 时才用日期。

## 边界

- **不臆造约束和数据**：技术栈、deadline、团队规模等信息缺失时，在"未决问题"里列出并向用户提问，不要编造一个看似合理的假设当成事实。
- **不承诺精确工期**：工作量是估算，用范围或人天表达，并在风险里注明估算不确定性。不要给出"保证 X 号上线"这类承诺。
- **计划服务于执行，不追求面面俱到**：小任务不必套满全部章节；抓住目标、关键依赖、风险、验收这四个核心即可。
- **只做规划，不动代码**：本技能只读现状（Read）和产出计划（Write），不修改任何源代码、不执行构建或迁移。
- **涉及不可逆操作必须写预案**：任何数据迁移、线上切换、删除类动作，计划里必须包含回滚方案。

---

Source: https://www.openparable.com/skill/productivity/%E5%AE%9E%E6%96%BD%E8%AE%A1%E5%88%92 (OpenParable). Cite the canonical URL above.
