catlog22/Claude-Code-Workflow
1
0
Fork 0
mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-02-05 01:50:27 +08:00
Code Issues Packages Projects Releases Wiki Activity

docs: Release v5.8.1 - Lite-Plan Workflow & CLI Tools Enhancement

Browse Source 
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.
This commit is contained in:
catlog22
2025-11-16 20:50:10 +08:00
parent 8f55bf2ece
commit 965a80b54e
5 changed files with 188 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

65
CHANGELOG.md
View File

@@ -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

1
COMMAND_REFERENCE.md
View File

@@ -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. |

38
COMMAND_SPEC.md
View File

@@ -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"]`

48
README.md
View File

@@ -2,7 +2,7 @@
<div align="center">
[![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"

48
README_CN.md
View File

@@ -2,7 +2,7 @@
<div align="center">
[![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 的用户登录和注册"