SuperAPI AI 工具集

speckit-baseline

通用与其它

查看项目

更新于 10-16 03:15

技能介绍

用途:针对已有或遗留代码生成与技术栈无关的功能规格说明(spec),把代码中的实际行为反向整理为用户需求文档。适用于为缺少书面需求的代码库补规格、在重构或现代化之前记录某个功能、以及接手他人代码时梳理需求。

主要能力:接受文件路径、目录路径或 glob 模式作为分析目标;发现并读取源文件,识别主要语言与框架、关键文件关系与依赖;分析入口点与公共接口、函数与方法签名及行为、数据模型与实体、API 端点与路由、面向用户的功能;据此推断用户故事、验收场景、功能需求、关键实体、成功标准与假设;将实现细节抽象为“做什么”而非“怎么做”的需求;在 FEATURE_DIR/checklists/requirements.md 生成规格质量检查清单。

使用方式:需有带 .specify/ 脚本与模板的仓库上下文。流程为:解析目标输入(空输入时停止并询问具体目标);展开 glob 并读取文件内容;分析代码结构;从功能中提炼 2–4 个单词的短名(动作-名词格式,如 user-auth);查找该短名的最高现有功能编号,运行 .specify/scripts/bash/create-new-feature.sh --json 传入编号与短名;从脚本 JSON 输出读取 BRANCH_NAME、FEATURE_DIR、SPEC_FILE;加载 .specify/templates/spec-template.md 并按模板结构起草规格。参数中含单引号时使用转义语法,如 'I'''m Groot',或改用双引号 "I'm Groot"。

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

限制:生成的规格需由了解该功能的人验证;代码行为不明确处使用 [NEEDS CLARIFICATION] 标记,最多 3 处;需记录分析中做出的假设。后续可用 speckit-clarify 与领域专家澄清、用 speckit-plan 规划重构,并与真实需求对比找出差距。收费、价格、平台支持等细节暂未提供。