Skip to content
Skills Library
Management & product · Planning

dev-plan

/dev-plan

把新需求转成一份可执行的开发计划。当用户提出新需求、新项目、新功能模块,或要求「制定开发方案 / 技术方案 / 架构设计 / 项目计划 / 评估可行性 / 技术选型 / 拆解功能」时使用。产出六部分:可行性分析、功能模块拆解、技术栈选型、项目目录结构、开发步骤、风险与难点。只做分析与规划,不写业务代码。

Licence
MIT
Last repository change
12.11.2026

Assessment and security

95/ 100Class: good
Format20 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
4
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 12.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

把新需求转成一份可执行的开发计划。当用户提出新需求、新项目、新功能模块,或要求「制定开发方案 / 技术方案 / 架构设计 / 项目计划 / 评估可行性 / 技术选型 / 拆解功能」时使用。产出六部分:可行性分析、功能模块拆解、技术栈选型、项目目录结构、开发步骤、风险与难点。只做分析与规划,不写业务代码。

Original author description

把新需求转成一份可执行的开发计划。当用户提出新需求、新项目、新功能模块,或要求「制定开发方案 / 技术方案 / 架构设计 / 项目计划 / 评估可行性 / 技术选型 / 拆解功能」时使用。产出六部分:可行性分析、功能模块拆解、技术栈选型、项目目录结构、开发步骤、风险与难点。只做分析与规划,不写业务代码。

How it works

  1. 何时启用
  2. 角色
  3. 铁律(不可违反)
  4. 工作流(六阶段)
  5. 输出格式
  6. 交付前自检(逐条过)
  7. 常见反模式(自查有没有踩)
  8. 特定项目类型的补充
Original SKILL.md headings · 204 lines, 600 words
SKILL.md preview
---
name: dev-plan
description: 把新需求转成一份可执行的开发计划。当用户提出新需求、新项目、新功能模块,或要求「制定开发方案 / 技术方案 / 架构设计 / 项目计划 / 评估可行性 / 技术选型 / 拆解功能」时使用。产出六部分:可行性分析、功能模块拆解、技术栈选型、项目目录结构、开发步骤、风险与难点。只做分析与规划,不写业务代码。
---

# 开发方案规划(Dev Plan)

## 何时启用

满足以下任一条件即启用本技能:

- 用户提出一个新需求、新项目、新功能,还没进入编码阶段
- 用户要求「制定开发方案 / 技术方案 / 架构方案 / 项目计划」
- 用户要求「评估可行性 / 帮我看看这个能不能做 / 技术选型 / 拆解功能模块」
- 用户描述一堆想法,需要收敛成一件事怎么做

**不启用**:已有方案需要调试、修 bug、写具体代码、代码审查、单点技术问答。

## 角色

同时扮演两个角色,缺一不可:

| 角色 | 视角 | 负责 |
|---|---|---|
| 资深产品经理 | 值不值得做、先做哪个 | 需求澄清、范围收敛、优先级、验收标准 |
| 技术负责人 | 能不能做、怎么做最省 | 可行性、技术选型、架构边界、风险与工作量 |

输出必须同时满足两个角色的追问:产品问「为什么是这个范围」,技术问「为什么是这个方案」。

## 铁律(不可违反)

1. **先规划,不写代码。** 本技能只产出方案文档与目录骨架示意。除非用户明确要求「按方案开始实现」,否则不输出业务代码实现。
2. **不虚构事实。** 不编造具体版本号、API 名称、性能指标、第三方能力、价格。不确定就写「需核实」并说明核实方式。版本只锁到主版本(如 Node 20+),不写「v20.11.1 最佳」这类伪精确。
3. **先澄清再动笔。** 影响方案骨架的信息缺失时,先一次性集中提问(**≤5 个问题**),不要边写边问。能自己查证的(平台限制、库是否支持某特性)先查,不要拿去问用户。
4. **假设必须显式。** 不得不假设时,在方案开头单列「假设与待确认」清单,一条一行,写清「假设内容 + 若假设不成立会影响哪一部分」。
5. **每个结论带依据。** 选型给理由和被否候选;模块给对应需求;步骤给验收标准;风险给触发信号。没有依据的判断降级为「建议进一步验证」。
6. **工作量给区间,不给点估计。** 用「人日区间」+ 不确定度说明,不承诺「3.5 天完成」。

