用途
SPARC Specification 是一个面向 SPARC 方法论中 Specification（规格说明）阶段的专用技能，定位为需求分析专家。它的目标是为新功能或新项目创建全面、清晰且可测试的规格说明，把干系人需求转化为技术规格，并定义验收标准、约束和用例。
主要能力
需求类型划分
技能区分多种需求类型：功能性需求（FR）描述系统做什么，例如“系统应通过 OAuth2 认证用户”；非功能性需求（NFR）描述质量属性，例如“95% 的请求 API 响应时间 <200ms”；约束描述限制条件，例如“必须使用现有 PostgreSQL 数据库”。
需求文档结构
支持按结构化方式组织规格，包括：功能性需求（含 id、description、priority、acceptance_criteria）、非功能性需求（含 id、category、description、measurement 或 validation）。例如 FR-001 要求系统通过 OAuth2 认证用户，优先级 high，验收标准包括可用 Google/GitHub 登录、会话保持 24 小时、刷新令牌自动续期。
约束分析
从技术、业务、法规三个维度记录约束。技术约束如必须使用现有 PostgreSQL、兼容 Node.js 18+、部署到 AWS；业务约束如 2024 年 Q2 上线、预算 50,000 美元、团队 3 名开发；法规约束如需要 GDPR 合规、SOC2 Type II 认证、WCAG 2.1 AA 无障碍标准。
用例定义
以 id、标题、演员、前置条件、流程、后置条件和异常来定义用例。例如 UC-001 用户注册，演员为新用户，前置条件包括拥有有效邮箱并接受条款，流程涵盖点击注册、显示表单、输入邮箱密码、校验输入、创建账户、发送确认邮件，后置条件为账户已创建且确认邮件已发送，异常包括无效邮箱、弱密码、重复邮箱的处理方式。
验收标准（Gherkin）
使用 Gherkin 语法编写验收场景。例如“成功登录”场景：给定我在登录页且有有效账户，当我输入正确凭据并点击 Login，那么我应被重定向到仪表盘、看到用户名且会话处于活动状态。“登录失败-密码错误”场景：输入有效邮箱和错误密码后，应看到“Invalid credentials”错误、停留在登录页并记录登录尝试。
配置
支持通过配置文件定制规格设置，例如输出格式为 markdown、ID 前缀为 FR-、优先级级别为 critical/high/medium/low；可配置需求文档和用例的模板路径，并设置校验规则，如是否要求验收标准、是否要求优先级、是否要求可测试性。
使用示例
提供 API 需求示例，包括引言（目的、范围、定义）、功能性需求（认证、授权）和非功能性需求（性能、安全），例如 99.9% 可用性 SLA、<200ms 响应时间、支持 10,000 并发用户、OWASP Top 10 合规、AES-256 数据加密、安全审计日志。还提供数据模型规格示例，定义 User、Role、Session 实体及其属性和关系，例如 User 拥有 id、email、passwordHash、createdAt、updatedAt，并与 Sessions、UserRoles 存在 has_many 关系。
使用方式
可通过调用 SPARC Specification 阶段或在 Claude Code 中直接使用，例如“Use SPARC specification to define requirements for user authentication”。执行检查清单包括：从干系人收集需求、定义带 ID 的功能性需求、定义非功能性需求（性能、安全）、记录技术/业务/法规约束、创建含流程与异常的用例、用 Gherkin 格式编写验收标准、定义数据模型实体与关系、验证所有需求可测试、获得干系人批准。
适用场景
适用于以下情况：启动需要明确需求的新功能或项目；将干系人需求转化为技术规格；为用户故事创建验收标准；记录技术、业务、法规约束；定义带前置条件和后置条件的用例。前提条件包括：对项目目标有清晰理解、能接触干系人以验证需求、了解现有系统约束、理解合规要求（如适用）。
限制与注意事项
官方资料中未提供该技能的收费、价格、平台或效果数据，上述内容暂未提供。资料强调最佳实践：具体明确，避免“快速”或“用户友好”等模糊词；确保可测试，每个需求都有明确通过/失败标准；考虑边界情况；端到端思考完整用户旅程；使用版本控制跟踪规格变更；尽早让干系人反馈验证。错误处理方面：需求模糊时提出澄清问题并使用具体指标；缺少验收标准时补充可测试的通过/失败条件；需求冲突时记录并上报干系人；范围蔓延时参照原始范围并创建变更请求。成功指标包括：所有需求都有唯一 ID、100% 需求有验收标准、所有 NFR 有可度量目标、获得干系人签字、零模糊需求。