名称: 功能规格 描述: 软件工程功能规格和规划指南。此技能应用于编写产品需求文档(PRDs)、定义需求、管理范围、优先化特性或处理变更请求。在涉及特性规划、规格编写、利益相关者对齐或范围管理的任务中触发。
软件工程功能规格与规划最佳实践
软件工程师、产品经理和技术主管的综合功能规格和规划指南。包含42个规则，跨越8个类别，按影响优先级排序以防止范围蔓延并确保项目成功。
何时应用
参考这些指南，当：
- 编写PRDs或功能规格
- 定义需求或用户故事
- 管理范围和防止范围蔓延
- 优先化特性和积压项目
- 处理变更请求
- 对齐利益相关者关于项目目标
规则类别按优先级
| 优先级 | 类别 | 影响 | 前缀 |
|---|---|---|---|
| 1 | 范围定义 | 关键 | scope- |
| 2 | 需求清晰度 | 关键 | req- |
| 3 | 优先化框架 | 高 | prio- |
| 4 | 接受标准 | 高 | accept- |
| 5 | 利益相关者对齐 | 中-高 | stake- |
| 6 | 技术规格 | 中 | tech- |
| 7 | 变更管理 | 中 | change- |
| 8 | 文档标准 | 低 | doc- |
快速参考
1. 范围定义 (关键)
scope-define-boundaries- 定义明确的范围边界scope-document-assumptions- 明确记录所有假设scope-work-breakdown- 将范围分解为可衡量的工作项scope-define-mvp- 在完整特性集之前定义最小可行产品(MVP)scope-stakeholder-signoff- 获取利益相关者对范围的签字同意
2. 需求清晰度 (关键)
req-specific-measurable- 编写具体、可衡量的需求req-user-stories- 将需求结构化为用户故事req-avoid-solution-language- 避免特定于解决方案的语言req-functional-nonfunctional- 分离功能和非功能需求req-consistent-terminology- 使用一致的术语req-traceability- 保持需求可追溯性
3. 优先化框架 (高)
prio-moscow-method- 使用MoSCoW优先化方法prio-rice-scoring- 应用RICE评分以实现客观性prio-value-vs-effort- 明确映射价值与努力prio-dependencies-first- 识别并排序依赖项prio-kano-model- 应用Kano模型进行特性分类
4. 接受标准 (高)
accept-given-when-then- 使用Given-When-Then格式accept-testable-criteria- 编写可测试的接受标准accept-edge-cases- 在接受标准中包含边界情况accept-definition-of-done- 定义清晰的完成定义accept-avoid-over-specification- 避免过度规格化
5. 利益相关者对齐 (中-高)
stake-identify-stakeholders- 早期识别所有利益相关者stake-early-feedback- 早期并经常收集反馈stake-conflict-resolution- 明确解决冲突stake-communication-plan- 建立沟通节奏stake-success-metrics- 对齐成功指标
6. 技术规格 (中)
tech-system-context- 文档系统上下文和依赖项tech-api-contracts- 在实施之前定义API合同tech-data-model- 指定数据模型和模式更改tech-error-handling- 规划错误处理和恢复tech-performance-requirements- 指定性能要求tech-security-considerations- 文档安全考虑
7. 变更管理 (中)
change-formal-process- 使用正式的变更请求过程change-impact-assessment- 批准前评估全面影响change-version-tracking- 版本所有规格文档change-scope-freeze- 实施范围冻结期change-defer-log- 维护延期项目日志
8. 文档标准 (低)
doc-single-source- 维护单一来源的真相doc-consistent-templates- 使用一致的文档模板doc-decision-records- 文档关键决策与上下文doc-accessible-format- 保持文档可访问doc-glossary-terms- 定义项目术语