sdlc-planning
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChinesePlatform Notes
平台说明
- Optional helper plugins may help in some environments, but they must not be treated as required for this skill.
- 可选辅助插件在部分环境中可能有所帮助,但不得将其视为使用本技能的必需组件。
SDLC Planning Skill
SDLC规划技能
<!-- dual-compat-start -->
<!-- dual-compat-start -->
Use When
适用场景
- Generate Planning & Management documentation for SDLC projects. Covers Project Vision & Scope, SDP, SCMP, QA Plan, Risk Plan, SRS, and Feasibility Study. Use when starting a new project, conducting project governance, or establishing the planning...
- The task needs reusable judgment, domain constraints, or a proven workflow rather than ad hoc advice.
- 为SDLC项目生成规划与管理文档。涵盖项目愿景与范围、SDP、SCMP、QA计划、风险计划、SRS以及可行性研究。适用于新项目启动、项目治理实施或规划体系建立等场景...
- 任务需要可复用的判断逻辑、领域约束或成熟的工作流,而非临时建议。
Do Not Use When
不适用场景
- The task is unrelated to or would be better handled by a more specific companion skill.
sdlc-planning - The request only needs a trivial answer and none of this skill's constraints or references materially help.
- 任务与无关,或更适合由更专业的配套技能处理。
sdlc-planning - 请求仅需要简单答案,本技能的约束条件或参考内容无法提供实质性帮助。
Required Inputs
必需输入
- Gather relevant project context, constraints, and the concrete problem to solve; load only as needed.
templates - Confirm the desired deliverable: design, code, review, migration plan, audit, or documentation.
- 收集相关项目背景、约束条件以及具体待解决问题;仅在需要时加载。
templates - 确认期望交付物:设计、代码、评审、迁移计划、审计或文档。
Workflow
工作流
- Read this first, then load only the referenced deep-dive files that are necessary for the task.
SKILL.md - Apply the ordered guidance, checklists, and decision rules in this skill instead of cherry-picking isolated snippets.
- Produce the deliverable with assumptions, risks, and follow-up work made explicit when they matter.
- 首先阅读本,然后仅加载任务所需的相关深度参考文件。
SKILL.md - 应用本技能中的有序指导、检查清单和决策规则,而非随意挑选孤立片段。
- 生成交付物时,若相关需明确说明假设条件、风险以及后续工作。
Quality Standards
质量标准
- Keep outputs execution-oriented, concise, and aligned with the repository's baseline engineering standards.
- Preserve compatibility with existing project conventions unless the skill explicitly requires a stronger standard.
- Prefer deterministic, reviewable steps over vague advice or tool-specific magic.
- 输出内容需以执行为导向、简洁明了,并与仓库的基线工程标准保持一致。
- 除非技能明确要求更高标准,否则需与现有项目约定保持兼容。
- 优先采用可确定、可评审的步骤,而非模糊建议或工具特定的“魔法操作”。
Anti-Patterns
反模式
- Treating examples as copy-paste truth without checking fit, constraints, or failure modes.
- Loading every reference file by default instead of using progressive disclosure.
- 将示例视为可直接复制粘贴的内容,而不检查是否适配、约束条件或失败模式。
- 默认加载所有参考文件,而非逐步按需披露。
Outputs
输出内容
- A concrete result that fits the task: implementation guidance, review findings, architecture decisions, templates, or generated artifacts.
- Clear assumptions, tradeoffs, or unresolved gaps when the task cannot be completed from available context alone.
- References used, companion skills, or follow-up actions when they materially improve execution.
- 符合任务要求的具体结果:实施指导、评审结论、架构决策、模板或生成的工件。
- 当仅靠现有上下文无法完成任务时,需明确说明假设条件、权衡方案或未解决的缺口。
- 当能实质性提升执行效果时,需列出使用的参考内容、配套技能或后续行动。
Evidence Produced
生成的证据
| Category | Artifact | Format | Example |
|---|---|---|---|
| Release evidence | SDLC planning document set | Markdown docs covering Project Vision & Scope, SDP, SCMP, QA Plan, and Risk Plan | |
| 类别 | 工件 | 格式 | 示例 |
|---|---|---|---|
| 发布证据 | SDLC规划文档集 | 涵盖项目愿景与范围、SDP、SCMP、QA计划和风险计划的Markdown文档 | |
References
参考资料
- Use the directory when the task needs a structured deliverable.
templates/
Generate a complete Planning & Management documentation suite for software development projects. This skill produces 7 foundational documents that establish the project baseline before any code is written.
- 当任务需要结构化交付物时,使用目录。
templates/
为软件开发项目生成完整的规划与管理文档套件。本技能会生成7份基础文档,用于在编写任何代码前建立项目基准。
Load Order
加载顺序
- Load .
world-class-engineering - Load this skill to define the planning baseline and phase-entry gates.
- Pair it with ,
engineering-management-system, andadvanced-testing-strategywhen the plan must be executable.deployment-release-engineering
- 加载。
world-class-engineering - 加载本技能以定义规划基准和阶段进入门槛。
- 当计划需要具备可执行性时,搭配、
engineering-management-system和advanced-testing-strategy使用。deployment-release-engineering
Executable Planning Standard
可执行规划标准
Planning documents must define more than scope. They must define:
- critical flows and risk class
- measurable success criteria and service expectations
- delivery slices and release assumptions
- testing, observability, and rollback expectations
- ownership for decisions, operations, and follow-up
规划文档不能仅定义范围,还必须明确:
- 关键流程和风险等级
- 可衡量的成功标准和服务预期
- 交付切片和发布假设
- 测试、可观测性和回滚预期
- 决策、运维和后续工作的负责人
When to Use
适用场景
- Starting a new SaaS project and need a governance baseline
- Establishing project planning documents for stakeholders or investors
- Conducting a feasibility study before committing resources
- Setting up configuration management and quality assurance processes
- Creating a software development plan for the team
- Building a risk management framework for an upcoming project
- Preparing a full-system SRS (not just requirements interview or Android-only)
- 启动新SaaS项目并需要治理基准
- 为利益相关者或投资者准备项目规划文档
- 在投入资源前开展可行性研究
- 建立配置管理和质量保证流程
- 为团队制定软件开发计划
- 为即将启动的项目构建风险管理框架
- 准备全系统SRS(不仅是需求访谈或仅适用于Android的版本)
When NOT to Use
不适用场景
- Gathering raw requirements via interview -- use skill instead
project-requirements - Planning a single feature (spec + implementation) -- use skill
feature-planning - Planning an Android companion app (PRD, SDS, API Contract) -- use skill
mobile-saas-planning - Writing design documents (SDD, architecture, database design) -- use skill
sdlc-design - Writing test plans with test cases -- use skill
sdlc-testing - Writing deployment or user documentation -- use skill
sdlc-user-deploy
- 通过访谈收集原始需求——改用技能
project-requirements - 规划单个功能(规格说明+实现)——改用技能
feature-planning - 规划Android配套应用(PRD、SDS、API契约)——改用技能
mobile-saas-planning - 编写设计文档(SDD、架构、数据库设计)——改用技能
sdlc-design - 编写带测试用例的测试计划——改用技能
sdlc-testing - 编写部署或用户文档——改用技能
sdlc-user-deploy
Document Inventory
文档清单
| # | Document | File | Purpose | Audience | Length |
|---|---|---|---|---|---|
| 1 | Project Vision & Scope | | Establish the "why" and "what" | Stakeholders, sponsors, investors | 15-30 pages |
| 2 | Software Development Plan | | Management & technical approach | PM, dev leads, QA | 20-40 pages |
| 3 | Configuration Management Plan | | Change & version control processes | DevOps, dev leads, release mgrs | 15-25 pages |
| 4 | Quality Assurance Plan | | Quality processes & standards | QA team, devs, PM | 15-25 pages |
| 5 | Risk Management Plan | | Identify, assess, mitigate risks | PM, stakeholders, dev leads | 15-25 pages |
| 6 | Software Requirements Spec | | Full functional & non-functional requirements | Devs, QA, stakeholders, architects | 30-60 pages |
| 7 | Feasibility Study Report | | Viability analysis before commitment | Decision makers, investors, sponsors | 15-30 pages |
| # | 文档 | 文件 | 目的 | 受众 | 篇幅 |
|---|---|---|---|---|---|
| 1 | 项目愿景与范围 | | 确立项目的“初衷”和“内容” | 利益相关者、发起人、投资者 | 15-30页 |
| 2 | 软件开发计划 | | 管理与技术实施路径 | 项目经理、开发负责人、QA | 20-40页 |
| 3 | 配置管理计划 | | 变更与版本控制流程 | DevOps、开发负责人、发布经理 | 15-25页 |
| 4 | 质量保证计划 | | 质量流程与标准 | QA团队、开发人员、项目经理 | 15-25页 |
| 5 | 风险管理计划 | | 识别、评估并缓解风险 | 项目经理、利益相关者、开发负责人 | 15-25页 |
| 6 | 软件需求规格说明 | | 完整的功能与非功能需求 | 开发人员、QA、利益相关者、架构师 | 30-60页 |
| 7 | 可行性研究报告 | | 投入前的可行性分析 | 决策者、投资者、发起人 | 15-30页 |
Generation Workflow
生成工作流
Generate documents in this order. Each builds on the previous.
Step 1: Gather context (use project-requirements skill if not done)
|
Step 2: Feasibility Study Report (Go/No-Go decision)
|
Step 3: Project Vision & Scope (approved vision)
|
Step 4: Software Requirements Specification (full requirements)
|
Step 5: Software Development Plan (how to build it)
|
Step 6: Configuration Management Plan (how to manage changes)
|
Step 7: Quality Assurance Plan (how to ensure quality)
|
Step 8: Risk Management Plan (what can go wrong)按以下顺序生成文档,每份文档都基于前一份内容构建。
Step 1: 收集上下文(若未完成,使用project-requirements技能)
|
Step 2: 可行性研究报告(做出启动/不启动决策)
|
Step 3: 项目愿景与范围(已获批的愿景)
|
Step 4: 软件需求规格说明(完整需求)
|
Step 5: 软件开发计划(实现方案)
|
Step 6: 配置管理计划(变更管理方式)
|
Step 7: 质量保证计划(质量保障方式)
|
Step 8: 风险管理计划(潜在风险应对)Prerequisites
前置条件
Before generating any documents, gather or confirm:
| Input | Source | Required? |
|---|---|---|
| Project name & domain | User interview | Yes |
| Target market & users | User interview | Yes |
| Core feature list | | Yes |
| Tech stack decisions | Project context or defaults | Yes |
| Budget & timeline constraints | User or stakeholder | Recommended |
| Existing system inventory | Codebase audit | If migrating |
| Regulatory requirements | User or domain research | If applicable |
生成任何文档前,需收集或确认以下内容:
| 输入 | 来源 | 是否必需? |
|---|---|---|
| 项目名称与领域 | 用户访谈 | 是 |
| 目标市场与用户 | 用户访谈 | 是 |
| 核心功能列表 | | 是 |
| 技术栈决策 | 项目上下文或默认方案 | 是 |
| 预算与时间约束 | 用户或利益相关者提供 | 推荐 |
| 现有系统清单 | 代码库审计 | 若涉及迁移 |
| 合规要求 | 用户或领域研究 | 若适用 |
Cross-References to Existing Skills
与现有技能的交叉引用
Upstream Skills (use BEFORE this skill)
上游技能(在本技能之前使用)
| Skill | Relationship |
|---|---|
| Gathers raw requirements via guided interview. Feed its output (requirements.md, business-rules.md, user-types.md, workflows.md) into this skill's SRS and Vision documents. |
| 技能 | 关系 |
|---|---|
| 通过引导式访谈收集原始需求。将其输出(requirements.md、business-rules.md、user-types.md、workflows.md)输入到本技能的SRS和愿景文档中。 |
Parallel Skills (use ALONGSIDE this skill)
并行技能(与本技能同时使用)
| Skill | Relationship |
|---|---|
| For individual feature specs and implementation plans. This skill covers project-level planning; |
| Security baseline for all web applications. Reference in QA Plan and Risk Plan. |
| 技能 | 关系 |
|---|---|
| 用于单个功能的规格说明和实施计划。本技能覆盖项目级规划; |
| 所有Web应用的安全基准。在QA计划和风险计划中引用。 |
Downstream Skills (use AFTER this skill)
下游技能(在本技能之后使用)
| Skill | Relationship |
|---|---|
| For Android companion app planning (PRD, SDS, API Contract). Uses this skill's SRS as input. |
| Backend architecture patterns. Uses SDP and SRS as input. |
| Pluggable module architecture. Uses SRS module inventory. |
| Bootstrap the SaaS template. Uses requirements from SRS. |
| Design documentation phase. Uses approved SRS as primary input. |
| Testing documentation. Uses SRS requirement IDs for test case traceability. |
Future skills to add (identified from ISO/IEC 14764-2006): Software Maintenance Plan (Corrective/Adaptive/Perfective/Preventive maintenance types) and Post-Deployment Evaluation Report are not yet implemented as skills but should be generated at project close.
| 技能 | 关系 |
|---|---|
| 用于Android配套应用规划(PRD、SDS、API契约)。以本技能的SRS作为输入。 |
| 后端架构模式。以SDP和SRS作为输入。 |
| 可插拔模块架构。以SRS模块清单作为输入。 |
| 初始化SaaS模板。以SRS中的需求作为输入。 |
| 设计文档阶段。以获批的SRS作为主要输入。 |
| 测试文档。使用SRS需求ID实现测试用例可追溯性。 |
待添加的未来技能(参考ISO/IEC 14764-2006): 软件维护计划(纠正性/适应性/完善性/预防性维护类型)和部署后评估报告目前尚未作为技能实现,但应在项目收尾时生成。
Available SDLC Skills
可用的SDLC技能
| Skill | Phase | Documents |
|---|---|---|
| Design | SDD, Database Design, API Design, UI/UX Spec |
| Testing | Test Plan, Test Cases, V&V Plan, Test Report, Peer Review |
| 技能 | 阶段 | 文档 |
|---|---|---|
| 设计 | SDD、数据库设计、API设计、UI/UX规格说明 |
| 测试 | 测试计划、测试用例、验证与确认计划、测试报告、同行评审 |
Available SDLC Skills (continued)
可用的SDLC技能(续)
| Skill | Phase | Documents |
|---|---|---|
| Delivery | User Manual, Deployment Guide, Release Notes, Training Plan |
| 技能 | 阶段 | 文档 |
|---|---|---|
| 交付 | 用户手册、部署指南、发布说明、培训计划 |
Adaptation Rules
适配规则
SaaS vs Standalone
SaaS vs 独立应用
| Aspect | Multi-Tenant SaaS | Standalone App |
|---|---|---|
| Data isolation | Row-level via | Not applicable |
| Auth model | Dual auth (Session + JWT) | Single auth model |
| Deployment | 3-env (dev/staging/prod) | May be simpler |
| Scaling | Per-tenant growth planning | Single-instance scaling |
| SRS sections | Include NFR-MT (multi-tenancy) | Omit multi-tenancy NFRs |
| Risk register | Include tenant data leakage risks | Omit tenant-specific risks |
| 方面 | 多租户SaaS | 独立应用 |
|---|---|---|
| 数据隔离 | 通过 | 不适用 |
| 认证模型 | 双重认证(Session + JWT) | 单一认证模型 |
| 部署 | 3环境(开发/预发布/生产) | 可能更简单 |
| 扩容 | 按租户增长规划 | 单实例扩容 |
| SRS章节 | 包含NFR-MT(多租户) | 省略多租户NFR |
| 风险登记册 | 包含租户数据泄露风险 | 省略租户特定风险 |
Android + Web vs Web-Only
Android+Web vs 仅Web
| Aspect | Android + Web | Web-Only |
|---|---|---|
| SRS scope | Include mobile NFRs (offline, app store) | Web NFRs only |
| SDP | Include Android build pipeline | Web pipeline only |
| SCMP | Include Gradle + PHP configs | PHP configs only |
| QA Plan | Include Android testing (Compose UI, JUnit 5) | Web testing only |
| Risk Plan | Include app store rejection risks | Omit mobile risks |
| 方面 | Android+Web | 仅Web |
|---|---|---|
| SRS范围 | 包含移动端NFR(离线、应用商店) | 仅包含Web端NFR |
| SDP | 包含Android构建流水线 | 仅包含Web构建流水线 |
| SCMP | 包含Gradle + PHP配置 | 仅包含PHP配置 |
| QA计划 | 包含Android测试(Compose UI、JUnit 5) | 仅包含Web测试 |
| 风险计划 | 包含应用商店审核拒绝风险 | 省略移动端风险 |
MVP vs Full Product
MVP vs 完整产品
| Aspect | MVP | Full Product |
|---|---|---|
| Vision scope | P0 features only | P0 + P1 + P2 features |
| SDP phases | 2-3 phases | 5-8 phases |
| SRS depth | Core modules only | All modules |
| Feasibility | Focus on technical + economic | All five feasibility types |
| Risk register | Top 10 risks | Comprehensive (20-30 risks) |
| 方面 | MVP | 完整产品 |
|---|---|---|
| 愿景范围 | 仅P0功能 | P0 + P1 + P2功能 |
| SDP阶段 | 2-3个阶段 | 5-8个阶段 |
| SRS深度 | 仅核心模块 | 所有模块 |
| 可行性 | 聚焦技术+经济可行性 | 所有五种可行性类型 |
| 风险登记册 | 前10大风险 | 全面覆盖(20-30个风险) |
Output Structure
输出结构
When generating documents for a project, create this structure:
docs/planning/
├── 01-feasibility-study.md
├── 02-project-vision-scope.md
├── 03-software-requirements-spec.md
├── 03-srs/
│ ├── functional-requirements.md
│ ├── non-functional-requirements.md
│ └── traceability-matrix.md
├── 04-software-development-plan.md
├── 05-configuration-management-plan.md
├── 06-quality-assurance-plan.md
└── 07-risk-management-plan.mdEach file must stay under 500 lines. Split into subdirectories as needed.
为项目生成文档时,需创建以下结构:
docs/planning/
├── 01-feasibility-study.md
├── 02-project-vision-scope.md
├── 03-software-requirements-spec.md
├── 03-srs/
│ ├── functional-requirements.md
│ ├── non-functional-requirements.md
│ └── traceability-matrix.md
├── 04-software-development-plan.md
├── 05-configuration-management-plan.md
├── 06-quality-assurance-plan.md
└── 07-risk-management-plan.md每个文件不得超过500行。必要时拆分到子目录中。
Phase Gate Exit Criteria
阶段门槛退出标准
Every project passes through six risk-based milestones (Disciplined Agile, 2020). Each milestone has mandatory exit criteria verified before proceeding. These map to the six DA milestones.
| Gate | DA Milestone | Triggered By | Exit Criteria |
|---|---|---|---|
| G1 | Stakeholder Vision | End of Skill 01–03 | Vision documented; stakeholder register complete; scope agreed with Out of Scope listed; domain confirmed |
| G2 | Proven Architecture | End of Skill 04 | Interface spec complete; architecture strategy selected; key risks identified; no unresolved [CONTEXT-GAP] tags |
| G3 | Requirements Complete | End of Skill 05 | All FRs have GWT stubs; all NFRs have SMART metrics; every FR traced to business goal; zero [V&V-FAIL] tags |
| G4 | Logic Validated | End of Skill 06–07 | All LaTeX formulas verified; attribute mapping complete; no conflicts in Section 3.4 |
| G5 | Audit Passed | End of Skill 08 | Zero [V&V-FAIL], [GLOSSARY-GAP], [TRACE-GAP], [SMART-FAIL] tags; SRS approved by consultant |
| G6 | Production Ready | Post-testing | Test plan complete; no open must-fix defects; Go/No-Go approved in phase exit meeting |
Anti-pattern: Advancing to the next gate without resolving all tags from the current gate propagates defects downstream. One unresolved [V&V-FAIL] at G3 typically generates 5–10 downstream rework items.
每个项目需经过六个基于风险的里程碑(Disciplined Agile, 2020)。每个里程碑都有必须验证的退出标准,通过后方可推进。这些标准对应六个DA里程碑。
| 门槛 | DA里程碑 | 触发条件 | 退出标准 |
|---|---|---|---|
| G1 | 利益相关者愿景 | 完成技能01–03 | 愿景已文档化;利益相关者登记册完整;范围已达成一致并列出超出范围内容;领域已确认 |
| G2 | 验证过的架构 | 完成技能04 | 接口规格说明完整;架构策略已选定;关键风险已识别;无未解决的[CONTEXT-GAP]标签 |
| G3 | 需求完成 | 完成技能05 | 所有功能需求(FR)都有GWT存根;所有非功能需求(NFR)都有SMART指标;每个FR都关联到业务目标;零[V&V-FAIL]标签 |
| G4 | 逻辑验证 | 完成技能06–07 | 所有LaTeX公式已验证;属性映射完成;第3.4节无冲突 |
| G5 | 审核通过 | 完成技能08 | 零[V&V-FAIL]、[GLOSSARY-GAP]、[TRACE-GAP]、[SMART-FAIL]标签;SRS已获顾问批准 |
| G6 | 生产就绪 | 测试后 | 测试计划完整;无未修复的严重缺陷;阶段退出会议已批准启动/不启动决策 |
反模式: 未解决当前门槛的所有标签就推进到下一个门槛,会将缺陷传播到下游。G3阶段一个未解决的[V&V-FAIL]标签通常会导致下游产生5–10个返工项。
Quality Checklist
质量检查清单
Run after generating all documents:
- All 7 documents generated (or justified why one was skipped)
- Each document stays under 500 lines (split if needed)
- Vision & Scope has measurable success metrics with numeric targets
- SRS has numbered requirement IDs (FR-MOD-001, NFR-PERF-001)
- SRS Section 1.2 includes an explicit subsection
## Out of Scope - Every NFR is SMART: Specific, Measurable, Achievable, Relevant, Time-bound — flag for any that are not
[V&V-FAIL: SMART metric not defined] - Every SHALL requirement has an inline acceptance stub:
**Acceptance:** Given [state], When [action], Then [outcome] - Requirements are prioritized using MoSCoW; time-sensitive features additionally scored with Cost of Delay
- SDP references the correct tech stack with version numbers
- SCMP describes the actual Git branching strategy being used
- QA Plan references for security quality gates
vibe-security-skill - Risk Register includes at least 8 pre-populated SaaS-specific risks
- Feasibility Study ends with a clear Go/No-Go/Conditional recommendation
- All documents cross-reference each other where relevant
- Multi-tenant isolation addressed in SRS, QA Plan, and Risk Plan
- Deployment environments (Windows dev, Ubuntu staging, Debian prod) documented in SDP
- Release, rollback, and post-deploy observation assumptions are documented in the plan set
- No vague language ("user-friendly", "fast", "secure") -- all measurable
- Examples are tailored to the project's actual tech stack and domain
生成所有文档后执行以下检查:
- 已生成全部7份文档(或已说明跳过某份的理由)
- 每份文档不超过500行(必要时拆分)
- 愿景与范围包含可衡量的成功指标及数值目标
- SRS包含编号的需求ID(FR-MOD-001、NFR-PERF-001)
- SRS第1.2节包含明确的小节
## 超出范围 - 每个NFR都是SMART的:具体、可衡量、可实现、相关、有时限——若不符合则标记
[V&V-FAIL: SMART metric not defined] - 每个SHALL需求都包含内联验收存根:
**验收标准:** 给定[状态],当执行[操作],则得到[结果] - 使用MoSCoW方法对需求进行优先级排序;对时间敏感的功能额外使用延迟成本(Cost of Delay)评分
- SDP引用了正确的技术栈及版本号
- SCMP描述了实际使用的Git分支策略
- QA计划引用了作为安全质量门槛
vibe-security-skill - 风险登记册包含至少8个预填充的SaaS特定风险
- 可行性研究报告结尾给出明确的启动/不启动/有条件启动建议
- 所有相关文档之间都有交叉引用
- SRS、QA计划和风险计划中都涉及多租户隔离问题
- SDP中记录了部署环境(Windows开发、Ubuntu预发布、Debian生产)
- 计划集中记录了发布、回滚和部署后观测的假设条件
- 无模糊表述(如“用户友好”、“快速”、“安全”)——所有内容均可衡量
- 示例已根据项目实际技术栈和领域进行定制
Anti-Patterns (What NOT to Do)
反模式(切勿执行)
| Anti-Pattern | Why It Fails | Do This Instead |
|---|---|---|
| Skip feasibility, jump to coding | Wastes resources on unviable projects | Always do feasibility first |
| Copy-paste generic templates | Documents don't match your project | Customize every section to your context |
| Write SRS without stakeholder input | Requirements will be wrong | Use |
| No measurable success metrics | Can't tell if project succeeded | Define KPIs with specific numeric targets |
| Ignore multi-tenant requirements | Data leakage between tenants | Always include NFR-MT requirements |
| One massive document | Exceeds 500-line limit, hard to maintain | Split into index + sub-files |
| No risk register | Risks become surprises | Pre-populate with common SaaS risks |
| Skip configuration management | Deployment chaos, lost changes | Document branching, releases, migrations |
| Write plans and never update them | Plans become stale and useless | Review and update at each phase gate |
| Omit Out of Scope section from SRS | Scope creep is invisible | SRS Section 1.2 must include explicit |
| Vague NFRs without SMART metrics | Cannot verify or test non-functional requirements | Each NFR must be Specific, Measurable, Achievable, Relevant, Time-bound |
| No Given-When-Then acceptance stubs | Requirements written without verification linkage | Add inline |
| Prioritize only by gut feel | High-value work delayed; delivery misaligned with business | Use Cost of Delay (CoD) for time-sensitive requirements alongside MoSCoW |
| 反模式 | 失败原因 | 正确做法 |
|---|---|---|
| 跳过可行性研究,直接编码 | 在不可行的项目上浪费资源 | 始终先开展可行性研究 |
| 复制粘贴通用模板 | 文档与项目不匹配 | 根据上下文定制每个章节 |
| 未征求利益相关者意见就编写SRS | 需求会出现错误 | 先使用 |
| 无衡量性的成功指标 | 无法判断项目是否成功 | 定义带有具体数值目标的KPI |
| 忽略多租户需求 | 租户间数据泄露 | 始终包含NFR-MT需求 |
| 单个超大文档 | 超出500行限制,难以维护 | 拆分为索引+子文件 |
| 无风险登记册 | 风险会变成意外事件 | 预填充常见SaaS风险 |
| 跳过配置管理 | 部署混乱,变更丢失 | 记录分支策略、发布流程、迁移方案 |
| 编写计划后从不更新 | 计划过时失效 | 在每个阶段门槛处评审并更新 |
| SRS中省略超出范围章节 | 范围蔓延不可见 | SRS第1.2节必须包含明确的 |
| 模糊的NFR,无SMART指标 | 无法验证或测试非功能需求 | 每个NFR都必须是具体、可衡量、可实现、相关、有时限的 |
| 无Given-When-Then验收存根 | 需求编写未关联验证机制 | 为每个SHALL需求添加内联 |
| 仅凭直觉确定优先级 | 高价值工作延迟;交付与业务目标不一致 | 对时间敏感的需求,在MoSCoW基础上使用延迟成本(CoD)评分 |
Template Files
模板文件
Each template provides the complete structure, section-by-section guidance, example excerpts, anti-patterns, and a quality checklist.
- Project Vision & Scope
- Software Development Plan
- Configuration Management Plan
- Quality Assurance Plan
- Risk Management Plan
- Software Requirements Specification
- Feasibility Study Report
每个模板都提供完整的结构、逐节指导、示例片段、反模式以及质量检查清单。
- 项目愿景与范围
- 软件开发计划
- 配置管理计划
- 质量保证计划
- 风险管理计划
- 软件需求规格说明
- 可行性研究报告
References
参考资料
- ../sdlc-lifecycle.md: Shared SDLC execution model and lifecycle gates.
Back to: Skills Repository
Related: project-requirements | feature-planning | mobile-saas-planning
Last Updated: 2026-03-15 (strengthened per Adjei 2023, Winston, Etter 2016, Cone 2023)
- ../sdlc-lifecycle.md:共享的SDLC执行模型和生命周期门槛。
返回: 技能仓库
相关技能: project-requirements | feature-planning | mobile-saas-planning
最后更新: 2026-03-15(参考Adjei 2023、Winston、Etter 2016、Cone 2023进行强化)