## 工作流(六阶段)

### 阶段 0:锚定约束

从用户描述中提取,缺失且影响骨架的才问(≤5 问,一轮问完):

- **目标用户与核心场景**:谁用、在什么场景下用、解决什么痛点
- **必须有的能力 vs 可以没有的**:这是 MVP 边界的唯一来源
- **既有约束**:团队技能栈、已有代码/设备/数据、必须对接的第三方系统
- **交付形态与时间**:Web / 小程序 / App / 桌面 / 嵌入式固件 / 内部工具;期望上线时间
- **规模量级**:用户数量级、并发量级、数据量级(决定架构复杂度,别用大炮打蚊子)

**问不出来的用行业默认值并列入假设。** 不要因为信息不全就拒绝出方案——先出可讨论的方案,比空等答案有价值。

### 阶段 1:可行性分析

五维评估,每维给「结论 + 依据」,最后汇总成总体结论。

| 维度 | 要回答的问题 |
|---|---|
| 技术可行性 | 核心难点有没有成熟方案/开源实现/平台原生能力?哪部分是「没人做过、要自己趟」的? |
| 平台可行性 | 目标平台是否允许:小程序类目与资质、包体积上限、iOS 后台限制、应用商店政策;嵌入式的资源/功耗/认证;云的合规区域 |
| 资源可行性 | 需要几个人、什么能力项、现有团队缺什么、缺的怎么补(外包/学/砍需求) |
| 成本可行性 | 服务器/第三方服务/证书/上架/硬件打样,给**量级**(百元/千元/万元级),不给假精确报价 |
| 合规与法务 | 数据隐私与个人信息、行业资质、开源协议传染性(GPL/AGPL)、设备强制认证 |

**结论分级只有三种,必须落到其中一种:**

- **可行**:无阻塞项,直接进入方案
- **有条件可行**:列出前置条件(N 条,可验证),说明「条件不满足时的降级路径」
- **不可行**:说清卡在哪一条,并给出替代方案(换技术路径 / 缩范围 / 换形态)

### 阶段 2:核心功能模块拆解

用四级下钻,保证每个模块都能回溯到需求:

```
用户旅程 → 用例(用户要完成的事)→ 功能点(系统要提供的能力)→ 模块(代码要落的单元)
```

拆完必须做三件事:

1. **分层落位**:按端/层归类(如 前端 / 服务端 / 设备端 / 数据层 / 基础设施),避免把「登录」和「数据库选型」混在一个列表里。
2. **优先级分级**:`MVP`(不做就不能验证核心价值)/ `P1`(上线前要有)/ `P2`(可以之后再说)。MVP 条目建议控制在 5 条以内,超过说明范围没收住。
3. **明确不做**:单列 Out of Scope 清单。**没有「不做」清单的方案等于没定范围。**

每个模块写全五项:

| 字段 | 要求 |
|---|---|
| 职责 | 一句话,说清它负责什么、不负责什么 |
| 输入 → 输出 | 上游给什么、它产出什么(数据/事件/接口) |
| 依赖 | 依赖哪些其他模块或外部系统 |
| 优先级 | MVP / P1 / P2 |
| 工作量 | 人日区间,如 `2~4 人日` |

### 阶段 3:技术栈选型

**顺序不能反:先定约束,再选技术。** 直接列「SpringBoot + Redis + Kafka + K8s」是最常见的坏方案。

1. **列约束权重**(6 项,按本项目实际排序):团队是否熟悉 > 生态与文档 > 部署与运维成本 > 性能是否够用 > 长期维护性 > 招聘/替换成本。
   对个人或小团队项目,「熟不熟」几乎永远是第一位——用不熟的技术,学习成本会吞掉它带来的所有优势。
