用途
dev-planning 是软件开发流程中的规划与准备阶段技能,目标是对齐技术方案、完成任务拆解和公共模块设计,从而降低开发阶段的不确定性。它位于需求分析与软件设计之后、编码(coding)之前,作为进入开发前的阶段门。
依赖规范
该技能依赖以下规范与技能文件:
- ../rules/review-base.md
- ../rules/git-workflow.md
- ../rules/coding-standards.md
- ../rules/ui-design.md
- ../rules/project-structure.md
- ../task-breakdown/SKILL.md
输入
- 设计文档:模块划分方案和设计决策记录,或对话上下文。
主要能力与使用方式
技能按步骤执行,每个步骤先输出标题,再输出结果:
- 技术对齐:收集开发者的技术倾向(语言、框架、已有约束等);结合需求、设计和开发者输入给出最佳实践建议并附理由;由开发者确认或调整,最终确定技术方案。
- UI 设计(仅 web 项目):技术方案确认后,若为 web 项目,询问开发者是否需要出设计图;如需要,遵守 ui-design 中的规范。
- 任务拆解:按 task-breakdown skill 的步骤执行,输出任务清单和依赖关系表。
- 项目初始化:根据技术方案初始化项目,包含基础配置和依赖安装;检查是否已有 .gitignore,若没有则根据技术栈生成;创建 .env.example,区分 dev/staging/prod,说明每个变量用途,敏感值不提交仓库。
- 公共模块:识别公共模块,输出接口规范,确认后在本阶段优先开发;必须包含使用文档,web 项目需包含统一演示入口页面。
- 规范约定:约定 coding-standards,后续开发强制执行。
- 写入文档:按输出要求写入文档,路径遵守 project-structure 文档存放规范。
- 执行 review:遵守 review-base,通过后才进入下一步。
- 提交:review 通过后按 git-workflow 提交,包含需求分析、软件设计、开发规划的所有产物。
输出
- 技术方案:确认后的技术方案。
- 任务清单:功能任务清单,已拆解到可独立开发和 review。
- 公共模块:清单 + 接口规范 + 使用文档(web 项目含演示入口页面)。
Review 检查清单
- 技术方案:已确认。
- 任务拆解:每个任务可独立开发和 review。
- 公共模块:清单完整,接口规范已输出,有使用文档(web 项目有演示入口页面)。
- 规范约定:coding-standards 已确认。
- 环境变量:已区分 dev/staging/prod,不硬编码。
适用场景
适用于需要在编码前进行技术方案确认、任务拆解和公共模块设计的软件开发项目,尤其是包含 web 前端设计需求的项目。
限制
阶段结束后下一阶段为 coding,并受 stage-gate 规范约束。关于收费、价格、平台支持等具体信息,资料中暂未提供。