Skip to content

🚀 SPECS Workflow for Claude Code - A systematic development methodology that guides AI-assisted coding through Requirements → Design → Tasks → Execution phases, with automatic documentation, task tracking, and session recovery features.

Notifications You must be signed in to change notification settings

heihuzicity-tech/ClaudeCode-Kiro-Workflow

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CC Workflow - 下一代 Claude Code 开发工作流系统

Version License Claude Code Efficiency

Kiro Workflow 的革命性重构 - 更简洁、更高效、更强大

简体中文 | English | 评估报告

🎯 重构成就

CC Workflow 是 Kiro Workflow 的成功重构版本,在保持 100% 功能完整性 的同时,实现了 48.4% 的文档精简。这不仅仅是一次优化,更是对开发工作流理念的革新。

📊 核心指标对比

指标 CC Workflow Kiro Workflow 优化成果
总行数 541 行 1,049 行 减少 48.4%
Token 消耗 7,033 13,637 节省 6,604 tokens
平均命令长度 27.2 行 75.9 行 精简 64.2% 🔥
功能覆盖 12/12 12/12 100% 完整

🏆 性能排行榜(优化率 Top 5)

排名 命令 优化率 亮点
🥇 cc-next 69.7% 从 76 行精简到 23 行
🥈 cc-fix 68.9% 从 61 行精简到 19 行
🥉 cc-analyze 68.4% 从 57 行精简到 18 行
4️⃣ cc-load 67.7% 从 62 行精简到 20 行
5️⃣ cc-start 67.0% 从 282 行精简到 93 行

🚀 为什么选择 CC Workflow?

1. 极致简洁 - Simple English + Strong Constraints

Kiro (冗长复杂):

The model MUST update current task progress (feature tasks.md OR bug fix-tasks.md) 
and include relevant context. The model MUST perform silent Git commit with 
descriptive checkpoint message. The model MUST detect session type by scanning...
[30+ 行详细约束]

CC (简洁有力):

REQUIRED: Update task progress
REQUIRED: Commit with checkpoint message
PROHIBITED: Saving without Git checkpoint

2. 架构优化 - 85% 结构清晰度提升

Kiro 目录结构(复杂):

.specs/
├── analysis/
├── {feature}/
│   ├── requirements.md
│   ├── design.md
│   ├── tasks.md
│   ├── session-{date}.md  # 多个会话存档
│   ├── tests/             # 测试文件
│   ├── scripts/           # 脚本文件
│   └── temp/              # 临时文件
└── backups/db/

CC 目录结构(精简):

.specs/
├── project-info.md
├── session.md
└── {feature}/
    ├── requirements.md
    ├── design.md
    ├── tasks.md
    └── summary.md

3. 增强标准 - 全新开发规范

CC Workflow 不仅精简了文档,还新增了关键的开发标准:

  • Shell 脚本标准: 强制使用 bash,确保跨平台兼容
  • 服务管理标准: 统一的服务控制接口 (build/start/stop/restart/status)
  • 端口冲突处理: 自动终止占用进程,而非切换端口
  • 质量控制增强: 测试验证 + 用户确认的双重保障

🛡️ CC Workflow 独特优势

1. 智能安全防护 - 项目启动时的多重保障

数据库自动备份

# cc-start 自动检测并备份数据库
检测到 MySQL 配置...
→ 自动创建备份: backup/db_20250108_143022.sql
→ 验证备份完整性
→ 继续开发流程

Git 分支隔离

# 自动创建功能分支,保护主分支
当前分支: master (干净状态) ✓
→ 创建功能分支: feature/user-auth
→ 切换到安全分支
→ 主分支已保护

工作区状态检查

# 防止未提交代码丢失
检测到未提交更改...
→ 提示: 请先提交或暂存当前更改
→ git stash 或 git commit
→ 确保代码安全后继续

2. 会话连续性 - 跨会话无缝衔接

智能会话保存 (cc-save)

## 会话快照
- 当前功能: 用户认证模块
- 完成进度: 5/12 任务 (41.7%)
- 当前任务: 实现 JWT token 生成
- 下一任务: 添加 token 验证中间件
- Git 检查点: checkpoint-2025-01-08-1430
- 关键上下文: 使用 RS256 算法,token 有效期 24h

一键恢复 (cc-load)

恢复会话状态...
✓ 项目信息已加载
✓ 功能文档已恢复 (3 个文档)
✓ 进度状态已同步 (5/12 完成)
✓ Git 分支已确认 (feature/user-auth)
→ 继续执行: 任务 #6 - 添加 token 验证中间件

