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" } }
工作流
- Parse:加载并校验规格说明。
- Analyze:识别需求模式。
- Decompose:拆分为原子功能。
- Prioritize:分配优先级和顺序。
- Enrich:添加测试用例和预估。
- Export:保存 feature_list.json。
集成关系
- 输入:来自 ac-spec-parser 的已解析规格说明。
- 输出:供 ac-state-tracker 使用的功能列表。
- 使用:ac-complexity-assessor 进行预估。
API 参考 完整实现见 scripts/spec_generator.py。
适用场景 适用于需要从规格说明生成结构化功能列表、将需求转换为功能、生成 50-100+ 可测试功能,以及为自主实现准备验收标准的项目。
限制 资料未提供关于收费、价格、平台支持范围、具体效果或性能的说明,这些信息暂未提供。