还好找到了这个claude-code-spec开源项目,可以作为spec模式的平替,搭配最强开发CIL一起搞事情,一样很行!

claude-code-spec
项目背景
claude-code-spec项目是一个基于Claude Code的Kiro式规范驱动开发系统,其设计目标是将Kiro IDE中成熟的规范驱动开发流程移植到Claude Code环境中。系统实现了一个严格的三阶段审批工作流程(需求→设计→任务),确保每个开发阶段都有人工审核和明确批准。
技术实现背景
项目采用Claude Code的扩展系统架构,通过钩子和斜杠命令实现Kiro式规范驱动开发工作流。这种设计允许开发者在Claude Code环境中享受到与Kiro IDE相同的结构化开发体验。
规格驱动开发流程
流程图
在此流程中,每个阶段都需要「审查与核准」。
Steering 文件 :记录项目持久知识(架构、技术栈、程序规范等),建立与维护 steering 文件虽非强制,但对长期维护极有帮助。

解决的问题
该系统主要解决以下开发痛点:
-
开发风险控制 - 通过结构化方法在早期发现问题
-
团队协作改善 - 清晰的规范和审批流程
-
文档维护 - 活跃的指导文档保持项目知识同步
使用方法
项目设置
首先,将以下两个文件/目录复制到项目中:
-
.claude/commands/
目录 - 斜杠命令定义 -
CLAUDE.md
文件 - Claude Code配置和项目指令
基本开发流程
阶段0:指导文档生成(推荐)
/steering-init # 生成初始指导文档
/steering-update # 变更后更新指导文档
/steering-custom # 为特殊上下文创建自定义指导文档
阶段1:规范创建的三阶段审批工作流
系统的核心是严格的三阶段审批流程:
-
需求生成与审批
-
-
使用
/spec-requirements [feature-name]
生成需求文档 -
人工审查和编辑
requirements.md
-
在
spec.json
中手动审批(设置"requirements": true
)
-
-
设计生成与审批
-
-
使用
/spec-design [feature-name]
生成技术设计(需要需求审批后) -
人工审查和编辑
design.md
-
在
spec.json
中手动审批(设置"design": true
)
-
-
任务生成与审批
-
-
使用
/spec-tasks [feature-name]
生成实现任务(需要设计审批后) -
人工审查和编辑
tasks.md
-
在
spec.json
中手动审批(设置"tasks": true
)
-
阶段2:进度跟踪
/spec-status [feature-name] # 检查当前进度和阶段
实际使用示例
新项目的情况:
# 步骤1:从项目描述初始化规范结构
/spec-init "用户可以上传PDF并提取其中的图表,AI解释内容的功能"
# 步骤2:需求定义
/spec-requirements pdf-diagram-extractor
# 步骤3:手动审批(在spec.json中设置 "requirements": true)
# 步骤4:技术设计
/spec-design pdf-diagram-extractor
# 步骤5:手动审批(在spec.json中设置 "design": true)
# 步骤6:任务生成
/spec-tasks pdf-diagram-extractor
# 步骤7:手动审批(在spec.json中设置 "tasks": true)
# 步骤8:开始实现
文件结构
系统使用以下结构管理文件:
.kiro/
├── steering/ # 项目指导文档
│ ├── product.md # 产品概述
│ ├── tech.md # 技术栈
│ └── structure.md # 代码组织
└── specs/ # 功能规范
└── [feature]/
├── spec.json # 审批状态管理
├── requirements.md # 需求定义
├── design.md # 技术设计
└── tasks.md # 实现任务
自动化功能
通过Claude Code的钩子功能实现以下自动化:
-
任务进度的自动跟踪
-
规范遵循检查
-
压缩时的上下文保持
-
指导偏移检测