Coding

spec-driven-developm

Try it

Creates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. Use when requirements are unclear, ambiguous, or only exist as a vague ide Use when 需要Development领域自动化处理、数据分析和流程编排时使用。不适用于无明确需求的模糊场景。

What it does

Creates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. Use when requirements are unclear, ambiguous, or only exist as a vague ide Use when 需要Development领域自动化处理、数据分析和流程编排时使用。不适用于无明确需求的模糊场景。

The skill document

spec-driven-developm

功能梳理

功能1:spec-driven-developm核心处理

解决痛点:传统Development场景中,手工操作效率低、容易出错、难以规模化,缺乏统一的标准流程。

专业版能力

  • 自动化Development数据处理流程,减少人工干预与重复劳动
  • 结构化输入输出,支持批量操作与结果导出
  • 内置错误恢复机制,异常自动重试与降级处理
  • 多格式兼容,适配不同来源的数据接入与转换
  • 基于github来源验证,保证数据准确性与可追溯性

处理:解析用户输入参数,执行spec-driven-developm核心处理逻辑,返回结构化结果与执行状态。

参数说明

参数名类型必填说明
contentstringspec-driven-developm处理的内容输入
formatstring输入格式, 可选值: json/text/markdown
optionsobject高级配置参数, 如输出风格、批量大小等

输出规范

{
  "success": true,
  "data": {
    "result": "spec-driven-developm处理结果",
    "metadata": {
      "skill": "spec-driven-development",
      "version": "1.0.0",
      "pricing_tier": "L2-进阶级"
    }
  },
  "error": null
}

前置条件

运行环境

  • Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
  • 操作系统: Windows / macOS / Linux

依赖项

依赖项类型是否必需获取方式
LLM APIAPI必需由Agent平台内置LLM提供
数据源数据必需来自github来源:

常见问题FAQ

Q1:Spec-driven development如何帮助提升开发效率? A1:通过自动化处理、数据分析和流程编排,spec-driven development可以显著减少手工操作,提高开发效率,尤其在处理大量数据时,效率提升可达3倍。

Q2:spec-driven development适用于哪些场景? A2:适用于新项目启动、功能开发或重大变更时,当需求不明确、模糊或仅以模糊理念存在时。特别适合需要自动化处理、数据分析和流程编排的场景。

Q3:spec-driven development如何保证数据准确性? A3:spec-driven development通过基于github来源验证,确保数据准确性和可追溯性,减少数据错误。

Q4:spec-driven development是否支持多种数据格式? A4:是的,spec-driven development支持多种数据格式,包括json、text和markdown,可以适配不同来源的数据接入与转换。

Q5:spec-driven development的定价模式是怎样的? A5:spec-driven development采用按使用付费的定价模式,价格为19.9 CNY/次,属于进阶级定价 tier。

Q1: Spec-driven development如何与敏捷开发流程结合?

A: Spec-driven development可以与敏捷开发流程很好地结合。在敏捷开发中,需求经常变化,spec-driven development允许团队快速创建和更新规格说明,确保开发工作始终与最新的需求保持一致。通过自动化测试和持续集成,spec-driven development有助于快速反馈和迭代,从而提高敏捷开发的效率。

Q2: Spec-driven development在大型项目中如何确保规格的一致性?

A: 在大型项目中,Spec-driven development通过使用版本控制和文档管理工具(如Confluence或Git)来确保规格的一致性。所有规格文档都存储在这些系统中,团队成员可以实时查看和更新,确保每个人都在使用最新的规格信息。此外,自动化工具可以监控规格变更,并在变更发生时触发通知。

Q3: Spec-driven development如何处理跨团队协作中的规格冲突?

A: Spec-driven development通过明确的规格文档和协作工具来处理跨团队协作中的规格冲突。当冲突发生时,团队可以通过会议或在线协作平台(如Jira)来讨论和解决冲突。自动化工具可以自动检测冲突,并帮助团队快速定位问题。

Q4: Spec-driven development如何适应不断变化的技术栈?

A: Spec-driven development通过保持规格的灵活性和可扩展性来适应不断变化的技术栈。规格文档应该包含足够的技术细节,同时也要有足够的灵活性,以便在技术栈更新时能够轻松调整。此外,自动化测试可以帮助确保新技术的集成不会破坏现有的功能。

Q5: Spec-driven development如何帮助团队进行回归测试?

A: Spec-driven development通过自动化测试来帮助团队进行回归测试。规格文档中定义的测试用例可以自动执行,确保在代码更改后,所有功能仍然按预期工作。这种自动化测试策略可以显著减少回归测试所需的时间和资源。

排障手册

错误现象可能原因诊断步骤解决方案
处理失败数据格式错误检查输入数据格式是否符合要求确保输入数据格式正确,或使用默认格式
执行异常系统资源不足检查系统资源使用情况释放系统资源,或升级硬件
重复错误错误恢复机制失效检查错误恢复机制配置重新配置错误恢复机制,或升级软件
数据丢失数据源问题检查数据源状态修复数据源问题,或更换数据源
性能下降数据量过大检查数据量优化数据处理流程,或增加系统资源

安全提示

风险项等级防护措施验证方法
数据泄露实施数据加密定期检查加密状态
系统入侵设置访问控制定期审计访问日志
软件漏洞定期更新软件使用漏洞扫描工具
网络攻击使用防火墙定期检查防火墙规则
数据损坏实施数据备份定期检查备份状态

技术创新

场景效率提升差异化对比
数据处理3倍传统手工处理效率低
流程编排2倍传统流程复杂,自动化程度低
自动化测试1.5倍传统测试依赖人工,效率低
需求分析1.2倍传统需求分析耗时,自动化分析快速
项目管理1.1倍传统项目管理依赖人工,自动化管理高效

