SuperAPI AI 工具集

sdd

编程与开发

查看项目

更新于 10-16 06:38

技能介绍

用途

Spec-Driven Development(SDD)技能用于指导用户使用 GitHub 的 Spec-Kit 进行规范驱动开发。该方法把传统软件开发流程倒置,使规范成为可直接执行、驱动实现的产物,而不是单纯的文档。其核心哲学包括:意图驱动开发(先定义"做什么"再定义"怎么做")、丰富的规范创建(借助护栏与组织原则)、多步细化(而非一次性生成代码)、AI 原生(重度依赖高级 AI 能力)。AI 智能体依据规范生成符合意图的可运行代码。

主要能力

  • 提供安装指引与配置排查说明。
  • 支持两类工作流:新项目(Greenfield)与既有代码库(Brownfield)。
  • Greenfield 工作流包含 6 步流程,命令依次为 /speckit.constitution、/speckit.specify、/speckit.plan、/speckit.tasks、/speckit.implement。
  • Brownfield 工作流支持逆向工程与集成指导,命令包括 /speckit.brownfield、/speckit.analyze-codebase、/speckit.reverse-engineer、/speckit.specify、/speckit.integration-plan、/speckit.tasks、/speckit.implement。
  • 可选增强命令:/speckit.clarify(澄清模糊需求)、/speckit.analyze(跨产物一致性检查)、/speckit.checklist(生成质量检查清单)、/speckit.status(查看详细状态)。
  • 产物摘要与反馈循环:每条命令完成后检测并读取产物(constitution.md、spec.md、plan.md、tasks.md、分析报告),按 10 点模板生成结构化摘要,并提供反馈选项(继续、修改、重新生成、解释理由)。
  • 特性状态跟踪:使用混合方式,在每次摘要末尾附带简要状态行,按需展示详细状态仪表板。
  • 自然语言特性管理:识别"调整特性顺序"、"新增特性"、"优先做某特性"、"跳过某特性"、"某特性已完成"、"查询依赖"、"显示特性状态"等表达并执行相应操作。
  • 进度计算与依赖跟踪:按阶段计算进度(Specified 20%、Planned 40%、Tasked 60%、In Progress 80%、Complete 100%),可视化依赖关系、检测循环依赖。
  • 附带分析脚本 scripts/phase_summary.sh,可对 tasks.md 生成跨阶段进度报告。

支持的 AI 智能体

Claude Code、GitHub Copilot、Gemini CLI、Cursor、Qwen Code、opencode、Windsurf、Kilo Code、Auggie CLI、CodeBuddy CLI、Roo Code、Codex CLI、Amp 均受支持。Amazon Q Developer CLI 存在限制:不支持斜杠命令的自定义参数。

使用方式

前置要求:uv、Python 3.11+、Git、AI 智能体。

安装(推荐持久安装):

uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

一次性使用:

uvx --from git+https://github.com/github/spec-kit.git specify init <PROJECT_NAME>

验证安装:

specify check

初始化项目示例:

specify init my-project --ai claude

既有项目初始化:

specify init --here --force

其他命令参考:

specify init # New project specify init --here --force # Existing project specify check # Verify installation

Greenfield 命令:

/speckit.constitution # Project principles → SUMMARIZE /speckit.specify # Define requirements → SUMMARIZE /speckit.plan # Technical planning → SUMMARIZE /speckit.tasks # Break down tasks → SUMMARIZE /speckit.implement # Execute

Brownfield 命令:

/speckit.brownfield # Analyze existing code → SUMMARIZE /speckit.analyze-codebase # Deep analysis & constitution → SUMMARIZE /speckit.reverse-engineer # Document existing features → SUMMARIZE /speckit.integration-plan # Plan new feature integration → SUMMARIZE

可选增强命令:

/speckit.clarify # Clarify ambiguous requirements /speckit.analyze # Cross-artifact consistency check /speckit.checklist # Generate quality checklists

当遇到特性检测问题时,可设置 SPECIFY_FEATURE 环境变量(详见安装指南)。

适用场景

  • 0 到 1 开发(Greenfield):从高层需求出发,从零生成规范,规划实现步骤,构建生产就绪的应用。
  • 迭代增强(Brownfield):向既有代码库迭代添加特性、现代化遗留系统、适配不断变化的需求、将既有代码逆向工程为 SDD 格式。
  • 创意探索:并行探索多种方案,支持多种技术栈与架构,试验 UX 模式。

限制

  • 仅当用户明确要求"跳过摘要"或"自动运行所有步骤"、未产生产物变更的重跑命令、命令失败或报错三种情况下才跳过摘要步骤。
  • 摘要与状态跟踪需配合 AI 智能体执行,依赖 AI 原生能力。
  • 关于具体收费、价格、可用平台等信息,资料中暂未提供。