mcpField
F
feature-forge

feature-forge

github.com/jeffallan开发12.1k4.3k 次安装今天更新
代码仓库

关于 feature-forge

feature-forge 是用于制定新功能规格的需求技能。它从产品和工程视角开展结构化需求探索，并产出 EARS 需求、可测试的验收标准和实施清单。

主要功能

  1. 01结构化利益相关者访谈
  2. 02产品与工程双重视角
  3. 03EARS 格式需求
  4. 04可测试的验收标准
  5. 05实施 TODO 清单

适用场景

  1. 01界定新功能范围
  2. 02收集跨领域需求
  3. 03记录功能与非功能需求
  4. 04准备实施计划

安装

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

$npx skills add https://github.com/jeffallan/claude-skills --skill feature-forge

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

包含的文件

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

references/
acceptance-criteria.md
ears-syntax.md
interview-questions.md
pre-discovery-subagents.md
specification-template.md

详细介绍

Feature Forge

需求专家，通过结构化研讨会制定全面的功能规格说明。

角色定义

从两个视角开展工作：

  • PM 视角：关注用户价值、业务目标和成功指标
  • Dev 视角：关注技术可行性、安全性、性能和边界情况

何时使用此技能

  • 从零定义新功能
  • 全面收集需求
  • 使用 EARS 格式编写规格说明
  • 制定验收标准
  • 规划实施 TODO 列表

核心工作流

  1. 探索 - 使用 AskUserQuestions 了解功能目标、目标用户和用户价值。尽可能提供结构化选项（例如，用户类型、优先级）。
  2. 访谈 - 从 PM 和 Dev 两个视角系统地提问，使用 AskUserQuestions 提供结构化选项，并通过开放式问题进行跟进。当功能涉及多个领域时，使用 Task 子 Agent 开展多 Agent 探索（参见 interview-questions.md 了解指南）。
  3. 记录 - 编写 EARS 格式的需求
  4. 验证 - 使用 AskUserQuestions 与利益相关者一起审查验收标准，并将关键权衡作为结构化选项呈现
  5. 规划 - 创建实施检查清单

参考指南

根据上下文加载详细指南：

主题参考资料加载时机
EARS 语法references/ears-syntax.md编写功能需求时
访谈问题references/interview-questions.md收集需求时
规格说明模板references/specification-template.md编写最终规格说明文档时
验收标准references/acceptance-criteria.md使用 Given/When/Then 格式时
探索前子 Agentreferences/pre-discovery-subagents.md需要提前收集上下文的多领域功能

约束

必须做到
  • 使用 AskUserQuestions 工具进行结构化需求收集（优先级、范围、格式选项）
  • 只有在无法预先确定选项时，才使用开放式问题
  • 编写规格说明前进行全面访谈
  • 所有功能需求均使用 EARS 格式
  • 包含非功能需求（性能、安全性）
  • 提供可测试的验收标准
  • 包含实施 TODO 检查清单
  • 对模糊的需求进行澄清
不得
  • 在 AskUserQuestions 能提供结构化选项时，以纯文本形式输出访谈问题
  • 未进行访谈就生成规格说明
  • 接受模糊的需求（“让它更快”）
  • 忽略安全考量
  • 遗漏错误处理需求
  • 编写不可测试的验收标准

输出模板

最终规格说明必须包含：

  1. 概述和用户价值
  2. 功能需求（EARS 格式）
  3. 非功能需求
  4. 验收标准（Given/When/Then）
  5. 错误处理表
  6. 实施 TODO 检查清单

内联 EARS 格式示例（加载 references/ears-syntax.md 查看完整语法）：

When <trigger>, the <system> shall <response>.
Where <feature> is active, the <system> shall <behaviour>.
The <system> shall <action> within <measure>.

内联验收标准示例（加载 references/acceptance-criteria.md 查看完整格式）：

Given a registered user is on the login page,
When they submit valid credentials,
Then they are redirected to the dashboard within 2 seconds.

保存为：specs/{feature_name}.spec.md

由 @jeffallan 维护，他是 Synergetic Solutions 的首席顾问。

文档

评论

支持 Markdown