SuperAPI AI 工具集

feature-design-assistant

智能体与模型

查看项目

更新于 10-15 16:31

技能介绍

Feature Design Assistant 是一个功能设计辅助技能,目标是通过自然协作对话,把初步想法逐步转化为完整的设计与规格说明。它适合在规划新功能、设计架构或进行类似设计工作前使用。

用途与适用场景

该技能面向需要在动手实现前理清需求的开发场景,包括规划新功能、设计系统架构、整理功能规格等。它强调先理解上下文,再收集需求,然后提出方案并逐段确认,最后生成设计文档与实施任务。

工作流程

技能启动时会先声明:"I'm using the feature-design-assistant skill to design this feature." 随后进入六个阶段。

第一阶段:上下文探索。先查看代码库,了解项目结构与技术栈、既有模式与约定、相关功能或模块,以及相关区域的近期变更。

第二阶段:结构化信息收集。使用 AskUserQuestion 批量提问,每次最多 4 个问题。第一轮收集核心需求,包括主要目标(新功能、增强、缺陷修复、重构)、主要用户(终端用户、管理员、开发者、系统)、预期范围(小/中/大/不确定)以及硬性截止或约束(紧急、本迭代、灵活、仅规划)。第二轮收集技术要求,包括涉及的系统层级(数据模型、业务逻辑、API、UI)、关键质量要求(高性能、强安全、高可靠、易维护)、错误处理方式(快速失败、优雅降级、重试恢复、视情况而定)和测试方式(TDD 推荐、先实现后测试、最小测试、不测试)。第三轮收集集成与依赖,包括外部集成(数据库、外部 API、消息队列、无)、依赖关系(认证系统、其他功能、外部团队、无)、向后兼容策略(必须保持、版本化 API、允许破坏、不适用)以及文档需求(API 文档、用户指南、开发指南、无)。第四轮根据前述回答提出追问,例如选择 UI 层时询问 UI 框架/方式(React、Vue、服务端渲染、沿用现有模式),选择高安全时询问所需安全措施(输入校验、限流、审计日志、加密)。

第三阶段:方案探索。在收集需求后提出 2-3 种实现方案,每种列出优点、缺点和最适合场景,并标注推荐项,通过 AskUserQuestion 让用户确认采用哪种方案。

第四阶段:设计呈现。分段展示设计,每段 300-500 字,包括架构总览、数据模型、API 设计、组件设计、错误处理、测试策略;每段结束后用 AskUserQuestion 确认(看起来没问题、小改动、大改、有疑问)。

第五阶段:文档与任务。将设计写入 docs/designs/YYYY-MM-DD-<topic>-design.md,文档包含功能名称、摘要、需求、架构与实施任务清单。生成的实施任务带有优先级、阶段、时间与依赖标注,每个任务包含文件列表与测试驱动步骤(写失败测试、验证失败、实现最小代码、验证通过、提交)。

第六阶段:执行交接。询问用户如何继续实现,选项包括立即执行(在当前会话运行 /feature-pipeline)、新会话、稍后手动实现、或返回修改设计。

关键原则

该技能强调:高效批量提问,适当用满 4 个问题槽;非排他选项使用多选,决策类使用单选;在首选选项上标注"(Recommended)";问题从一般到具体渐进细化;在每个阶段逐步验证理解;并严格遵循 YAGNI,从设计中移除不必要的功能。

限制与暂未提供的信息

资料未提供该技能的具体价格、支持的平台、安装命令、运行环境要求,也未给出实际运行示例或效果数据,这些信息暂未提供。