diff --git a/CHANGELOG.md b/CHANGELOG.md index 44cc94e0..a87fa3fa 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,71 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). +## [5.8.1] - 2025-01-16 + +### ⚡ Lite-Plan Workflow & CLI Tools Enhancement + +This release introduces a powerful new lightweight planning workflow with intelligent automation and optimized CLI tool usage. + +#### ✨ Added + +**Lite-Plan Workflow** (`/workflow:lite-plan`): +- ✨ **Interactive Lightweight Workflow** - Fast, in-memory planning and execution + - **Phase 1: Task Analysis & Smart Exploration** (30-90s) + - Auto-detects when codebase context is needed + - Optional `@cli-explore-agent` for code understanding + - Force exploration with `-e` or `--explore` flag + - **Phase 2: Interactive Clarification** (user-dependent) + - Ask follow-up questions based on exploration findings + - Gather missing information before planning + - **Phase 3: Adaptive Planning** (20-60s) + - Low complexity: Direct planning by Claude + - Medium/High complexity: Delegate to `@cli-planning-agent` + - **Phase 4: Three-Dimensional Multi-Select Confirmation** (user-dependent) + - ✅ **Task Approval**: Allow / Modify / Cancel (with optional supplements) + - 🔧 **Execution Method**: Agent / Provide Plan / CLI (Gemini/Qwen/Codex) + - 🔍 **Code Review**: No / Claude / Gemini / Qwen / Codex + - **Phase 5: Live Execution & Tracking** (5-120min) + - Real-time TodoWrite progress updates + - Parallel task execution for independent tasks + - Optional post-execution code review +- ✨ **Parallel Task Execution** - Identifies independent tasks for concurrent execution +- ✨ **Flexible Tool Selection** - Preset with `--tool` flag or choose during confirmation +- ✨ **No File Artifacts** - All planning stays in memory for faster workflow + +#### 🔄 Changed + +**CLI Tools Optimization**: +- 🔄 **Simplified Command Syntax** - Removed `-m` parameter requirement + - Gemini: Auto-selects `gemini-2.5-pro` (default) or `gemini-2.5-flash` + - Qwen: Auto-selects `coder-model` (default) or `vision-model` + - Codex: Auto-selects `gpt-5.1` (default), `gpt-5.1-codex`, or `gpt-5.1-codex-mini` +- 🔄 **Improved Model Selection** - Tools now auto-select best model for task +- 🔄 **Updated Documentation** - Clearer guidelines in `intelligent-tools-strategy.md` + +**Execution Workflow Enhancement**: +- 🔄 **Streamlined Phases** - Simplified execution phases with lazy loading strategy +- 🔄 **Enhanced Error Handling** - Improved error messages and recovery options +- 🔄 **Clarified Resume Mode** - Better documentation for workflow resumption + +**CLI Explore Agent**: +- 🎨 **Improved Visibility** - Changed color scheme from blue to yellow + +#### 📝 Documentation + +**Updated Files**: +- 🔄 **README.md / README_CN.md** - Added Lite-Plan workflow usage examples +- 🔄 **COMMAND_REFERENCE.md** - Added `/workflow:lite-plan` entry +- 🔄 **COMMAND_SPEC.md** - Added detailed technical specification for Lite-Plan +- 🔄 **intelligent-tools-strategy.md** - Updated model selection guidelines + +#### 🐛 Bug Fixes + +- Fixed command syntax inconsistencies in CLI tool documentation +- Improved task dependency detection for parallel execution + +--- + ## [5.5.0] - 2025-11-06 ### 🎯 Interactive Command Guide & Enhanced Documentation diff --git a/COMMAND_REFERENCE.md b/COMMAND_REFERENCE.md index c73ad5e6..5229ec42 100644 --- a/COMMAND_REFERENCE.md +++ b/COMMAND_REFERENCE.md @@ -38,6 +38,7 @@ These commands orchestrate complex, multi-phase development processes, from plan | Command | Description | |---|---| | `/workflow:plan` | Orchestrate 5-phase planning workflow with quality gate, executing commands and passing context between phases. | +| `/workflow:lite-plan` | ⚡ **NEW** Lightweight interactive planning and execution workflow with in-memory planning, smart code exploration, three-dimensional multi-select confirmation (task approval + execution method + code review), and parallel task execution support. | | `/workflow:execute` | Coordinate agents for existing workflow tasks with automatic discovery. | | `/workflow:resume` | Intelligent workflow session resumption with automatic progress analysis. | | `/workflow:review` | Optional specialized review (security, architecture, docs) for completed implementation. | diff --git a/COMMAND_SPEC.md b/COMMAND_SPEC.md index afc65819..2d5bac7b 100644 --- a/COMMAND_SPEC.md +++ b/COMMAND_SPEC.md @@ -45,6 +45,44 @@ High-level orchestrators for complex, multi-phase development processes. /workflow:plan "Create a simple Express API that returns Hello World" ``` +### **/workflow:lite-plan** ⚡ NEW + +- **Syntax**: `/workflow:lite-plan [--tool claude|gemini|qwen|codex] [-e|--explore] "task description"|file.md` +- **Parameters**: + - `--tool` (Optional, String): Preset CLI tool for execution (claude|gemini|qwen|codex). If not provided, user selects during confirmation. + - `-e, --explore` (Optional, Flag): Force code exploration phase (overrides auto-detection logic). + - `task description|file.md` (Required, String): Task description or path to .md file. +- **Responsibilities**: Lightweight interactive planning and execution workflow with 5 phases: + 1. **Task Analysis & Exploration**: Auto-detects need for codebase context, optionally launches `@cli-explore-agent` (30-90s) + 2. **Clarification**: Interactive Q&A based on exploration findings (user-dependent) + 3. **Planning**: Adaptive planning strategy - direct (Low complexity) or delegate to `@cli-planning-agent` (Medium/High complexity) (20-60s) + 4. **Three-Dimensional Confirmation**: Multi-select interaction for task approval + execution method + code review tool (user-dependent) + 5. **Execution & Tracking**: Live TodoWrite progress updates with selected method (5-120min) +- **Key Features**: + - **Smart Code Exploration**: Auto-detects when codebase context is needed (use `-e` to force) + - **In-Memory Planning**: No file artifacts generated during planning phase + - **Three-Dimensional Multi-Select**: Task approval (Allow/Modify/Cancel) + Execution method (Agent/Provide Plan/CLI) + Code review (No/Claude/Gemini/Qwen/Codex) + - **Parallel Task Execution**: Identifies independent tasks for concurrent execution + - **Flexible Execution**: Choose between Agent (@code-developer) or CLI (Gemini/Qwen/Codex) + - **Optional Post-Review**: Built-in code quality analysis with user-selectable AI tool +- **Agent Calls**: + - `@cli-explore-agent` (conditional, Phase 1) + - `@cli-planning-agent` (conditional, Phase 3 for Medium/High complexity) + - `@code-developer` (conditional, Phase 5 if Agent execution selected) +- **Skill Invocation**: None directly, but agents may invoke skills. +- **Integration**: Standalone workflow for quick tasks. Alternative to `/workflow:plan` + `/workflow:execute` pattern. +- **Example**: + ```bash + # Basic usage with auto-detection + /workflow:lite-plan "Add JWT authentication to user login" + + # Force code exploration + /workflow:lite-plan -e "Refactor logging module for better performance" + + # Preset CLI tool + /workflow:lite-plan --tool codex "Add unit tests for auth service" + ``` + ### **/workflow:execute** - **Syntax**: `/workflow:execute [--resume-session="session-id"]` diff --git a/README.md b/README.md index 143eb266..ec26e2c7 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@
-[![Version](https://img.shields.io/badge/version-v5.5.0-blue.svg)](https://github.com/catlog22/Claude-Code-Workflow/releases) +[![Version](https://img.shields.io/badge/version-v5.8.1-blue.svg)](https://github.com/catlog22/Claude-Code-Workflow/releases) [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE) [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)]() @@ -14,13 +14,20 @@ **Claude Code Workflow (CCW)** transforms AI development from simple prompt chaining into a robust, context-first orchestration system. It solves execution uncertainty and error accumulation through structured planning, deterministic execution, and intelligent multi-model orchestration. -> **🎉 Version 5.5: Interactive Command Guide & Enhanced Documentation** +> **🎉 Version 5.8.1: Lite-Plan Workflow & CLI Tools Enhancement** > > **Core Improvements**: -> - ✨ **Command-Guide Skill** - Interactive help system with CCW-help and CCW-issue triggers -> - ✨ **Enhanced Command Descriptions** - All 69 commands updated with detailed functionality descriptions -> - ✨ **5-Index Command System** - Organized by category, use-case, relationships, and essentials -> - ✨ **Smart Recommendations** - Context-aware next-step suggestions for workflow guidance +> - ✨ **Lite-Plan Workflow** (`/workflow:lite-plan`) - Lightweight interactive planning with intelligent automation +> - **Three-Dimensional Multi-Select Confirmation**: Task approval + Execution method + Code review tool +> - **Smart Code Exploration**: Auto-detects when codebase context is needed (use `-e` flag to force) +> - **Parallel Task Execution**: Identifies independent tasks for concurrent execution +> - **Flexible Execution**: Choose between Agent (@code-developer) or CLI (Gemini/Qwen/Codex) +> - **Optional Post-Review**: Built-in code quality analysis with your choice of AI tool +> - ✨ **CLI Tools Optimization** - Simplified command syntax with auto-model-selection +> - Removed `-m` parameter requirement for Gemini, Qwen, and Codex (auto-selects best model) +> - Clearer command structure and improved documentation +> - 🔄 **Execution Workflow Enhancement** - Streamlined phases with lazy loading strategy +> - 🎨 **CLI Explore Agent** - Improved visibility with yellow color scheme > > See [CHANGELOG.md](CHANGELOG.md) for full details. @@ -108,6 +115,35 @@ The best way to get started is to follow the 5-minute tutorial in the [**Getting Here is a quick example of a common development workflow: +### **Option 1: Lite-Plan Workflow** (⚡ Recommended for Quick Tasks) + +Lightweight interactive workflow with in-memory planning and immediate execution: + +```bash +# Basic usage with auto-detection +/workflow:lite-plan "Add JWT authentication to user login" + +# Force code exploration +/workflow:lite-plan -e "Refactor logging module for better performance" + +# Preset CLI tool +/workflow:lite-plan --tool codex "Add unit tests for auth service" +``` + +**Interactive Flow**: +1. **Phase 1**: Automatic task analysis and smart code exploration (if needed) +2. **Phase 2**: Answer clarification questions (if any) +3. **Phase 3**: Review generated plan with task breakdown +4. **Phase 4**: Three-dimensional confirmation: + - ✅ Confirm/Modify/Cancel task + - 🔧 Choose execution: Agent / Provide Plan / CLI (Gemini/Qwen/Codex) + - 🔍 Optional code review: No / Claude / Gemini / Qwen / Codex +5. **Phase 5**: Watch real-time execution with live task tracking + +### **Option 2: Full Workflow** (Comprehensive Planning) + +Traditional multi-phase workflow for complex projects: + 1. **Create a Plan** (automatically starts a session): ```bash /workflow:plan "Implement JWT-based user login and registration" diff --git a/README_CN.md b/README_CN.md index ba865de9..94f2f61b 100644 --- a/README_CN.md +++ b/README_CN.md @@ -2,7 +2,7 @@
-[![Version](https://img.shields.io/badge/version-v5.5.0-blue.svg)](https://github.com/catlog22/Claude-Code-Workflow/releases) +[![Version](https://img.shields.io/badge/version-v5.8.1-blue.svg)](https://github.com/catlog22/Claude-Code-Workflow/releases) [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE) [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)]() @@ -14,13 +14,20 @@ **Claude Code Workflow (CCW)** 将 AI 开发从简单的提示词链接转变为一个强大的、上下文优先的编排系统。它通过结构化规划、确定性执行和智能多模型编排，解决了执行不确定性和误差累积的问题。 -> **🎉 版本 5.5: 交互式命令指南与增强文档** +> **🎉 版本 5.8.1: Lite-Plan 工作流与 CLI 工具增强** > > **核心改进**: -> - ✨ **命令指南技能** - 交互式帮助系统，支持 CCW-help 和 CCW-issue 触发 -> - ✨ **增强命令描述** - 所有 69 个命令更新了详细功能描述 -> - ✨ **5 索引命令系统** - 按分类、使用场景、关系和核心命令组织 -> - ✨ **智能推荐** - 基于上下文的工作流引导建议 +> - ✨ **Lite-Plan 工作流** (`/workflow:lite-plan`) - 轻量级交互式规划与智能自动化 +> - **三维多选确认**: 任务批准 + 执行方法 + 代码审查工具 +> - **智能代码探索**: 自动检测何时需要代码库上下文（使用 `-e` 标志强制探索） +> - **并行任务执行**: 识别独立任务以实现并发执行 +> - **灵活执行**: 选择智能体（@code-developer）或 CLI（Gemini/Qwen/Codex） +> - **可选后置审查**: 内置代码质量分析，可选择 AI 工具 +> - ✨ **CLI 工具优化** - 简化命令语法，自动模型选择 +> - 移除 Gemini、Qwen 和 Codex 的 `-m` 参数要求（自动选择最佳模型） +> - 更清晰的命令结构和改进的文档 +> - 🔄 **执行工作流增强** - 简化阶段，采用延迟加载策略 +> - 🎨 **CLI Explore Agent** - 改进可见性，采用黄色配色方案 > > 详见 [CHANGELOG.md](CHANGELOG.md)。 @@ -108,6 +115,35 @@ CCW 包含内置的**命令指南技能**，帮助您有效地发现和使用命 以下是一个常见开发工作流的快速示例： +### **选项 1: Lite-Plan 工作流** (⚡ 推荐用于快速任务) + +轻量级交互式工作流，内存中规划并立即执行： + +```bash +# 基本用法，自动检测 +/workflow:lite-plan "为用户登录添加 JWT 认证" + +# 强制代码探索 +/workflow:lite-plan -e "重构日志模块以提高性能" + +# 预设 CLI 工具 +/workflow:lite-plan --tool codex "为认证服务添加单元测试" +``` + +**交互流程**: +1. **阶段 1**: 自动任务分析和智能代码探索（如需要） +2. **阶段 2**: 回答澄清问题（如有） +3. **阶段 3**: 查看生成的计划和任务分解 +4. **阶段 4**: 三维确认: + - ✅ 确认/修改/取消任务 + - 🔧 选择执行方式: 智能体 / 仅提供计划 / CLI（Gemini/Qwen/Codex） + - 🔍 可选代码审查: 否 / Claude / Gemini / Qwen / Codex +5. **阶段 5**: 观察实时执行和任务跟踪 + +### **选项 2: 完整工作流** (综合规划) + +适用于复杂项目的传统多阶段工作流： + 1. **创建计划**（自动启动会话）: ```bash /workflow:plan "实现基于 JWT 的用户登录和注册"