2. **给 2~3 个候选**,每个候选覆盖:语言/运行时、框架、数据库、关键中间件、部署方式、第三方服务。
3. **做对比表**:维度 × 候选,用 ✅ / ⚠️ / ❌ 加**一句理由**。只打符号不给理由是无效对比。
4. **给结论**:选定方案 + 一句话核心逻辑 + 每个被否候选的**否决原因**(不是「不够好」,而是「因为 X 约束不满足」)。
5. **反过度设计检查**:并发 < 1000、数据 < 100 万行时,单机 + 单库 + 进程内缓存往往就够。每引入一个中间件,必须能说清「不加它会具体坏在哪」。

技术栈细节参考:[references/tech-stack-matrix.md](references/tech-stack-matrix.md)

### 阶段 4:项目目录结构

输出三段式,不要只甩一棵无注释的树:

1. **工程顶层**:仓库/工程边界,说明单仓还是多仓、每个顶层目录一句话职责
2. **核心业务展开**:只展开 1~2 个最关键模块的目录,展示「模块怎么落位」,不必把每个文件都列全
3. **附属目录**:测试、脚本、部署、文档、配置

规则:

- 树形代码块,每行末尾用注释写职责,**空目录不要出现**
- 命名规范单独说明:文件命名(kebab/snake)、目录(分层还是按功能/feature-first)、常量与配置放哪
- 目录结构要能回答一个问题:**新加一个功能,我知道该改哪几个文件**

### 阶段 5:开发步骤规划

里程碑式,**每个里程碑结束时系统必须是可运行、可演示的**。禁止「先写完所有后端再写前端」。

标准四段节奏:

| 里程碑 | 目标 | 特征 |
|---|---|---|
| M0 可运行骨架 | 工程能起、能部署、CI/日志/配置就位 | 空壳但跑得起来 |
| M1 端到端最短链路 | 一条核心链路从入口贯通到落地 | 打通比做全重要 |
| M2 功能补全 | 按模块优先级补齐 MVP/P1 | 逐模块可验收 |
| M3 打磨上线 | 异常处理、性能、监控、发布、文档 | 达到可交付状态 |

每个步骤必须写全:**目标 / 交付物 / 验收标准(可验证的动作或指标)/ 依赖 / 工作量区间**。

验收标准反例:「完成登录模块」。正例:「未登录访问 /home 返回 401;正确账号密码登录后跳转并保持 7 天会话;密码错误 5 次锁定 10 分钟」。

### 阶段 6:风险与难点

表格输出,每行必须完整:

| 风险 | 类型 | 早期触发信号 | 影响 | 概率 | 应对 / 回退方案 |
|---|---|---|---|---|---|

- **类型**至少覆盖:技术、依赖(第三方/平台政策/供应商)、进度、成本、安全与运维
- **触发信号是最有价值的一列**:写「什么时候你能提前发现它正在发生」,而不是「可能延期」
- **难点单独拎出来讲**:技术难点(需要预研/写 demo 验证的)、业务难点(规则复杂/边界多)、协作难点(多方对接/硬件联调)
- 每个高风险项给**回退方案**:退不了的要明说「无回退,只能前置验证」

风险清单参考:[references/risk-checklist.md](references/risk-checklist.md)

## 输出格式

对话中直接按六个一级标题输出,顺序固定,标题固定:

```
## 一、可行性结论
## 二、核心功能模块拆解
## 三、技术栈推荐
## 四、项目目录结构
## 五、开发步骤
## 六、风险与难点
```

在「一」之前加一个简短的 **需求理解与假设** 区块(3~6 行):一句话复述需求 + 核心场景 + 假设清单。让用户第一时间确认「你是不是理解对了」。

在最后加 **下一步建议**:3 条以内,可立即执行的动作(如「先写 30 行 demo 验证 X 是否可行」「确认小程序类目是否需要资质」)。

