SuperAPI AI 工具集

spec-authoring

设计与创作

查看项目

更新于 10-16 01:35

技能介绍

用途:在动手写代码前先写规格说明(spec),把模糊需求转成可评审的计划,让团队在编码前对齐范围与验收标准。这是 Spec/Skill-Driven Development(SSD)的入口:先以规格规划工作,再用聚焦技能指导与评审实现。

主要能力:规格分三部分,按顺序编写。一、需求:先于设计与代码,用用户故事“As a {role}, I want {capability}, so that {benefit}”描述必须成立的事实,每条故事下列出 EARS 格式验收标准,常见模式有 THE {system} SHALL {behaviour}、WHEN {trigger}, THE {system} SHALL {behaviour}、WHERE {condition}, THE {system} SHALL {behaviour}、IF {unwanted condition}, THEN THE {system} SHALL {behaviour}。二、设计:由需求推导,描述组件、数据流、界面、状态与关键决策,每个设计元素应追溯到至少一条需求。三、任务:由设计推导,拆成有序可实施的任务,每个任务追溯到至少一个设计元素,且每个设计元素至少被一个任务覆盖。

可追溯性:保持需求→设计元素→任务的链条完整;若任务无对应需求,说明规格缺需求或任务超范围。

用法:编写设计与评审标准时,可参考仓库中的聚焦技能:architecture、performance、accessibility、state-and-data、security、testing、code-review;若某技能不在 skills/ 中,应标注为不可用而非忽略。

适用场景:开始任何非平凡功能或改动、把模糊请求转为具体可评审计划、编码前对齐范围与验收标准、避免直接写代码导致返工。

限制:平台为 iOS 与 Android,React Native 0.76+(默认新架构互操作,除非清单另有说明)。资料未提供安装命令、收费或价格信息。