sdlc-planning

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Platform 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
    sdlc-planning
    or would be better handled by a more specific companion skill.
  • 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
    templates
    only as needed.
  • Confirm the desired deliverable: design, code, review, migration plan, audit, or documentation.
  • 收集相关项目背景、约束条件以及具体待解决问题;仅在需要时加载
    templates
  • 确认期望交付物:设计、代码、评审、迁移计划、审计或文档。

Workflow

工作流

  • Read this
    SKILL.md
    first, then load only the referenced deep-dive files that are necessary for the task.
  • 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

生成的证据

CategoryArtifactFormatExample
Release evidenceSDLC planning document setMarkdown docs covering Project Vision & Scope, SDP, SCMP, QA Plan, and Risk Plan
docs/sdlc/planning-2026-04-16.md
类别工件格式示例
发布证据SDLC规划文档集涵盖项目愿景与范围、SDP、SCMP、QA计划和风险计划的Markdown文档
docs/sdlc/planning-2026-04-16.md

References

参考资料

  • Use the
    templates/
    directory when the task needs a structured deliverable.
<!-- dual-compat-end -->
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/
    目录。
<!-- dual-compat-end -->
为软件开发项目生成完整的规划与管理文档套件。本技能会生成7份基础文档,用于在编写任何代码前建立项目基准。

Load Order

加载顺序

  1. Load
    world-class-engineering
    .
  2. Load this skill to define the planning baseline and phase-entry gates.
  3. Pair it with
    engineering-management-system
    ,
    advanced-testing-strategy
    , and
    deployment-release-engineering
    when the plan must be executable.
  1. 加载
    world-class-engineering
  2. 加载本技能以定义规划基准和阶段进入门槛。
  3. 当计划需要具备可执行性时,搭配
    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
    project-requirements
    skill instead
  • Planning a single feature (spec + implementation) -- use
    feature-planning
    skill
  • Planning an Android companion app (PRD, SDS, API Contract) -- use
    mobile-saas-planning
    skill
  • Writing design documents (SDD, architecture, database design) -- use
    sdlc-design
    skill
  • Writing test plans with test cases -- use
    sdlc-testing
    skill
  • Writing deployment or user documentation -- use
    sdlc-user-deploy
    skill
  • 通过访谈收集原始需求——改用
    project-requirements
    技能
  • 规划单个功能(规格说明+实现)——改用
    feature-planning
    技能
  • 规划Android配套应用(PRD、SDS、API契约)——改用
    mobile-saas-planning
    技能
  • 编写设计文档(SDD、架构、数据库设计)——改用
    sdlc-design
    技能
  • 编写带测试用例的测试计划——改用
    sdlc-testing
    技能
  • 编写部署或用户文档——改用
    sdlc-user-deploy
    技能

Document Inventory

文档清单

#DocumentFilePurposeAudienceLength
1Project Vision & Scope
templates/project-vision-scope.md
Establish the "why" and "what"Stakeholders, sponsors, investors15-30 pages
2Software Development Plan
templates/software-development-plan.md
Management & technical approachPM, dev leads, QA20-40 pages
3Configuration Management Plan
templates/configuration-management-plan.md
Change & version control processesDevOps, dev leads, release mgrs15-25 pages
4Quality Assurance Plan
templates/quality-assurance-plan.md
Quality processes & standardsQA team, devs, PM15-25 pages
5Risk Management Plan
templates/risk-management-plan.md
Identify, assess, mitigate risksPM, stakeholders, dev leads15-25 pages
6Software Requirements Spec
templates/software-requirements-spec.md
Full functional & non-functional requirementsDevs, QA, stakeholders, architects30-60 pages
7Feasibility Study Report
templates/feasibility-study-report.md
Viability analysis before commitmentDecision makers, investors, sponsors15-30 pages
#文档文件目的受众篇幅
1项目愿景与范围
templates/project-vision-scope.md
确立项目的“初衷”和“内容”利益相关者、发起人、投资者15-30页
2软件开发计划
templates/software-development-plan.md
管理与技术实施路径项目经理、开发负责人、QA20-40页
3配置管理计划
templates/configuration-management-plan.md
变更与版本控制流程DevOps、开发负责人、发布经理15-25页
4质量保证计划
templates/quality-assurance-plan.md
质量流程与标准QA团队、开发人员、项目经理15-25页
5风险管理计划
templates/risk-management-plan.md
识别、评估并缓解风险项目经理、利益相关者、开发负责人15-25页
6软件需求规格说明
templates/software-requirements-spec.md
完整的功能与非功能需求开发人员、QA、利益相关者、架构师30-60页
7可行性研究报告
templates/feasibility-study-report.md
投入前的可行性分析决策者、投资者、发起人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:
InputSourceRequired?
Project name & domainUser interviewYes
Target market & usersUser interviewYes
Core feature list
project-requirements
output or user
Yes
Tech stack decisionsProject context or defaultsYes
Budget & timeline constraintsUser or stakeholderRecommended
Existing system inventoryCodebase auditIf migrating
Regulatory requirementsUser or domain researchIf applicable
生成任何文档前,需收集或确认以下内容:
输入来源是否必需?
项目名称与领域用户访谈
目标市场与用户用户访谈
核心功能列表
project-requirements
输出或用户提供
技术栈决策项目上下文或默认方案
预算与时间约束用户或利益相关者提供推荐
现有系统清单代码库审计若涉及迁移
合规要求用户或领域研究若适用