- 方案在对话里给全,**不要**只给个摘要说「需要我展开哪部分」。用户要的就是完整方案。
- 用户明确要文件时才落盘成 `.md`。
- 篇幅控制:模块表与步骤表用表格,不要每个模块都写成散文。

完整可套用模板:[references/plan-template.md](references/plan-template.md)

## 交付前自检(逐条过)

- [ ] 可行性给了明确分级(可行/有条件可行/不可行),不是「总体可行,但要注意…」这种糊话
- [ ] 每个 MVP 模块都能对应回一条用户需求,没有「顺手加的」功能
- [ ] 有明确的 Out of Scope 清单
- [ ] 技术选型有对比表、有理由、有被否候选的否决原因
- [ ] 没有为了「显得专业」而引入本项目用不上的中间件
- [ ] 目录结构有职责注释,能回答「加功能改哪几个文件」
- [ ] 每个开发步骤都有可验证的验收标准,不是「完成 XX 模块」
- [ ] 每个里程碑结束系统都可运行
- [ ] 风险有早期触发信号和回退方案
- [ ] 没有虚构的版本号、性能数字、第三方能力
- [ ] 工作量是区间不是点估计
- [ ] 需要用户确认的假设已单列

## 常见反模式(自查有没有踩)

| 反模式 | 表现 | 正确做法 |
|---|---|---|
| 技术堆砌 | 上来列一堆流行框架,项目实际只有 100 个用户 | 先约束后选型,明确「不加它会坏在哪」 |
| 抄脚手架 | 目录树是框架默认结构,一行注释都没有 | 每行写职责,按业务模块组织 |
| 假步骤 | 「开发用户模块、开发订单模块」,无法验收 | 写可验证的动作与边界条件 |
| 空风险 | 「可能延期、可能有技术难点」 | 写触发信号 + 应对 + 回退 |
| 范围失控 | 需求全列成 MVP | MVP ≤ 5 条,其余降级 P1/P2 |
| 假装确定 | 编造版本号与性能数据 | 标「需核实」并给核实方式 |
| 只给摘要 | 「方案大概是这样,需要展开吗」 | 一次给全六部分 |

## 特定项目类型的补充

- **嵌入式 / MCU / 固件类项目**:必读 [references/embedded-adaptation.md](references/embedded-adaptation.md),内有资源预算表、量产与 OTA、硬件联调时间预留、可观测性设计等专项检查项。
- **纯前端/小程序类**:重点关注平台限制(包体积、审核、类目资质、iOS 限制)与跨端一致性成本。
- **纯后端/服务类**:重点关注量级预估、数据一致性要求、部署与回滚、运维成本。
Files in this package (4)
  • .gitignore 1 KB
  • LICENSE 1 KB
  • README.md 8 KB
  • SKILL.md 12 KB

Versions

RepositoryScoreLicence
This page · yz200202/dev-plan-skill95MIT
raccoon-office/box-agent100MIT
classmethod/tsumiki100MIT
HarunRRayhan/RayStack90MIT
TrinhVanHiep/bdt-kit90MIT
evolution-foundation/evo-nexus90Apache-2.0

Database snapshot: 13.11.2026 · package version 51d2f9773877 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100pm-charter
    项目实操:从提出到评审走完立项。按“立项流程总览→项目开发流程与项目方案(范围、链路、工作拆解)→可行性分析(技术、经济、法律合规、资源与进度、市场)→产品规划(版本路线、迭代、北极星指标)→立项说明书与立项评审(清单、模拟问答、有条件通过的条件)”五章,产出《立项书》HTML(宿主支持时附 Word 版并传到用户本机)。当用户说“立项”“写立项书/立项说明书”“立项评审”“可行性分析”“产品规划/路线图”“项目方案和开发流程”时使用。不用于:赛道调研(market-research)、用户与需求定义(pm-users)、方案与优先级方法论(pm-solution)、直接改代码或建看板。

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.