SuperAPI AI 工具集

ac-spec-generator

编程与开发

查看项目

更新于 10-15 10:01

技能介绍

AC Spec Generator 用于从项目规格说明生成功能列表,目标是把已解析的规格说明转化为可执行的功能列表,并为每个功能附带可测试的验收标准,从而支持自主实现。

用途 该工具的核心用途是生成全面的功能列表。它接收解析后的规格说明,将其转换为带有可测试验收标准的功能列表,便于后续自主实现。

主要能力

  • 功能拆解:将需求拆分为原子化、可测试的单元。
  • 覆盖范围:可为全面覆盖生成 50-100+ 个功能。
  • 排序与分组:按依赖顺序排列(基础功能优先),并按类别分组以便组织。
  • 类别划分:包括 core(核心功能)、authentication(登录/注册/权限)、data(模型、存储、检索)、api(端点、集成)、ui(用户界面组件)、testing(测试基础设施)、deployment(CI/CD、托管)。
  • 优先级分配:Critical(阻塞其他功能)、High(核心功能)、Medium(重要但不阻塞)、Low(锦上添花、打磨)。
  • 丰富信息:为功能添加测试用例和预估。

使用方式 快速开始示例:

from scripts.spec_generator import SpecGenerator

generator = SpecGenerator(project_dir) feature_list = await generator.generate(spec) await generator.save_feature_list(feature_list)

功能列表 Schema 示例:

{ "features": [ { "id": "auth-001", "description": "User can register with email and password", "category": "authentication", "status": "pending", "passes": false, "test_cases": [ "Valid registration creates user", "Duplicate email shows error", "Weak password rejected" ], "dependencies": [], "estimated_effort": "2h", "priority": 1 } ], "total": 50, "completed": 0, "metadata": { "generated_at": "2024-01-15T10:00:00Z", "spec_version": "1.0.0" } }

工作流

  1. Parse:加载并校验规格说明。
  2. Analyze:识别需求模式。
  3. Decompose:拆分为原子功能。
  4. Prioritize:分配优先级和顺序。
  5. Enrich:添加测试用例和预估。
  6. Export:保存 feature_list.json。

集成关系

  • 输入:来自 ac-spec-parser 的已解析规格说明。
  • 输出:供 ac-state-tracker 使用的功能列表。
  • 使用:ac-complexity-assessor 进行预估。

API 参考 完整实现见 scripts/spec_generator.py。

适用场景 适用于需要从规格说明生成结构化功能列表、将需求转换为功能、生成 50-100+ 可测试功能,以及为自主实现准备验收标准的项目。

限制 资料未提供关于收费、价格、平台支持范围、具体效果或性能的说明,这些信息暂未提供。