SuperAPI AI 工具集

feature-specification

编程与开发

查看项目

更新于 10-16 06:56

技能介绍

Feature Specification 技能用于从已批准的 FRS(功能需求规格)GitLab issue 与领域设计文档生成功能规格说明,并将结果作为 GitLab Feature Spec issue 发布,链接到对应的 FRS issue。该技能不写入任何本地文件,功能规格仅以 GitLab issue 形式存在。

用途 该技能面向基于 GitLab 与领域驱动设计(DDD)的智能体开发流程,在 FRS 获批后、进入实现执行之前,生成结构化的功能规格说明,作为后续实现阶段的输入。

主要能力

  • 从 FRS issue 的用户场景部分提取用户故事,格式为“As a <actor>, I want to <action> so that <value>”,每个故事引用 FRS Actors 表中的具名角色,动作映射到领域设计聚合中的命令,价值关联 FRS Overview 中的业务目标,故事 ID 形如 US-001、US-002。
  • 为每个用户故事编写 Given/When/Then 验收标准,每条标准可独立验证,Then 中不使用“and”子句,需拆分为独立标准。
  • 将用户故事映射到领域:识别拥有该故事的限界上下文(来自 BC_SPEC.md)、处理命令的聚合(来自 AGGREGATE_*.md),并列出触发的命令。
  • 填充 issue 模板并创建 GitLab issue,标签为 ["feature-spec", "<bc-slug>"],随后链接到 FRS issue。
  • 展示结果供审批,包含功能名称、GitLab URL、Issue ID、关联的 FRS、用户故事数量、验收标准数量、限界上下文列表。

使用方式 Step 0:收集输入。询问用户“FRS GitLab issue ID 是什么?”(例如 #42)和“限界上下文 slug 是什么?”(例如 payment-processing)。然后读取 FRS issue(mcp__gitlab__get_issue,project_id 来自 CLAUDE.md,issue_iid 为 frs_iid),并读取领域设计产物:docs/contexts/<bc-slug>/BC_SPEC.md 以及 docs/contexts/<bc-slug>/aggregates/AGGREGATE_*.md(所有聚合文件)。 Step 1:生成功能规格。提取用户故事、编写验收标准、将故事映射到领域。 Step 2:填充 issue 模板。加载 skills/feature-specification/templates/feature-spec-issue-template.md,将每个 {{placeholder}} 替换为 Step 1 提取的内容。 Step 3:创建 GitLab issue。调用 mcp__gitlab__create_issue(project_id 来自 CLAUDE.md,title 为 "Feature: <feature-name>",description 为填充后的模板内容,labels 为 ["feature-spec", "<bc-slug>"]),然后调用 mcp__gitlab__create_issue_link 将其链接到 FRS issue。 Step 4:提交审批。展示功能名称、GitLab URL、Issue ID、关联的 FRS、用户故事数量、验收标准数量、限界上下文列表,并提示审批要求:审阅 Feature Spec issue 后,运行 /agentic-dev-flow:implementation-execution 并提供 Feature Spec Issue ID。到此停止,未经用户批准不得进入 implementation-execution。

适用场景 适用于已采用 GitLab 与领域驱动设计、并运行 agentic-dev-flow 流程的团队,在 FRS 获批后需要自动生成功能规格说明并作为 GitLab issue 管理时使用。

限制

  • 不创建本地文件。
  • 不自动进入 implementation-execution,必须等待用户批准。
  • 每个用户故事必须追溯到至少一个聚合命令。
  • 依赖 CLAUDE.md 中的 project_id、FRS issue、BC_SPEC.md 与 AGGREGATE_*.md 等输入。
  • 关于收费、价格、平台支持范围等信息暂未提供。