用途
该技能是 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 规范草案的场景。
限制
资料未提供该技能的具体安装命令、依赖环境、支持的模型或运行时、收费与价格信息,也未提供除示例外的实际使用效果说明,以上内容暂未提供。