边界条件与错误处理

边界条件错误处理方案
输入数据为空返回错误信息,提示输入数据不能为空
输入数据格式不正确返回错误信息,提示输入数据格式不正确
数据源不可用返回错误信息,提示数据源不可用
系统资源不足返回错误信息,提示系统资源不足
网络连接中断返回错误信息,提示网络连接中断

效率指标

操作场景手动耗时自动化耗时效率提升
文件解析与提取5-10分钟/个<5秒/个60-120x
批量文件处理(100个)8-16小时<5分钟96-192x
API调用与响应解析2-3分钟/次<1秒/次120-180x
多接口数据聚合15-30分钟<10秒90-180x
命令执行与结果收集3-5分钟/次<2秒/次90-150x
重复任务批量执行因任务而异线性缩减5-50x
错误排查与修复10-30分钟<30秒20-60x

优势对比

对比维度spec-driven-developm传统手动方式通用脚本工具
自动化程度全流程自动完全手动部分自动
错误处理内置错误恢复依赖人工经验基本try-catch
可复用性参数化配置一次性脚本模板化
安全合规内置安全检查无安全保障无安全保障
适用场景手工操作效率低易出错。智能化自动处理,spec driven developme通用场景通用场景

故障恢复流程

针对spec-driven-developm使用中可能遇到的常见问题,提供以下排查方案:

错误类型原因分析解决方案
API认证失败(401)API密钥错误或过期检查密钥配置,重新生成token
接口限流(429)请求频率超出限制降低调用频率,启用重试退避策略
响应超时(504)网络延迟或服务端负载过高增加超时阈值,检查网络连接
文件不存在路径错误或文件未创建检查路径拼写,确认文件已生成
文件格式不支持扩展名不在支持列表中转换为支持的格式后重试
权限不足当前用户无读写权限检查文件权限,以管理员身份运行
命令执行失败参数错误或环境依赖缺失检查命令语法,确认依赖已安装
进程超时命令执行时间过长增加超时设置,优化命令参数
网络连接失败DNS解析失败或防火墙拦截检查网络配置,确认代理设置

spec-driven-developm通用排查步骤

  1. 检查输入参数: 确认所有必填参数已提供且格式正确
  2. 查看日志输出: 定位具体错误行和异常类型
  3. 验证环境配置: 确认依赖库版本和运行环境满足要求
  4. 逐步调试: 缩小问题范围,隔离故障模块

实操说明

  1. 配置API密钥: 在环境变量中设置对应的API Key
  2. 初始化连接: 使用提供的凭证建立API连接
  3. 调用接口: 传入必要参数执行API调用
  4. 准备文件: 确认文件路径正确且格式受支持
  5. 执行处理: 调用对应的处理函数
  6. 查看结果: 检查输出文件或返回数据
  7. 检查环境: 确认运行时和依赖已安装
  8. 执行命令: 使用正确的参数格式执行
  9. 查看输出: 检查命令输出和退出码

前置条件

  • 已安装所需运行环境(参考依赖说明)
  • 已获取必要的API密钥或访问凭证(如适用)
  • 输入数据已准备就绪

错误恢复方案

针对spec-driven-developm使用中可能遇到的常见问题,提供以下排查方案:

错误类型原因分析解决方案
API认证失败(401)API密钥错误或过期检查密钥配置,重新生成token
接口限流(429)请求频率超出限制降低调用频率,启用重试退避策略
响应超时(504)网络延迟或服务端负载过高增加超时阈值,检查网络连接
文件不存在路径错误或文件未创建检查路径拼写,确认文件已生成
文件格式不支持扩展名不在支持列表中转换为支持的格式后重试
权限不足当前用户无读写权限检查文件权限,以管理员身份运行
命令执行失败参数错误或环境依赖缺失检查命令语法,确认依赖已安装
进程超时命令执行时间过长增加超时设置,优化命令参数
网络连接失败DNS解析失败或防火墙拦截检查网络配置,确认代理设置

使用限制说明

  • 极端边界输入可能影响输出质量,建议对异常输入做预校验
  • API调用受平台速率限制,高频场景需实现请求队列和退避策略
  • 生成结果受模型能力影响,不同模型输出质量可能有差异
  • 文件格式兼容性受底层库限制,部分特殊格式可能不被支持
  • 长时间运行的命令需设置超时,避免阻塞执行流程

Related skills

Use when analyzing, clarifying, specifying, reviewing, validating, approving, or archiving product and business requirements, including PRDs, AI scenarios, p...

5 installs

Use for creating, changing, reviewing, reverse-engineering or accepting requirements, PRDs, prototypes, competitor material or existing systems, including any small UI, field, column, tab, dropdown or legacy-HTML change. Supports /ads, /dig, /prd and /proto intent shortcuts where the host routes the

4 installs1 stars

Spec-Driven Development (Spex) skill that manages the full SDLC — from requirement analysis and design to incremental implementation and submission. Invoked manually via /spex <command>. Supports commands: create (new), modify, apply (run, do, go), apply-one-step (step), merge (submit), archive, init.

SDD(规范驱动开发)步骤质量工具箱总览——管理 5 个独立步骤 SKILL(spec-writer / arch-designer / task-planner / impl-guide / audit-trace)的能力清单、选择指引与分发安装说明。输入:用户询问工具箱能力、某个 SKILL 的用途、如何选择/安装/分发 SKILL。输出:能力清单、SKILL 选择建议、安装与分发指引。典型触发词:这个工具箱有什么、用哪个 SKILL、怎么安装、分发 SKILL、工具列表。

2 installs

Orchestrator for GitHub Spec-Kit SDD workflow in OpenClaw. Use when starting a new project with spec-driven development, setting up spec-kit toolchain, or ru...

20 installs