mcpField
F
feature-spec

feature-spec

github.com/pproenca开发220430 次安装11 周前更新
代码仓库

关于 feature-spec

面向软件工程师、产品经理和技术负责人的规划参考技能,用于编写规格说明并管理功能范围。规则按影响程度排列,涵盖需求、验收标准、利益相关者协作、技术细节和变更管理。

主要功能

  1. 01界定范围边界并定义 MVP
  2. 02编写可衡量且可追踪的需求
  3. 03使用 MoSCoW 和 RICE 排序
  4. 04制定可测试的验收标准
  5. 05管理利益相关者与变更

适用场景

  1. 01编写 PRD 和功能规格说明
  2. 02排列功能及待办事项优先级
  3. 03评估变更请求及其影响

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/pproenca/dot-skills --skill feature-spec

安装后在 Claude Code 中输入/feature-spec确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

AGENTS.md
metadata.json
README.md
assets/templates/
_template.md
references/
_sections.md
accept-avoid-over-specification.md
accept-definition-of-done.md
accept-edge-cases.md
accept-given-when-then.md
accept-testable-criteria.md
change-defer-log.md
change-formal-process.md
change-impact-assessment.md
change-scope-freeze.md
change-version-tracking.md
doc-accessible-format.md
doc-consistent-templates.md
doc-decision-records.md
doc-glossary-terms.md
doc-single-source.md
prio-dependencies-first.md
prio-kano-model.md
prio-moscow-method.md
prio-rice-scoring.md
prio-value-vs-effort.md
req-avoid-solution-language.md
req-consistent-terminology.md
req-functional-nonfunctional.md
req-specific-measurable.md
req-traceability.md

详细介绍

软件工程功能规格说明与规划最佳实践

为软件工程师、产品经理和技术负责人编写的全面功能规格说明与规划指南。包含 8 个类别中的 42 条规则,按影响程度排序,以防止范围蔓延并确保项目成功。

适用场景

在以下情况下参考这些指南:

  • 编写 PRD 或功能规格说明
  • 定义需求或用户故事
  • 管理范围并防止范围蔓延
  • 确定功能和待办事项的优先级
  • 处理变更请求
  • 让利益相关者围绕项目目标达成一致

按优先级划分的规则类别

优先级类别影响程度前缀
1范围定义CRITICALscope-
2需求清晰度CRITICALreq-
3优先级框架HIGHprio-
4验收标准HIGHaccept-
5利益相关者协调MEDIUM-HIGHstake-
6技术规格说明MEDIUMtech-
7变更管理MEDIUMchange-
8文档标准LOWdoc-

快速参考

1. 范围定义(CRITICAL)
  • scope-define-boundaries - 明确界定范围边界
  • scope-document-assumptions - 明确记录所有假设
  • scope-work-breakdown - 将范围拆分为可衡量的工作项
  • scope-define-mvp - 在定义完整功能集之前定义 MVP
  • scope-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