Drive development from authoritative source documentation and specifications
编程
spec-driven-developm
试用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领域自动化处理、数据分析和流程编排时使用。不适用于无明确需求的模糊场景。
它能做什么
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领域自动化处理、数据分析和流程编排时使用。不适用于无明确需求的模糊场景。
技能文档
spec-driven-developm
功能梳理
功能1:spec-driven-developm核心处理
解决痛点:传统Development场景中,手工操作效率低、容易出错、难以规模化,缺乏统一的标准流程。
专业版能力:
- 自动化Development数据处理流程,减少人工干预与重复劳动
- 结构化输入输出,支持批量操作与结果导出
- 内置错误恢复机制,异常自动重试与降级处理
- 多格式兼容,适配不同来源的数据接入与转换
- 基于github来源验证,保证数据准确性与可追溯性
处理:解析用户输入参数,执行spec-driven-developm核心处理逻辑,返回结构化结果与执行状态。
参数说明
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| content | string | 是 | spec-driven-developm处理的内容输入 |
| format | string | 否 | 输入格式, 可选值: json/text/markdown |
| options | object | 否 | 高级配置参数, 如输出风格、批量大小等 |
输出规范
{
"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 API | API | 必需 | 由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通用排查步骤
- 检查输入参数: 确认所有必填参数已提供且格式正确
- 查看日志输出: 定位具体错误行和异常类型
- 验证环境配置: 确认依赖库版本和运行环境满足要求
- 逐步调试: 缩小问题范围,隔离故障模块
实操说明
- 配置API密钥: 在环境变量中设置对应的API Key
- 初始化连接: 使用提供的凭证建立API连接
- 调用接口: 传入必要参数执行API调用
- 准备文件: 确认文件路径正确且格式受支持
- 执行处理: 调用对应的处理函数
- 查看结果: 检查输出文件或返回数据
- 检查环境: 确认运行时和依赖已安装
- 执行命令: 使用正确的参数格式执行
- 查看输出: 检查命令输出和退出码
前置条件
- 已安装所需运行环境(参考依赖说明)
- 已获取必要的API密钥或访问凭证(如适用)
- 输入数据已准备就绪
错误恢复方案
针对spec-driven-developm使用中可能遇到的常见问题,提供以下排查方案:
| 错误类型 | 原因分析 | 解决方案 |
|---|---|---|
| API认证失败(401) | API密钥错误或过期 | 检查密钥配置,重新生成token |
| 接口限流(429) | 请求频率超出限制 | 降低调用频率,启用重试退避策略 |
| 响应超时(504) | 网络延迟或服务端负载过高 | 增加超时阈值,检查网络连接 |
| 文件不存在 | 路径错误或文件未创建 | 检查路径拼写,确认文件已生成 |
| 文件格式不支持 | 扩展名不在支持列表中 | 转换为支持的格式后重试 |
| 权限不足 | 当前用户无读写权限 | 检查文件权限,以管理员身份运行 |
| 命令执行失败 | 参数错误或环境依赖缺失 | 检查命令语法,确认依赖已安装 |
| 进程超时 | 命令执行时间过长 | 增加超时设置,优化命令参数 |
| 网络连接失败 | DNS解析失败或防火墙拦截 | 检查网络配置,确认代理设置 |
使用限制说明
- 极端边界输入可能影响输出质量,建议对异常输入做预校验
- API调用受平台速率限制,高频场景需实现请求队列和退避策略
- 生成结果受模型能力影响,不同模型输出质量可能有差异
- 文件格式兼容性受底层库限制,部分特殊格式可能不被支持
- 长时间运行的命令需设置超时,避免阻塞执行流程
相关技能
Use when analyzing, clarifying, specifying, reviewing, validating, approving, or archiving product and business requirements, including PRDs, AI scenarios, p...
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
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、工具列表。
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...