SuperAPI AI 工具集

sdlc-planner

编程与开发

查看项目

更新于 10-16 07:12

技能介绍

用途

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 图表达架构、数据模型与流程。
  • 关于收费、价格、平台支持等具体信息,资料中暂未提供。