SuperAPI AI 工具集

speckit-baseline

通用与其它

查看项目

更新于 10-15 20:34

技能介绍

用途:为已有或遗留代码生成规格说明,在重构前记录功能,或为没有书面需求的代码库补文档。

主要能力:解析目标路径、文件列表或 glob 模式;读取源码并识别语言、框架、依赖关系;分析入口点、公共接口、函数签名、数据模型、API 路由与用户可见功能;据此生成 2-4 词的动作-名词短名,并创建功能分支与规格文件。规格内容涵盖用户故事、验收场景、功能需求、关键实体、成功标准与假设,并抽象掉实现细节,聚焦代码做什么而非怎么做。同时生成需求质量检查清单。

使用方式:需提供目标路径、文件列表或 glob 模式,以及含 .specify/ 脚本与模板的仓库上下文。目标缺失或含糊时应先提问。流程为:解析输入、发现并读取源文件、分析代码结构、生成短名、查找已有最高功能编号,运行 .specify/scripts/bash/create-new-feature.sh --json 并读取 BRANCH_NAME、FEATURE_DIR、SPEC_FILE,加载 .specify/templates/spec-template.md 起草规格,最后生成 FEATURE_DIR/checklists/requirements.md 并报告结果。参数含单引号时使用转义语法,如 'I'''m Groot'。

输出:specs/<feature>/spec.md 与 specs/<feature>/checklists/requirements.md。

限制:模糊代码段用 [NEEDS CLARIFICATION] 标记,最多 3 处;生成的规格应由熟悉该功能的人验证。后续可用 speckit-clarify 澄清、speckit-plan 规划重构。具体收费、平台支持等信息暂未提供。