SuperAPI AI 工具集

epic-requirements-specification

写作与研究

查看项目

更新于 10-16 02:25

技能介绍

该技能用于以 Epic 为单位,交互式地定义和界定项目范围,核心特点是“一次只问一个问题”,并在获得明确批准后再执行文件写入与后续同步。

用途: 用于在项目早期进行交互式需求发现与范围界定。它把用户零散、模糊的输入,逐步整理为一份结构化的 Epic 规格说明文档。

主要能力与工作流程: 第一阶段为交互式发现。此阶段严格处于信息收集状态:分析用户输入,在后台映射到既定结构,并每次只提出一个聚焦问题,以填补缺失或含糊的信息。此阶段有绝对工具锁定:不得调用任何 MCP 跟踪工具、不得创建 Jira 工单、不得向工作区写入 Markdown 文件。若用户输入极短或含糊(例如“创建一个蓝色杯子”),也不会假设访谈结束,而是以此为触发,提出第一个关于核心业务背景的澄清问题。按顺序推进:等待用户对当前问题的明确回答,再进入下一个主题。不得编造业务事实;若用户选择跳过某一点,则使用 [Assumption](假设)或 [Open Question](待解决问题)标注。Epic 范围保持在业务和能力层面,不询问技术实现细节、API、数据库结构或 UI 规则。

第二阶段为草稿评审与批准门。只有当所有关键部分都已覆盖,或用户明确要求查看草稿时,才在聊天窗口中输出完整的 Epic 规格说明文本供评审。只有在用户明确评审文本草稿并输入确切的“APPROVED”后,才允许进入第三阶段并运行自动化工具。若用户要求修改,则更新文本草稿并再次请求批准。

第三阶段为批准后执行。文件持久化:批准后将最终文本写入工作区的 Markdown 文件(epic-<slug>.md 或 project-<slug>.md)。后续操作提供:不自动同步到跟踪系统,而是报告保存的文件路径,并在底部呈现“Next Actions”(下一步操作)部分,请用户明确确认希望触发哪些后续步骤。

输出规格: 最终生成的文档必须使用以下 Markdown 结构:

  1. 业务背景(Business Context):业务问题(Business Problem)、业务目标(Business Goal)、业务价值(Business Value)、成功标准 / KPI(Success Criteria / KPIs)。
  2. 范围与干系人(Scope & Stakeholders):目标用户 / 参与者(Target Users / Actors)、最终受益人(End Beneficiaries)、范围内(In Scope)、范围外(Out of Scope)。
  3. 约束与风险(Constraints & Risks):依赖(Dependencies)、约束(Constraints)、关键风险(Critical Risks)、假设(Assumptions)、待解决问题(Open Questions)。
  4. 分析师洞察(Analyst's Insights):仅在交互过程中发现有意义缺口、矛盾或风险时包含。

交互模型: 第一阶段(发现):说明从用户上一条消息中已捕获的内容,并给出单个下一个问题。此阶段不要输出 Markdown 文档结构或代码块。 第二阶段(评审):在聊天中展示完整的文本草稿,并明确请求用户确认。 第三阶段(执行):报告保存的文件路径,并在底部展示“Next Actions”选项,询问:“Epic 已保存为文件。接下来你想做什么?1. 将此 Epic 同步到跟踪系统(MCP);2. 使用 write-user-story 技能,将这个已批准的 Epic 拆解为第一个 User Story。”

使用方式: 以交互对话方式启动,按提示逐项回答业务层面的问题;在草稿阶段审阅完整文本,并输入 APPROVED 以触发生成文件;随后从 Next Actions 中选择后续操作。

适用场景: 适合在需求早期需要与干系人逐步澄清业务目标、范围、约束与风险,并最终形成结构化 Epic 规格说明的场景,尤其适合希望控制访谈节奏、避免过早生成文档的团队。

限制: 第一阶段不得调用 MCP 跟踪工具、创建 Jira 工单或写 Markdown 文件;不得自动同步到跟踪系统;仅当用户输入确切的 APPROVED 后才进入执行阶段;Epic 范围只停留在业务与能力层面,不涉及技术实现细节;关于该技能的具体收费、价格、平台支持等信息暂未提供。