Cross-References to Existing Skills

与现有技能的交叉引用

Upstream Skills (use BEFORE this skill)

上游技能(在本技能之前使用)

SkillRelationship
project-requirements
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.
技能关系
project-requirements
通过引导式访谈收集原始需求。将其输出(requirements.md、business-rules.md、user-types.md、workflows.md)输入到本技能的SRS和愿景文档中。

Parallel Skills (use ALONGSIDE this skill)

并行技能(与本技能同时使用)

SkillRelationship
feature-planning
For individual feature specs and implementation plans. This skill covers project-level planning;
feature-planning
covers feature-level planning.
vibe-security-skill
Security baseline for all web applications. Reference in QA Plan and Risk Plan.
技能关系
feature-planning
用于单个功能的规格说明和实施计划。本技能覆盖项目级规划;
feature-planning
覆盖功能级规划。
vibe-security-skill
所有Web应用的安全基准。在QA计划和风险计划中引用。

Downstream Skills (use AFTER this skill)

下游技能(在本技能之后使用)

SkillRelationship
mobile-saas-planning
For Android companion app planning (PRD, SDS, API Contract). Uses this skill's SRS as input.
multi-tenant-saas-architecture
Backend architecture patterns. Uses SDP and SRS as input.
modular-saas-architecture
Pluggable module architecture. Uses SRS module inventory.
saas-seeder
Bootstrap the SaaS template. Uses requirements from SRS.
sdlc-design
Design documentation phase. Uses approved SRS as primary input.
sdlc-testing
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.
技能关系
mobile-saas-planning
用于Android配套应用规划(PRD、SDS、API契约)。以本技能的SRS作为输入。
multi-tenant-saas-architecture
后端架构模式。以SDP和SRS作为输入。
modular-saas-architecture
可插拔模块架构。以SRS模块清单作为输入。
saas-seeder
初始化SaaS模板。以SRS中的需求作为输入。
sdlc-design
设计文档阶段。以获批的SRS作为主要输入。
sdlc-testing
测试文档。使用SRS需求ID实现测试用例可追溯性。
待添加的未来技能(参考ISO/IEC 14764-2006): 软件维护计划(纠正性/适应性/完善性/预防性维护类型)和部署后评估报告目前尚未作为技能实现,但应在项目收尾时生成。

Available SDLC Skills

可用的SDLC技能

SkillPhaseDocuments
sdlc-design
DesignSDD, Database Design, API Design, UI/UX Spec
sdlc-testing
TestingTest Plan, Test Cases, V&V Plan, Test Report, Peer Review
技能阶段文档
sdlc-design
设计SDD、数据库设计、API设计、UI/UX规格说明
sdlc-testing
测试测试计划、测试用例、验证与确认计划、测试报告、同行评审

Available SDLC Skills (continued)

可用的SDLC技能(续)

SkillPhaseDocuments
sdlc-user-deploy
DeliveryUser Manual, Deployment Guide, Release Notes, Training Plan
技能阶段文档
sdlc-user-deploy
交付用户手册、部署指南、发布说明、培训计划

Adaptation Rules

适配规则

SaaS vs Standalone

SaaS vs 独立应用

AspectMulti-Tenant SaaSStandalone App
Data isolationRow-level via
franchise_id
Not applicable
Auth modelDual auth (Session + JWT)Single auth model
Deployment3-env (dev/staging/prod)May be simpler
ScalingPer-tenant growth planningSingle-instance scaling
SRS sectionsInclude NFR-MT (multi-tenancy)Omit multi-tenancy NFRs
Risk registerInclude tenant data leakage risksOmit tenant-specific risks
方面多租户SaaS独立应用
数据隔离通过
franchise_id
实现行级隔离
不适用
认证模型双重认证(Session + JWT)单一认证模型
部署3环境(开发/预发布/生产)可能更简单
扩容按租户增长规划单实例扩容
SRS章节包含NFR-MT(多租户)省略多租户NFR
风险登记册包含租户数据泄露风险省略租户特定风险

