名称: spec-kit-claude-code-工作流 类别: 开发流程 作者: Claude 版本: 1.0.0 标签: [speckit, claude-code, 工作流, 规范, 开发] 描述: 用于指导Spec-Kit + Claude Code开发工作流的概念性技能
Spec-Kit Claude Code 工作流技能
何时使用此技能
当您需要建立并遵循结合Spec-Kit规范和Claude Code辅助的有效开发工作流时，请使用此概念性技能。此技能适用于：
- 以清晰的规范驱动开发启动新项目
- 使用一致的工作流组织多文件夹仓库
- 指导团队成员通过Spec-Kit + Claude Code流程
- 建立规范驱动开发的最佳实践
- 同时迭代规范和实现
- 在不同开发阶段保持一致性
此技能不应用于：
- 没有建立规范的项目
- 没有结构化流程的临时开发
- 偏好无规范的代码优先方法的团队
- 规范会拖慢开发的快速原型设计
先决条件
- 理解Spec-Kit规范概念
- 访问Claude Code以获取AI辅助开发
- 具有已建立文件夹结构的仓库
- 对项目需求和目标的清晰理解
- 承诺采用规范驱动开发方法
概念性实施框架
CLAUDE.md 多文件夹仓库结构能力
- 在根目录CLAUDE.md中定义仓库范围的指南
- 为专业规则创建文件夹特定的CLAUDE.md文件
- 建立从根目录到子文件夹的继承模式
- 记录跨文件夹依赖关系和交互
- 在所有项目文件夹中保持一致的配置
- 在保留全局规则的同时启用文件夹特定的覆盖
规范文件格式化能力
- 定义标准化的规范结构和格式
- 为规范文件建立一致的命名约定
- 为不同类型的规范创建模板
- 实施规范质量的验证规则
- 确保规范清晰、可测试和可实施
- 在同一项目中支持多种规范格式
Claude Code 实施指导能力
- 指导Claude Code在实施过程中参考规范
- 确保代码生成符合规范要求
- 提供关于项目结构和约定的上下文
- 使Claude Code能够询问规范的澄清问题
- 在实施和规范之间建立反馈循环
- 保持规范和代码工件之间的可追溯性
提示迭代和优化能力
- 开发系统性的提示优化方法
- 为提示有效性创建反馈机制
- 为规范和提示改进建立迭代周期
- 记录成功的提示模式以供重用
- 使团队成员能够协作优化提示
- 随时间跟踪提示的演变和有效性
预期输入/输出
输入要求：
-
仓库结构信息：
- 多文件夹仓库布局和组织
- 项目特定要求和约束
- 现有规范文件和文档
- 团队约定和编码标准
- 技术栈和架构决策
-
规范工件：
- 各种格式的功能规范
- 用户故事和需求文档
- 技术架构文档
- API合同和接口定义
- 成功标准和验收测试
-
开发上下文：
- 当前开发阶段或冲刺
- 可用资源和时间限制
- 团队成员专业知识和偏好
- 项目时间线和里程碑
- 质量和安全要求
输出格式：
-
结构化工作流：
- 规范创建和优化的清晰流程
- Claude Code集成的定义步骤
- 具有适当CLAUDE.md文件的组织化仓库结构
- 一致的实施和验证方法
-
规范对齐：
- 符合规范要求的代码
- 规范和实现之间的可追溯性
- 功能到规范部分的清晰映射
- 实施满足成功标准的验证
-
迭代改进：
- 基于实施反馈优化的规范
- 改进的提示以获得更好的Claude Code结果
- 基于经验增强的工作流流程
- 记录的经验教训和最佳实践
-
质量保证：
- 整个项目一致的代码质量
- 适当遵守规范
- 决策和变更的清晰文档
- 维护的项目组织和结构
工作流集成模式
规范优先方法
- 在实施前创建全面的规范
- 使用规范作为开发的唯一来源
- 根据规范验证实施
- 基于实施见解更新规范
迭代开发周期
- 计划规范 → 实施 → 审查 → 优化循环
- 定期检查点以验证规范准确性
- 规范和实施之间的持续反馈
- 基于学习和发现的适应性方法
Claude Code 集成
- 为Claude Code提供清晰的规范上下文
- 使用规范指导代码生成
- 根据规范验证Claude Code输出
- 利用Claude Code进行规范优化
质量保证框架
规范质量
- 确保规范完整、清晰和可测试
- 验证规范与业务需求一致
- 检查规范是否可实施且现实
- 确认规范包含成功标准
实施质量
- 验证代码是否符合规范要求
- 确保代码质量和可维护性标准
- 验证实施是否遵循架构模式
- 确认错误处理和边缘情况已解决
工作流质量
- 保持工作流流程的一致应用
- 确保所有团队成员遵循既定模式
- 监控和改进工作流有效性
- 记录和分享工作流最佳实践
性能考虑
- 平衡规范完整性与开发速度
- 优化提示有效性以提高Claude Code效率
- 简化迭代周期以保持动力
- 在保持质量标准的同时最小化开销
- 确保工作流随团队规模适当扩展
错误处理和验证
- 适当处理不完整或模糊的规范
- 管理规范与实施需求之间的冲突
- 处理规范需要快速更改的情况
- 验证Claude Code输出是否符合规范
- 处理开发周期中的规范演变
沟通与协作
- 为规范变更建立清晰的沟通渠道
- 实现协作规范开发
- 促进关于工作流实践的知识共享
- 为持续改进创建反馈机制
- 支持新团队成员加入工作流