mcpField
E
epic-requirements-specification

epic-requirements-specification

github.com/testomatio开发1664 次安装6 天前更新
代码仓库

关于 epic-requirements-specification

epic-requirements-specification 通过逐次提问的流程收集并起草业务层面的 Epic 需求。它将需求探索、草稿审批和审批后的文件保存分开,未获明确批准前不启动自动化。

主要功能

  1. 01每次提出一个聚焦问题
  2. 02收集业务范围与相关方信息
  3. 03草稿审阅及明确审批门槛
  4. 04将已批准的规格保存为 Markdown
  5. 05提供后续选项但不自动同步

适用场景

  1. 01澄清信息不完整的 Epic 请求
  2. 02审阅并批准 Epic 规格草稿
  3. 03保存获批 Epic 并选择后续步骤

安装

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

$npx skills add https://github.com/testomatio/skills --skill epic-requirements-specification

安装后在 Claude Code 中输入/epic-requirements-specification确认已加载。

详细介绍

第 1 阶段:交互式需求发现

  1. 一次只问一个问题: 你必须严格处于信息收集状态。分析用户的输入,在后台将其映射到相应结构,并且每次只提出一个聚焦的问题,以填补缺失或含糊的信息。

  2. 绝对禁止使用工具: 在此阶段不得调用任何 MCP 跟踪工具,不得创建 Jira 工单,也不得向工作区写入 Markdown 文件。

  3. 尽量精简地处理输入: 如果用户的输入极短或含糊(例如“create blue cup”),不要假设访谈已经结束。应将其视为触发信号,首先询问有关核心业务背景的澄清问题。

  4. 按顺序推进: 在用户明确回答当前问题之前,不得转到下一个主题。不得捏造业务事实;如果用户选择跳过某一点,请使用 [Assumption] 或 [Open Question]。

  5. Epic 范围: 所有问题都应围绕业务和能力层面。不要询问技术实现细节、API、数据库架构或 UI 规则。

第 2 阶段:草稿审阅与审批关卡

  1. 展示草稿: 只有在涵盖所有关键部分后,或者用户明确要求查看草稿时,才在聊天窗口中输出完整的 Epic 规范文本供审阅。

  2. 执行触发条件: 只有当用户明确审阅文本草稿并输入准确的单词 APPROVED 时,你才获准进入第 3 阶段并运行自动化工具。如果用户要求修改,请更新文本草稿并再次请求审批。

第 3 阶段:审批后执行

  1. 文件持久化: 获得批准后,将最终文本写入工作区中的 Markdown 文件(epic-<slug>.md 或 project-<slug>.md)。

  2. 提供后续操作选项: 不要自动同步到跟踪系统。应报告保存的文件路径,并在底部提供“后续操作”部分,询问用户明确确认希望触发哪些后续步骤。

输出规范

循环结束时生成的最终文档必须使用以下 Markdown 结构:

1. 业务背景
  • 业务问题:
  • 业务目标:
  • 业务价值:
  • 成功标准 / KPI:
2. 范围与利益相关者
  • 目标用户 / 参与者:
  • 最终受益者:
  • 范围内:
  • 范围外:
3. 约束与风险
  • 依赖项:
  • 约束:
  • 关键风险:
  • 假设:
  • 开放问题:
4. 分析师的洞察

仅在交互过程中发现了有意义的信息缺口、矛盾或风险时填写。

交互模型

  • 第 1 阶段(需求发现)期间: 说明你从用户上一条消息中记录了哪些信息,并提出一个后续问题。此时不要输出 Markdown 文档结构或代码块。
  • 第 2 阶段(审阅)期间: 在聊天中展示完整的文本草稿,并明确请求用户确认。
  • 第 3 阶段(执行)期间: 报告保存的文件路径,并在底部提供“后续操作”选项。询问:“Epic 已保存为文件。接下来你想做什么?
    • 1. 将此 Epic 同步到跟踪系统(MCP)
    • 2. 使用 write-user-story 技能,将此已批准的 Epic 拆分为第一个用户故事

评论

支持 Markdown