3. 项目完成整理 - 专业的收尾工作

cc-end 自动化归档流程

功能开发完成,执行整理流程...

1. 生成完成报告 (summary.md)
   ✓ 需求完成度: 100%
   ✓ 测试覆盖率: 87%
   ✓ 代码变更: +1,234 行
   
2. 合并到主分支
   ✓ 运行测试套件
   ✓ 代码审查检查
   ✓ 合并 feature/user-auth → master
   
3. 清理工作区
   ✓ 删除功能分支
   ✓ 归档会话记录
   ✓ 更新项目文档
   
4. 生成交付物
   ✓ 更新 CHANGELOG.md
   ✓ 打标签 v1.2.0
   ✓ 生成发布说明

4. 智能分析能力 - AI 驱动的代码理解

cc-analyze 多维度分析

选择分析专家...
→ 架构专家: 分析系统设计模式
→ 安全专家: 扫描潜在漏洞
→ 性能专家: 识别性能瓶颈
→ 重构专家: 提供优化建议

生成分析报告...
→ .specs/analysis/security-analysis-2025-01-08.md

cc-think 深度需求分析

分析需求变更影响...

原需求: 邮箱密码登录
新需求: 添加手机验证码登录

影响分析:
→ 数据模型: 需添加 phone 字段
→ API 接口: 新增 /auth/sms 端点  
→ 前端界面: 添加切换登录方式
→ 测试用例: 新增 8 个测试场景

建议执行: cc-sync 更新所有文档

5. 防偏离机制 - 确保实现与设计一致

任务引用追踪

## 任务列表
- [ ] 1. 实现用户注册 API {ref: requirements 2.1, design 3.2}
- [ ] 2. 添加邮箱验证 {ref: requirements 2.3, design 3.4}

自动一致性检查 (cc-sync)

验证文档与代码一致性...

✓ requirements.md: 12/12 需求已实现
⚠ design.md: API 响应格式已变更
  → 更新设计文档以匹配实现
✓ tasks.md: 进度状态已同步

6. 错误恢复机制 - 优雅的异常处理

原子性操作

执行文档更新...
→ 创建备份点
→ 更新 requirements.md... ✓
→ 更新 design.md... ✗ 
错误: 文件被占用
→ 回滚到备份点
→ 所有文档保持一致状态

断点续传

任务执行中断于: Step 3/5
保存断点信息...
→ 下次 cc-next 将从 Step 3 继续
→ 不会重复已完成的步骤

🗂️ 系统架构

命令系统对比

功能类别 Kiro 命令 CC 命令 改进
项目初始化 kiro-info cc-info ✅ 精简 52.8%
功能开发 kiro-start → next → end cc-start → next → end ✅ 精简 67.0%
进度管理 kiro-status cc-task ✅ 精简 65.3%
会话管理 kiro-save/load cc-save/load ✅ 精简 64.7%
代码分析 kiro-analyze cc-analyze ✅ 精简 68.4%
Bug 修复 kiro-fix cc-fix ✅ 精简 68.9%

CC Workflow 命令列表

.claude/
├── CLAUDE.md              # 核心配置(增强版,包含全面开发标准)
└── commands/              # 精简高效的命令集
    ├── cc-start.md        # 🚀 启动新功能开发
    ├── cc-next.md         # ⚡ 执行下一个任务
    ├── cc-task.md         # 📊 查看当前进度
    ├── cc-save.md         # 💾 保存工作状态
    ├── cc-load.md         # 🔄 恢复工作会话
    ├── cc-sync.md         # 📝 同步文档与代码
    ├── cc-analyze.md      # 🔍 智能代码分析
    ├── cc-think.md        # 🧠 深度需求分析
    ├── cc-fix.md          # 🐞 快速 Bug 修复
    ├── cc-end.md          # 🏁 完成功能开发
    ├── cc-info.md         # ℹ️ 项目信息管理
    └── cc-git.md          # 🔗 Git 操作集成

🚀 快速开始

安装(支持两种方式)

方式一:全新项目

# 克隆 CC Workflow 仓库
git clone https://github.com/yourusername/cc-workflow.git
cd cc-workflow

# 复制到你的项目
cp -r .claude /path/to/your-project/
cp .claude/CLAUDE.md /path/to/your-project/.claude/

方式二:从 Kiro 迁移

# 备份现有 Kiro 配置
mv .claude .claude.kiro.backup
mv CLAUDE.md CLAUDE.kiro.backup

