SuperAPI AI 工具集

feature-inventory

编程与开发

查看项目

更新于 10-16 00:31

技能介绍

用途:从现有代码库中编目功能(API 端点、用户流程、UI 界面、可观察行为),并生成结构化功能规格说明。以任务描述中的文本作为功能描述;若为空则报错“No feature description provided”,若无法确定用户场景则报错“Cannot determine user scenarios”。

主要能力:读取 constitution 文档、clarification.md、knowledge-graph.json 及研究文件,加载 skills/writing-feature-spec/templates/spec-template.md 模板;提取参与者、动作、数据与约束;分配唯一的 REQ-XXX 需求编号(三位序号,全局唯一);填写用户场景与测试,生成可测试的功能需求;定义可度量、与技术无关的成功标准;识别关键实体。最多使用 3 个 [NEEDS CLARIFICATION] 标记,优先级为范围 > 安全/隐私 > 用户体验 > 技术细节;clarification.md 中已解析字段不再追问且不计入配额。

使用方式:在任务 Artifact 路径下输出 spec.md(主产物)与 requirements-checklist.md(如适用)。逐段写入:标题+范围基线、用户场景与测试、需求(按领域的功能需求+非功能需求)、成功标准,最后追加质量检查清单。研究驱动模式:存在 project-structure.md 与 tech-stack.md 等研究文件时,不直接读取项目源码,按功能域生成用户故事(P1/P2/P3,Given-When-Then)与需求。

适用场景:代码库现代化改造、功能梳理与规格化、需求追溯与评审准备。

限制:聚焦 WHAT 与 WHY,不涉及实现细节;面向业务相关方;不在 spec 内嵌检查清单;不适用的小节应整节删除而非填 N/A;资料未提供具体输出目录以外的更多配置说明。