SuperAPI AI 工具集

spec-design

编程与开发

查看项目

更新于 10-15 19:53

技能介绍

Spec Design 是一个以原则驱动访谈为核心的工作流技能,用于把需求整理成完整规格并生成 GitHub issue 层级结构。

主要流程:阶段一探索性访谈,使用 AskUserQuestion 工具,每次 2-4 个问题,围绕用户问题深入追问并尊重地挑战假设,融入 YAGNI、简单性、成熟技术等原则;检测到破坏性 API 变更、重要数据库迁移、新架构模式或跨团队依赖等信号时,建议改用 RFC 模板。阶段二与用户确认原则摘要,包括用户问题、不构建的项、最简单方案、技术选型及理由、必要与附带复杂度、风险与缓解。阶段三按模板将规格写入 .context/specs/<feature-name>.md 或 <issue-number>.md,并按最小逻辑单元拆分独立、可验证的子任务,考虑数据层→API层→UI层或核心功能→边界情况→收尾。阶段四让用户审阅规格,提示 open .context/specs/<name>.md。阶段五创建 issue,先询问分配方式,再用 gh issue create --title "[Feature Name]" --body "$(cat .context/specs/<name>.md)" 创建主问题,子问题通过 gh-issues 技能创建原生 GitHub 子问题,每个子问题需用户确认。阶段六输出 issue 层级树和依赖顺序,并提示运行 /load-issue [number]。

限制:使用当前仓库;子问题创建依赖 gh-issues 技能;资料未提供安装方式、收费、适用范围、失败处理、并行子代理的具体实现细节,暂未提供。