mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-05 01:50:27 +08:00
Major Features: - Add /workflow:lite-plan - Lightweight interactive planning workflow - Three-dimensional multi-select confirmation - Smart code exploration with auto-detection - Parallel task execution support - Flexible execution (Agent/CLI) with optional code review - Optimize CLI tools - Remove -m parameter requirement - Auto-model-selection for Gemini, Qwen, Codex - Updated models: gpt-5.1, gpt-5.1-codex, gpt-5.1-codex-mini Documentation Updates: - Update README.md with Lite-Plan usage examples - Update README_CN.md (Chinese translation) - Add /workflow:lite-plan to COMMAND_SPEC.md - Add /workflow:lite-plan to COMMAND_REFERENCE.md - Update CHANGELOG.md with v5.8.1 release notes - Update intelligent-tools-strategy.md with model selection guidelines See CHANGELOG.md for full details.
6.7 KiB
6.7 KiB
🚀 Claude Code Workflow (CCW)
Claude Code Workflow (CCW) 将 AI 开发从简单的提示词链接转变为一个强大的、上下文优先的编排系统。它通过结构化规划、确定性执行和智能多模型编排,解决了执行不确定性和误差累积的问题。
🎉 版本 5.8.1: Lite-Plan 工作流与 CLI 工具增强
核心改进:
- ✨ Lite-Plan 工作流 (
/workflow:lite-plan) - 轻量级交互式规划与智能自动化
- 三维多选确认: 任务批准 + 执行方法 + 代码审查工具
- 智能代码探索: 自动检测何时需要代码库上下文(使用
-e标志强制探索)- 并行任务执行: 识别独立任务以实现并发执行
- 灵活执行: 选择智能体(@code-developer)或 CLI(Gemini/Qwen/Codex)
- 可选后置审查: 内置代码质量分析,可选择 AI 工具
- ✨ CLI 工具优化 - 简化命令语法,自动模型选择
- 移除 Gemini、Qwen 和 Codex 的
-m参数要求(自动选择最佳模型)- 更清晰的命令结构和改进的文档
- 🔄 执行工作流增强 - 简化阶段,采用延迟加载策略
- 🎨 CLI Explore Agent - 改进可见性,采用黄色配色方案
详见 CHANGELOG.md。
📚 第一次使用 CCW? 查看 快速上手指南 获取新手友好的 5 分钟教程!
✨ 核心概念
CCW 构建在一系列核心原则之上,这些原则使其与传统的 AI 开发方法区别开来:
- 上下文优先架构: 通过预定义的上下文收集,消除了执行过程中的不确定性,确保智能体在实现之前就拥有正确的信息。
- JSON 优先的状态管理: 任务状态完全存储在
.task/IMPL-*.json文件中,作为唯一的事实来源,实现了无需状态漂移的程序化编排。 - 自主多阶段编排: 命令链式调用专门的子命令和智能体,以零用户干预的方式自动化复杂的工作流。
- 多模型策略: 充分利用不同 AI 模型(如 Gemini 用于分析,Codex 用于实现)的独特优势,以获得更优越的结果。
- 分层内存系统: 一个 4 层文档系统,在适当的抽象级别上提供上下文,防止信息过载。
- 专门的基于角色的智能体: 一套模拟真实软件团队的智能体(
@code-developer,@test-fix-agent等),用于处理多样化的任务。
⚙️ 安装
有关详细的安装说明,请参阅 INSTALL_CN.md 指南。
🚀 一键快速安装
Windows (PowerShell):
Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/catlog22/Claude-Code-Workflow/main/install-remote.ps1" -UseBasicParsing).Content
Linux/macOS (Bash/Zsh):
bash <(curl -fsSL https://raw.githubusercontent.com/catlog22/Claude-Code-Workflow/main/install-remote.sh)
✅ 验证安装
安装后,打开 Claude Code 并通过运行以下命令检查工作流命令是否可用:
/workflow:session:list
如果斜杠命令(例如 /workflow:*)被识别,则表示安装成功。
🛠️ 命令参考
CCW 提供了一套丰富的命令,用于管理工作流、任务以及与 AI 工具的交互。有关所有可用命令的完整列表和详细说明,请参阅 COMMAND_REFERENCE.md 文件。
有关每个命令的详细技术规范,请参阅 COMMAND_SPEC.md。
💡 需要帮助?使用交互式命令指南
CCW 包含内置的命令指南技能,帮助您有效地发现和使用命令:
CCW-help- 获取交互式帮助和命令推荐CCW-issue- 使用引导模板报告错误或请求功能
命令指南提供:
- 🔍 智能命令搜索 - 按关键词、分类或使用场景查找命令
- 🤖 下一步推荐 - 获取任何命令之后的操作建议
- 📖 详细文档 - 查看参数、示例和最佳实践
- 🎓 新手入门 - 通过引导式学习路径学习 14 个核心命令
- 📝 问题报告 - 生成标准化的错误报告和功能请求
使用示例:
用户: "CCW-help"
→ 交互式菜单,包含命令搜索、推荐和文档
用户: "执行完 /workflow:plan 后做什么?"
→ 推荐 /workflow:execute、/workflow:action-plan-verify 及工作流模式
用户: "CCW-issue"
→ 引导式模板生成,用于错误、功能或问题咨询
🚀 快速入门
开始使用的最佳方式是遵循 快速上手指南 中的 5 分钟教程。
以下是一个常见开发工作流的快速示例:
选项 1: Lite-Plan 工作流 (⚡ 推荐用于快速任务)
轻量级交互式工作流,内存中规划并立即执行:
# 基本用法,自动检测
/workflow:lite-plan "为用户登录添加 JWT 认证"
# 强制代码探索
/workflow:lite-plan -e "重构日志模块以提高性能"
# 预设 CLI 工具
/workflow:lite-plan --tool codex "为认证服务添加单元测试"
交互流程:
- 阶段 1: 自动任务分析和智能代码探索(如需要)
- 阶段 2: 回答澄清问题(如有)
- 阶段 3: 查看生成的计划和任务分解
- 阶段 4: 三维确认:
- ✅ 确认/修改/取消任务
- 🔧 选择执行方式: 智能体 / 仅提供计划 / CLI(Gemini/Qwen/Codex)
- 🔍 可选代码审查: 否 / Claude / Gemini / Qwen / Codex
- 阶段 5: 观察实时执行和任务跟踪
选项 2: 完整工作流 (综合规划)
适用于复杂项目的传统多阶段工作流:
- 创建计划(自动启动会话):
/workflow:plan "实现基于 JWT 的用户登录和注册" - 执行计划:
/workflow:execute - 查看状态(可选):
/workflow:status
🤝 贡献与支持
- 仓库: GitHub - Claude-Code-Workflow
- 问题: 在 GitHub Issues 上报告错误或请求功能。
- 讨论: 加入 社区论坛。
📄 许可证
此项目根据 MIT 许可证 授权。详见 LICENSE 文件。