实施计划
Productivity实施计划 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.
为软件功能或项目制定分步实施计划时使用,澄清目标、拆解任务与依赖、排里程碑、定义验收标准
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/maka-agent/maka-agent/blob/HEAD/apps/desktop/resources/bundled-skills/create-plan/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/实施计划, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
实施计划
把一个模糊的目标("给网站加个推荐功能"、"重构遗留系统")转成一份可执行、可追踪、可验收的实施计划。计划不是任务清单的堆砌,而是回答四个问题:要做成什么样、按什么顺序做、什么时候能做完、怎么判断做对了。
目标
产出一份结构化的 Markdown 实施计划,让任何一个团队成员读完就能开始动手,让 leader 读完就能判断进度和风险。一份合格的计划必须包含:明确的目标与非目标、拆解到可估时的任务、任务间的依赖关系、里程碑与时间线、风险与应对、可验证的验收标准。
工作流步骤
步骤 1:澄清目标与约束
不要拿到需求就开始拆任务。先花时间把边界钉死,否则后面所有拆解都建在流沙上。
需要确认的信息(缺失的要主动向用户提问,不要臆测):
- 目标(Goal):这个功能/项目要解决什么问题?成功长什么样?用一句话说清楚。
- 范围(Scope):这次要做什么,明确不做什么。"非目标"和"目标"同样重要,它挡住范围蔓延。
- 约束(Constraints):技术栈、现有架构、团队规模、截止日期、预算、合规要求。
- 现状(Baseline):从零开始还是改造存量?如果涉及已有代码,用 Read 读关键文件了解现状,不要凭想象。
- 成功指标(Metrics):如果有可量化目标(性能、覆盖率、转化率),先记下来,它会变成验收标准。
如果用户给的信息足够,直接进入下一步;如果关键信息缺失(比如没说技术栈、没说 deadline),列出你需要补充的问题再继续。
步骤 2:拆解任务与依赖
把目标拆成可执行的工作单元。拆解的颗粒度原则:每个任务能被一个人在 0.5–3 天内完成,并且完成与否有客观判据。 太大的任务估不准也追踪不了,太小的任务管理成本高。
拆解方法:
- 按交付物或功能模块横切,再在每个模块内按技术分层纵切(如:数据层 → 服务层 → 接口层 → 前端 → 联调)。
- 对每个任务标注:任务 ID、简述、负责角色、预估工作量(人天)、前置依赖(依赖哪些任务 ID)。
- 识别依赖类型:硬依赖(B 必须等 A 完成,如接口定义完才能写前端)、软依赖(有 A 会更顺但不阻塞)。只有硬依赖影响排期。
- 标出可并行的任务——没有相互依赖的任务应该并行推进,这是压缩总工期的关键。
如果任务超过 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 结构输出:
# 实施计划:<项目/功能名称>
## 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),不修改任何源代码、不执行构建或迁移。
- 涉及不可逆操作必须写预案:任何数据迁移、线上切换、删除类动作,计划里必须包含回滚方案。