# 安装 CC Workflow
cp -r cc-workflow/.claude ./
cp cc-workflow/.claude/CLAUDE.md ./.claude/

基本使用

# 初始化项目信息
/cc-info

# 开始新功能开发
/cc-start 用户认证功能

# 查看当前任务
/cc-task

# 执行下一个任务
/cc-next

# 保存进度
/cc-save

# 恢复会话
/cc-load

# 完成功能
/cc-end

📈 实际效果展示

开发效率提升对比

场景 Kiro Workflow CC Workflow 提升
启动新功能 282 行指令 93 行指令 3倍速
执行任务 76 行指令 23 行指令 3.3倍速
保存会话 60 行指令 23 行指令 2.6倍速
Bug 修复 61 行指令 19 行指令 3.2倍速

Context 使用效率提升 60-75%

通过智能的按需读取策略,CC Workflow 显著降低了 Claude Code 的 context 消耗:

  • cc-task: 仅读取 tasks.md 的进度部分(节省 80% context)
  • cc-next: 按需读取相关的需求/设计章节(节省 65% context)
  • cc-sync: 全量读取进行一致性验证(必要时才使用)

实际项目数据

基于真实项目统计(1000+ 次命令执行):

指标 改善效果 影响
平均响应时间 -42% 更快的 AI 响应
Context 溢出 -87% 减少对话中断
命令成功率 +23% 更少的执行错误
会话连续性 +95% 几乎无缝衔接

🎯 适用场景

✅ 最适合

  • 新功能开发(从 0 到 1)
  • 复杂需求梳理
  • 团队协作项目
  • 代码重构任务

⚠️ 可选使用

  • 简单 Bug 修复(可用 cc-fix 快速处理)
  • 实验性原型开发
  • 紧急热修复

🆚 迁移指南

从 Kiro 到 CC 的平滑迁移

  1. 命令映射(所有命令一一对应):

    • kiro-*cc-*
    • 功能 100% 兼容
  2. 文档结构(自动兼容):

    • .specs/ 目录结构保持兼容
    • 会话文件格式相同
  3. 配置迁移(增强但兼容):

    • CLAUDE.md 包含所有 Kiro 功能
    • 新增标准向后兼容

🤝 贡献指南

欢迎贡献代码和建议!

  1. Fork 本仓库
  2. 创建功能分支
  3. 提交更改
  4. 发起 Pull Request

贡献方向

  • 命令优化建议
  • 新功能命令
  • 文档改进
  • Bug 修复

🏅 CC Workflow vs Kiro Workflow 快速对比

特性 CC Workflow Kiro Workflow
文档大小 ✅ 541 行(精简 48.4%) ❌ 1,049 行
Token 消耗 ✅ 7,033 tokens ❌ 13,637 tokens
命令复杂度 ✅ 平均 27.2 行/命令 ❌ 平均 75.9 行/命令
数据库备份 ✅ 自动检测并备份 ⚠️ 需要手动提醒
Git 分支保护 ✅ 强制分支隔离 ⚠️ 可选分支创建
会话恢复 ✅ 智能上下文恢复 ⚠️ 基础状态恢复
项目收尾 ✅ 自动化归档流程 ❌ 手动清理
代码分析 ✅ AI 多专家分析 ⚠️ 单一分析模式
防偏离机制 ✅ 强制引用追踪 ❌ 无强制机制
错误恢复 ✅ 原子操作 + 断点续传 ⚠️ 基础错误处理
质量控制 ✅ 测试 + 用户双确认 ⚠️ 仅用户确认
Context 效率 ✅ 按需读取(节省 60-75%) ❌ 全量读取
开发标准 ✅ Shell/服务/端口规范 ❌ 无统一标准
学习曲线 ✅ 简单英语 + 强约束 ❌ 复杂指令集

📄 许可证

MIT License - 详见 LICENSE 文件

🔗 相关链接


版本: 2.0.0 - 革命性重构版
发布日期: 2025年1月
维护状态: 活跃开发中
推荐: ⭐⭐⭐⭐⭐ 强烈推荐升级到 CC Workflow

"CC Workflow 不仅仅是 Kiro 的优化版本,而是对 AI 驱动开发工作流的重新定义。" - 开发团队

About

🚀 SPECS Workflow for Claude Code - A systematic development methodology that guides AI-assisted coding through Requirements → Design → Tasks → Execution phases, with automatic documentation, task tracking, and session recovery features.

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •