SuperAPI AI 工具集

agent-specification

智能体与模型

查看项目

更新于 10-16 10:24

技能介绍

用途

该技能是 SPARC 方法论中 Specification(规格说明)阶段的专用智能体,类型为 analyst,描述为“SPARC Specification phase specialist for requirements analysis”(面向需求分析的规格阶段专家),优先级 high,sparc_phase 为 specification。通过 $agent-specification 调用。其目标是在进入实现之前,产出全面、清晰、可测试的规格说明。

主要能力

资料中声明的 capabilities 包括:

  • requirements_gathering(需求收集)
  • constraint_analysis(约束分析)
  • acceptance_criteria(验收标准)
  • scope_definition(范围定义)
  • stakeholder_analysis(利益相关者分析)

钩子机制

技能定义了 pre 与 post 钩子:

  • pre:输出“📋 SPARC Specification phase initiated”,并将 sparc_phase 存为 specification,同时以 spec_start_$(date +%s) 为键存储当前任务(Task: $TASK)。
  • post:输出“✅ Specification phase complete”,并以 spec_complete_$(date +%s) 为键存储“Specification documented”。

使用方式

按资料说明,通过 $agent-specification 调用该技能。技能正文给出规格说明阶段的工作内容与产出结构:

1. 需求收集

区分功能需求(functional_requirements)与非功能需求(non_functional_requirements)。每条功能需求包含 id、description、priority 与 acceptance_criteria;每条非功能需求包含 id、category(如 performance、security)、description 与 measurement 或 validation。

2. 约束分析

将约束分为三类:

  • 技术约束(technical)
  • 业务约束(business)
  • 监管约束(regulatory)

3. 用例定义

每个用例包含 id、title、actor、preconditions、flow(步骤序列)、postconditions 与 exceptions。

4. 验收标准

采用 Gherkin 风格(Given/When/Then)编写场景,覆盖成功路径与失败路径,并包含错误提示、页面停留、日志记录等断言。

交付物结构

技能正文示例中列出的规格说明交付物包括:

  • 需求文档(System Requirements Specification):含引言(目的、范围、定义)、功能需求、非功能需求(性能、安全等)。
  • 数据模型规范:以 entities 形式描述属性与关系(如 User、Role、Session)。
  • API 规范:以 OpenAPI 3.0.0 形式描述路径、请求体、响应码等。

校验清单与最佳实践

完成规格说明前需检查:需求可测试、验收标准清晰、边界情况有记录、性能指标已定义、安全需求已指定、依赖已识别、约束已记录、利益相关者已批准。 最佳实践建议:保持具体(避免“fast”“user-friendly”等模糊表述)、可测试(明确的通过/失败标准)、考虑边界情况、端到端思考用户旅程、对规格变更进行版本控制、尽早获取反馈。

适用场景

适用于在 SPARC 方法论下开展软件项目的规格说明阶段工作,尤其是需要结构化整理需求、约束、用例与验收标准,并产出需求文档、数据模型与 API 规范草案的场景。

限制

资料未提供该技能的具体安装命令、依赖环境、支持的模型或运行时、收费与价格信息,也未提供除示例外的实际使用效果说明,以上内容暂未提供。