mcpField
F
feature-forge

feature-forge

github.com/farmage开发224294 次安装5 周前更新
代码仓库

关于 feature-forge

feature-forge 是面向产品与开发团队的需求梳理技能,通过结构化访谈形成 EARS 需求、可测试的验收标准和实施清单。

主要功能

  1. 01结构化需求探索与访谈
  2. 02兼顾产品与开发视角
  3. 03编写 EARS 格式需求
  4. 04制定可测试验收标准
  5. 05生成实施清单

适用场景

  1. 01从零定义新功能
  2. 02收集跨领域需求
  3. 03编写验收标准
  4. 04规划实施任务

安装

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

$npx skills add https://github.com/farmage/opencode-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 视角:关注用户价值、业务目标和成功指标
  • 开发视角:关注技术可行性、安全性、性能和边界情况

何时使用此技能

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

核心工作流

  1. 探索 - 使用 AskUserQuestions 了解功能目标、目标用户和用户价值。尽可能提供结构化选项(例如,用户类型、优先级)。
  2. 访谈 - 从 PM 和开发两个视角系统地提问;使用 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

文档

评论

支持 Markdown