SuperAPI AI 工具集

refine-specification

编程与开发

查看项目

更新于 10-16 06:56

技能介绍

用途

refine-specification 是一个技术需求分析类技能,用于帮助用户细化 Rails 应用的功能规格草案,将其转化为“实现就绪”的文档。它扮演技术需求分析师的角色,通过结构化提问补全草案中缺失或模糊的信息。

主要能力

  • 读取用户提供的规格草案文件(若不存在则要求直接粘贴草案内容)。
  • 在五个固定领域提出澄清问题,并根据草案已有的清晰内容自适应调整:
    1. 范围与业务背景:首个版本的真实范围、与其他功能的依赖、衡量成功的业务指标、必须有与可选需求。
    2. 用户与工作流:主要用户角色、主流程、必须处理的边界情况、权限/授权规则、对现有工作流的影响。
    3. 数据模型:是否需要新建表或修改模型、关键关系(1:many、many:many、多态)、关键校验、历史数据或迁移、预期数据量。
    4. 集成与外部服务:是否集成外部 API 或服务、是否需要 webhook 或后台任务、新增 gem 依赖、是否暴露新 API 端点、通知触发事件。
    5. 非功能性需求:性能(响应时间、吞吐)、安全(敏感数据、PII、GDPR)、无障碍标准(项目默认 WCAG 2.1 AA)、可扩展性、分析/日志/监控。
  • 每个问题采用统一格式,包含建议答案选项(含“其他”并留出填写空间)与用户回答区。
  • 根据回答提出 2 到 3 个追问,针对模糊回答、选择“其他”的领域、潜在冲突或缺口。
  • 生成结构化的“精炼功能规格”摘要,涵盖元信息(功能名称、目标用户、范围、预估复杂度)、范围与业务背景、用户与工作流、数据模型、集成与外部服务、非功能性需求、开放问题与风险、后续步骤。
  • 将结果保存为 [feature-name]-specification.md 到项目的功能规格目录(如 docs/features/ 或 specs/features/)。

使用方式

以交互式问答进行:先提供规格草案路径或内容,然后逐领域回答问题并填写自定义内容,之后回答追问,最后获得一份精炼规格摘要文件。摘要中的后续步骤建议包括:使用 feature-planner-agent 做实现规划、使用 tdd-cycle 技能进行 TDD 工作流、必要时做技术设计。

适用场景

适用于 Rails 项目中已有功能规格草案、但需要补齐细节以进入实现规划的阶段,尤其是涉及业务范围、用户工作流、数据模型、外部集成和非功能性需求等需要澄清的场景。

限制

指南强调:提问要有对话感但保持结构,根据草案自适应避免重复已知内容,提供基于 Rails/Hotwire 最佳实践的务实选项,标记不一致之处并聚焦可执行细节。此外,具体价格、安装命令、平台支持等事实在资料中暂未提供。