SuperAPI AI 工具集

feature-spec

编程与开发

查看项目

更新于 10-16 01:12

技能介绍

用途:feature-spec 是技能目录中的一项结构化命令,帮助团队按既定功能开发流程撰写简洁的技术规格文档(spec.md),聚焦架构决策、系统契约与技术设计,不陷入实现细节。其触发词包括“write a spec”“technical spec”等。

主要能力:产出聚焦“做什么”和“为什么”的规格,内容包括架构概览、系统组件及角色/契约、数据契约(类型定义、数据库模式、API 契约)、配置架构、集成模式与质量属性;明确不包含实现代码示例、逐步实现细节和重复解释。规格篇幅建议 5-10 页。

使用方式:按三到四个阶段推进。阶段一进行上下文分析与范围确认;阶段二基于代码库现有模式设计实现,仅就独有业务逻辑、约束或数据关系提问,每次只问一个问题;阶段三撰写规格文档,推荐章节顺序为概览、架构概览、数据架构、API 架构、授权架构、集成架构、前端架构、设计与 UX 要求、配置架构、文件组织、质量属性;若功能含 UI/UX 复杂度,可选阶段四生成 design-brief.md。生成后更新 discussion-summary.md(存在则追加“Spec Phase”,不存在则新建)。

适用场景:需要为全栈、仅后端、仅前端或后台处理类功能编写技术规格时;需要让后端与前端开发者按连续区块阅读各自内容时;需要将设计相关信息独立成文交予设计师协同时。

限制:资料未提供该技能的具体安装命令、收费方式、支持平台或效果保证;其依赖的参考文件路径(如 feature-development-process.md、vision.md、requirements.md)与 MCP 连接需按项目实际情况提供,资料未说明缺失时的替代方案。