用途
SDLC Planner 用于把一句高层级的产品指令,转化为结构化的项目规划文档,覆盖软件开发生命周期(SDLC)的 Phase 1(需求分析)与 Phase 2(系统设计)。它生成的是可直接用于实施的文档,而不是代码。
主要能力
- 从单一自然语言输入推断产品领域(Web 应用、移动应用、后端/API、CLI 工具、CI/CD 流水线、数据平台、IoT 系统、桌面应用、浏览器扩展、SaaS 平台、电商、实时系统等),并据此调整架构风格。
- 生成完整的需求分析文档,包括问题定义、目标与成功指标、干系人与用户画像、功能需求、非功能需求、假设与约束、范围外内容。
- 生成系统设计文档,包括系统概览、架构决策记录(ADR)、高层架构、数据模型、核心流程、非功能设计。
- 生成未来阶段概览,包括实施计划、测试策略、部署概览。
- 使用 Mermaid 图表达架构、ER 模型与序列流程。
- 采用 MoSCoW 优先级(Must/Should/Could/Won't)组织功能需求。
使用方式
用户提供一句描述软件产品的自然语言指令,例如“我需要一个追踪个人开支的应用”“为远程团队构建实时协作白板”“创建一个支持回滚的 CI/CD 流水线管理器”等。技能会先解析输出路径配置:检查项目根目录下的 cognitive.config.json,若存在则读取 output_base;若不存在,则推断项目名并询问用户输出位置,建议默认 ~/obsidian-vault/{project-name}/,随后创建配置文件。之后按工作流执行:分析产品想法、创建目录结构、生成 README、生成 Phase 1 需求分析、生成 Phase 2 系统设计、生成未来阶段概览、校验完整性。
输出目录结构为:
{output_base}/sdlc/{project-name}/
├── README.md
├── requirement-analysis/
│ ├── 01-problem-definition.md
│ ├── 02-goals-and-success-metrics.md
│ ├── 03-stakeholders-and-personas.md
│ ├── 04-functional-requirements.md
│ ├── 05-non-functional-requirements.md
│ ├── 06-assumptions-and-constraints.md
│ └── 07-out-of-scope.md
├── design/
│ ├── 01-system-overview.md
│ ├── 02-architecture-decisions.md
│ ├── 03-high-level-architecture.md
│ ├── 04-data-model.md
│ ├── 05-core-flows.md
│ └── 06-non-functional-design.md
└── future-phases/
├── implementation-plan.md
├── testing-strategy.md
└── deployment-overview.md
项目名使用 kebab-case 从输入推断,例如“expense tracker app”对应 expense-tracker。
适用场景
- 用户描述产品想法、应用概念或想构建的系统。
- 用户需要为新项目做结构化需求分析。
- 用户需要在实现前获得系统设计文档。
- 用户希望把模糊想法正式化为专业工程文档。
- 用户启动新项目并需要 Phase 1 + Phase 2 产物。
- 用户希望在写代码前记录架构决策。
限制
- 只产出 Markdown 文档,不生成源代码、配置文件或可执行脚本。
- 不向用户追问澄清问题,所有假设写入 06-assumptions-and-constraints.md。
- 不适用于冲刺规划或任务拆分(应使用 project-planner)、代码实现、代码审查或调试、部署或 CI/CD 流水线配置。
- 若项目已有完整需求与设计文档,则不应使用。
- 输出必须完整生成全部 17 个文件,不得跳过或留空。
- 文档需具体、可实施,避免“快速”“安全”“用户友好”等未量化的模糊表述。
- 架构决策需以 ADR 格式记录上下文、决策、备选方案与后果。
- 跨文件引用使用相对链接,避免内容重复或孤立引用。
- 需定义可实现的 MVP 范围,并明确将功能推迟到后续阶段。
- 尽可能使用 Mermaid 图表达架构、数据模型与流程。
- 关于收费、价格、平台支持等具体信息,资料中暂未提供。