Android + Web vs Web-Only

Android+Web vs 仅Web

AspectAndroid + WebWeb-Only
SRS scopeInclude mobile NFRs (offline, app store)Web NFRs only
SDPInclude Android build pipelineWeb pipeline only
SCMPInclude Gradle + PHP configsPHP configs only
QA PlanInclude Android testing (Compose UI, JUnit 5)Web testing only
Risk PlanInclude app store rejection risksOmit 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 完整产品

AspectMVPFull Product
Vision scopeP0 features onlyP0 + P1 + P2 features
SDP phases2-3 phases5-8 phases
SRS depthCore modules onlyAll modules
FeasibilityFocus on technical + economicAll five feasibility types
Risk registerTop 10 risksComprehensive (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.md
Each 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.
GateDA MilestoneTriggered ByExit Criteria
G1Stakeholder VisionEnd of Skill 01–03Vision documented; stakeholder register complete; scope agreed with Out of Scope listed; domain confirmed
G2Proven ArchitectureEnd of Skill 04Interface spec complete; architecture strategy selected; key risks identified; no unresolved [CONTEXT-GAP] tags
G3Requirements CompleteEnd of Skill 05All FRs have GWT stubs; all NFRs have SMART metrics; every FR traced to business goal; zero [V&V-FAIL] tags
G4Logic ValidatedEnd of Skill 06–07All LaTeX formulas verified; attribute mapping complete; no conflicts in Section 3.4
G5Audit PassedEnd of Skill 08Zero [V&V-FAIL], [GLOSSARY-GAP], [TRACE-GAP], [SMART-FAIL] tags; SRS approved by consultant
G6Production ReadyPost-testingTest 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
    ## Out of Scope
    subsection
  • Every NFR is SMART: Specific, Measurable, Achievable, Relevant, Time-bound — flag
    [V&V-FAIL: SMART metric not defined]
    for any that are not
  • 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
    vibe-security-skill
    for security quality gates
  • 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-PatternWhy It FailsDo This Instead
Skip feasibility, jump to codingWastes resources on unviable projectsAlways do feasibility first
Copy-paste generic templatesDocuments don't match your projectCustomize every section to your context
Write SRS without stakeholder inputRequirements will be wrongUse
project-requirements
skill first
No measurable success metricsCan't tell if project succeededDefine KPIs with specific numeric targets
Ignore multi-tenant requirementsData leakage between tenantsAlways include NFR-MT requirements
One massive documentExceeds 500-line limit, hard to maintainSplit into index + sub-files
No risk registerRisks become surprisesPre-populate with common SaaS risks
Skip configuration managementDeployment chaos, lost changesDocument branching, releases, migrations
Write plans and never update themPlans become stale and uselessReview and update at each phase gate
Omit Out of Scope section from SRSScope creep is invisibleSRS Section 1.2 must include explicit
## Out of Scope
subsection
Vague NFRs without SMART metricsCannot verify or test non-functional requirementsEach NFR must be Specific, Measurable, Achievable, Relevant, Time-bound
No Given-When-Then acceptance stubsRequirements written without verification linkageAdd inline
**Acceptance:** Given [state], When [action], Then [outcome]
to every SHALL requirement
Prioritize only by gut feelHigh-value work delayed; delivery misaligned with businessUse Cost of Delay (CoD) for time-sensitive requirements alongside MoSCoW
反模式失败原因正确做法
跳过可行性研究,直接编码在不可行的项目上浪费资源始终先开展可行性研究
复制粘贴通用模板文档与项目不匹配根据上下文定制每个章节
未征求利益相关者意见就编写SRS需求会出现错误先使用
project-requirements
技能
无衡量性的成功指标无法判断项目是否成功定义带有具体数值目标的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.
  1. Project Vision & Scope
  2. Software Development Plan
  3. Configuration Management Plan
  4. Quality Assurance Plan
  5. Risk Management Plan
  6. Software Requirements Specification
  7. Feasibility Study Report
每个模板都提供完整的结构、逐节指导、示例片段、反模式以及质量检查清单。
  1. 项目愿景与范围
  2. 软件开发计划
  3. 配置管理计划
  4. 质量保证计划
  5. 风险管理计划
  6. 软件需求规格说明
  7. 可行性研究报告

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进行强化)