关于 feature-spec
面向软件工程师、产品经理和技术负责人的规划参考技能,用于编写规格说明并管理功能范围。规则按影响程度排列,涵盖需求、验收标准、利益相关者协作、技术细节和变更管理。
主要功能
- 01界定范围边界并定义 MVP
- 02编写可衡量且可追踪的需求
- 03使用 MoSCoW 和 RICE 排序
- 04制定可测试的验收标准
- 05管理利益相关者与变更
适用场景
- 01编写 PRD 和功能规格说明
- 02排列功能及待办事项优先级
- 03评估变更请求及其影响
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ pproenca/ dot-skills --skill feature-spec安装后在 Claude Code 中输入/feature-spec确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
AGENTS.mdmetadata.jsonREADME.mdassets/templates/_template.mdreferences/_sections.mdaccept-avoid-over-specification.mdaccept-definition-of-done.mdaccept-edge-cases.mdaccept-given-when-then.mdaccept-testable-criteria.mdchange-defer-log.mdchange-formal-process.mdchange-impact-assessment.mdchange-scope-freeze.mdchange-version-tracking.mddoc-accessible-format.mddoc-consistent-templates.mddoc-decision-records.mddoc-glossary-terms.mddoc-single-source.mdprio-dependencies-first.mdprio-kano-model.mdprio-moscow-method.mdprio-rice-scoring.mdprio-value-vs-effort.mdreq-avoid-solution-language.mdreq-consistent-terminology.mdreq-functional-nonfunctional.mdreq-specific-measurable.mdreq-traceability.md详细介绍
软件工程功能规格说明与规划最佳实践
为软件工程师、产品经理和技术负责人编写的全面功能规格说明与规划指南。包含 8 个类别中的 42 条规则,按影响程度排序,以防止范围蔓延并确保项目成功。
适用场景
在以下情况下参考这些指南:
- 编写 PRD 或功能规格说明
- 定义需求或用户故事
- 管理范围并防止范围蔓延
- 确定功能和待办事项的优先级
- 处理变更请求
- 让利益相关者围绕项目目标达成一致
按优先级划分的规则类别
| 优先级 | 类别 | 影响程度 | 前缀 |
|---|---|---|---|
| 1 | 范围定义 | CRITICAL | scope- |
| 2 | 需求清晰度 | CRITICAL | req- |
| 3 | 优先级框架 | HIGH | prio- |
| 4 | 验收标准 | HIGH | accept- |
| 5 | 利益相关者协调 | MEDIUM-HIGH | stake- |
| 6 | 技术规格说明 | MEDIUM | tech- |
| 7 | 变更管理 | MEDIUM | change- |
| 8 | 文档标准 | LOW | doc- |
快速参考
1. 范围定义(CRITICAL)
scope-define-boundaries- 明确界定范围边界scope-document-assumptions- 明确记录所有假设scope-work-breakdown- 将范围拆分为可衡量的工作项scope-define-mvp- 在定义完整功能集之前定义 MVPscope-stakeholder-signoff- 获取利益相关者对范围的批准
2. 需求清晰度(CRITICAL)
req-specific-measurable- 编写具体且可衡量的需求req-user-stories- 以用户故事的形式组织需求req-avoid-solution-language- 避免使用特定于解决方案的表述req-functional-nonfunctional- 区分功能性需求与非功能性需求req-consistent-terminology- 使用一致的术语req-traceability- 保持需求的可追溯性
3. 优先级框架(HIGH)
prio-moscow-method- 使用 MoSCoW 优先级排序方法prio-rice-scoring- 使用 RICE 评分提高客观性prio-value-vs-effort- 明确评估价值与投入prio-dependencies-first- 识别依赖关系并确定顺序prio-kano-model- 使用 Kano 模型对功能进行分类
4. 验收标准(HIGH)
accept-given-when-then- 使用 Given-When-Then 格式accept-testable-criteria- 编写可测试的验收标准accept-edge-cases- 在验收标准中纳入边缘情况accept-definition-of-done- 明确定义完成标准accept-avoid-over-specification- 避免过度规定
5. 利益相关者协调(MEDIUM-HIGH)
stake-identify-stakeholders- 尽早识别所有利益相关者stake-early-feedback- 尽早并经常收集反馈stake-conflict-resolution- 明确解决冲突stake-communication-plan- 制定沟通节奏stake-success-metrics- 就成功指标达成一致
6. 技术规格说明(MEDIUM)
tech-system-context- 记录系统上下文和依赖关系tech-api-contracts- 在实施前定义 API 契约tech-data-model- 说明数据模型和架构变更tech-error-handling- 规划错误处理与恢复tech-performance-requirements- 说明性能要求tech-security-considerations- 记录安全注意事项
7. 变更管理(MEDIUM)
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- 定义项目术语
评论
支持 Markdown