SuperAPI AI 工具集

arkweb-spec-gen

编程与开发

查看项目

更新于 10-15 16:44

技能介绍

用途:面向 ArkWeb 项目,将需求基线、评审、设计、代码分析等多份文档聚合为统一的规格文档 spec.md 和执行计划 task.md。

主要能力:读取 proposal.md、requirement.md、design.md、review.md、analysis.md 五份输入,生成 spec.md(含架构设计、接口规格、特性规格、任务规格四章,保存至 docs/features/{feature-name}/spec.md)与 task.md(含 AC→Task 追溯表、阶段计划、Task 列表与详情,保存至同目录)。spec.md 覆盖设计元数据、需求基线摘要、涉及仓和模块、架构规则、ADR、接口参数四段式、验收标准 WHEN/THEN、业务/异常/豁免/恢复规则表、验证映射、受影响文件清单等;task.md 拆解为可独立执行的 Task,含目标、文件范围、AC 映射、前置依赖、完成判据、停止条件与验证命令。

使用方式:触发词为“生成 Spec”“生成执行计划”“生成 spec.md”。执行前须先读取 {DOCS_REPO}/assets/templates/spec.md 与 task.md 模板,严格按模板章节结构与中文标题填充。流程为读取全部输入、生成 spec.md、生成 task.md、自检,最后按固定格式回复结果摘要。

限制:依赖上述五份输入文档齐全;模板路径需存在;文档须无 TBD/TODO/占位符;Task 粒度需为 AI 可独立完成的最小闭环,不允许跨 Task 隐式依赖。其他平台支持与收费信息暂未提供。