diff --git a/COMMAND_REFERENCE.md b/COMMAND_REFERENCE.md index 1c87fb09..c7388772 100644 --- a/COMMAND_REFERENCE.md +++ b/COMMAND_REFERENCE.md @@ -2,6 +2,8 @@ This document provides a comprehensive reference for all commands available in the Claude Code Workflow (CCW) system. +> **Version 5.0 Update**: Streamlined command structure focusing on essential tools. Removed MCP code-index dependency for better stability and performance. + ## Unified CLI Commands (`/cli:*`) These commands provide direct access to AI tools for quick analysis and interaction without initiating a full workflow. @@ -47,7 +49,7 @@ These commands orchestrate complex, multi-phase development processes, from plan |---|---| | `/workflow:brainstorm:artifacts` | Generate role-specific guidance-specification.md dynamically based on selected roles. | | `/workflow:brainstorm:auto-parallel` | Parallel brainstorming automation with dynamic role selection and concurrent execution. | -| `/workflow:brainstorm:synthesis` | Generate synthesis-specification.md from guidance-specification and role analyses with @ references using conceptual-planning-agent. | +| `/workflow:brainstorm:synthesis` | Clarify and refine role analyses through intelligent Q&A and targeted updates. | | `/workflow:brainstorm:api-designer` | Generate or update api-designer/analysis.md addressing guidance-specification discussion points. | | `/workflow:brainstorm:data-architect` | Generate or update data-architect/analysis.md addressing guidance-specification discussion points. | | `/workflow:brainstorm:product-manager` | Generate or update product-manager/analysis.md addressing guidance-specification discussion points. | @@ -62,7 +64,6 @@ These commands orchestrate complex, multi-phase development processes, from plan | Command | Description | |---|---| -| `/workflow:concept-clarify` | Identify underspecified areas in brainstorming artifacts through targeted clarification questions before action planning. | | `/workflow:action-plan-verify`| Perform non-destructive cross-artifact consistency and quality analysis of IMPL_PLAN.md and task.json before execution. | ### Test-Driven Development (TDD) @@ -76,9 +77,9 @@ These commands orchestrate complex, multi-phase development processes, from plan | Command | Description | |---|---| -| `/workflow:test-gen` | Create independent test-fix workflow session by analyzing completed implementation. | -| `/workflow:test-fix-gen` | Create independent test-fix workflow session from existing implementation (session or prompt-based). | -| `/workflow:test-cycle-execute` | Execute test-fix workflow with dynamic task generation and iterative fix cycles. | +| `/workflow:test-gen` | Generate test plan and tasks by analyzing completed implementation. Use `/workflow:execute` to run generated tasks. | +| `/workflow:test-fix-gen` | Generate test-fix plan and tasks from existing implementation or prompt. Use `/workflow:execute` to run generated tasks. | +| `/workflow:test-cycle-execute` | Execute test-fix workflow with dynamic task generation and iterative fix cycles. Tasks are executed by `/workflow:execute`. | ### UI Design Workflow diff --git a/COMMAND_SPEC.md b/COMMAND_SPEC.md index bfb3e1b9..b17902bd 100644 --- a/COMMAND_SPEC.md +++ b/COMMAND_SPEC.md @@ -1,13 +1,15 @@ # Claude Code Workflow (CCW) - Command Specification -**Version**: 4.6.0 -**Generated**: 2025年10月18日星期六 +**Version**: 5.0.0 +**Updated**: 2025年10月24日星期六 ## 1. Introduction This document provides a detailed technical specification for every command available in the Claude Code Workflow (CCW) system. It is intended for advanced users and developers who wish to understand the inner workings of CCW, customize commands, or build new workflows. +> **Version 5.0 Changes**: Removed MCP code-index dependency, streamlined TDD workflow with conflict resolution, and refocused brainstorming on role analysis instead of synthesis documents. + For a user-friendly overview, please see [COMMAND_REFERENCE.md](COMMAND_REFERENCE.md). ## 2. Command Categories @@ -308,7 +310,7 @@ Commands for managing individual tasks within a workflow session. - **Agent-Driven Execution**: Fully delegates to general-purpose agent which autonomously: 1. Analyzes project structure and documentation 2. Extracts keywords from task description - 3. Discovers relevant files using MCP code-index or search tools + 3. Discovers relevant files using ripgrep/find search tools 4. Executes Gemini/Qwen CLI for deep analysis 5. Generates structured JSON content package - **Core Philosophy**: Read-only analysis, token-efficient (CLI analysis in agent), structured output @@ -384,8 +386,8 @@ Specialized workflow for UI/UX design, from style extraction to prototype genera ### **/workflow:ui-design:capture** - **Syntax**: `/workflow:ui-design:capture --url-map "target:url,..." ...` -- **Responsibilities**: Batch screenshot capture tool with MCP-first strategy and local fallbacks. -- **Agent Calls**: None directly, uses MCP tools. +- **Responsibilities**: Batch screenshot capture tool using MCP Chrome DevTools with multi-tier fallback strategy (MCP → Playwright → Chrome → Manual). +- **Agent Calls**: None directly, uses MCP Chrome DevTools or browser automation as fallback. - **Example**: ```bash /workflow:ui-design:capture --url-map "home:https://linear.app" @@ -394,7 +396,7 @@ Specialized workflow for UI/UX design, from style extraction to prototype genera ### **/workflow:ui-design:explore-layers** - **Syntax**: `/workflow:ui-design:explore-layers --url --depth <1-5> ...` - **Responsibilities**: Performs a deep, interactive UI capture of a single URL, exploring layers from the full page down to the Shadow DOM. -- **Agent Calls**: None directly, uses MCP tools. +- **Agent Calls**: None directly, uses MCP Chrome DevTools for layer exploration. - **Example**: ```bash /workflow:ui-design:explore-layers --url https://linear.app --depth 3 @@ -489,8 +491,9 @@ Workflows for Test-Driven Development (TDD) and post-implementation test generat ### **/workflow:test-cycle-execute** - **Syntax**: `/workflow:test-cycle-execute [--resume-session="session-id"] [--max-iterations=N]` -- **Responsibilities**: Executes a dynamic test-fix workflow, creating intermediate fix tasks based on test results and analysis. -- **Agent Calls**: `@code-developer`, `@test-fix-agent`. +- **Responsibilities**: Executes a test-fix workflow by delegating to `/workflow:execute`. Generates test tasks dynamically and creates intermediate fix tasks based on test results. +- **Agent Calls**: Delegates to `/workflow:execute` which invokes `@test-fix-agent` for task execution. +- **Note**: This command generates tasks; actual execution is performed by `/workflow:execute`. - **Example**: ```bash /workflow:test-cycle-execute --resume-session="WFS-test-user-auth" diff --git a/GETTING_STARTED.md b/GETTING_STARTED.md index 4ce2e774..d7de18f9 100644 --- a/GETTING_STARTED.md +++ b/GETTING_STARTED.md @@ -1,10 +1,12 @@ # 🚀 Claude Code Workflow (CCW) - Getting Started Guide -Welcome to Claude Code Workflow (CCW) v4.6.2! This guide will help you get up and running in 5 minutes and experience AI-driven automated software development with our latest workflow system optimizations. +Welcome to Claude Code Workflow (CCW) v5.0! This guide will help you get up and running in 5 minutes and experience AI-driven automated software development with our streamlined, dependency-free workflow system. **Project Repository**: [catlog22/Claude-Code-Workflow](https://github.com/catlog22/Claude-Code-Workflow) +> **🎉 What's New in v5.0**: Less is more! We've removed external MCP dependencies and simplified workflows. CCW now uses standard tools (ripgrep/find) for better stability and performance. The brainstorming workflow focuses on role analysis for clearer planning. + --- ## ⏱️ 5-Minute Quick Start @@ -138,33 +140,7 @@ For complex features requiring thorough analysis, use the complete workflow: **b - Architectural decisions with significant impact - When you need thorough requirements before implementation -### Scenario 4: Quality Assurance - Concept Clarification - -Before generating tasks, ensure your requirements are clear and unambiguous: - -```bash -# After brainstorming synthesis or planning analysis, verify conceptual clarity -/workflow:concept-clarify - -# The command will: -# 1. Analyze artifacts for ambiguities and missing details -# 2. Ask up to 5 targeted questions to resolve critical gaps -# 3. Update synthesis-specification.md or ANALYSIS_RESULTS.md with clarifications -# 4. Recommend whether to proceed or address outstanding issues -``` - -**When to Use**: -- After `/workflow:brainstorm:synthesis` (before `/workflow:plan`) -- After Phase 3 of `/workflow:plan` (before task generation) -- When you want to reduce planning errors and rework - -**Benefits**: -- Detects underspecified requirements early -- Prevents downstream implementation errors -- Ensures team alignment on critical decisions -- Reduces costly rework during execution - -### Scenario 5: Quality Assurance - Action Plan Verification +### Scenario 4: Quality Assurance - Action Plan Verification After planning, validate your implementation plan for consistency and completeness: @@ -302,12 +278,12 @@ Suitable for large-scale refactoring, architectural changes, or first-time CCW u ```bash # Rebuild entire project documentation index -/update-memory-full +/memory:update-full # Use specific tool for indexing -/update-memory-full --tool gemini # Comprehensive analysis (recommended) -/update-memory-full --tool qwen # Architecture focus -/update-memory-full --tool codex # Implementation details +/memory:update-full --tool gemini # Comprehensive analysis (recommended) +/memory:update-full --tool qwen # Architecture focus +/memory:update-full --tool codex # Implementation details ``` **When to Execute**: @@ -347,10 +323,10 @@ Suitable for daily development, updating only modules affected by changes: ```bash # Update recently modified related documentation -/update-memory-related +/memory:update-related # Specify tool for update -/update-memory-related --tool gemini +/memory:update-related --tool gemini ``` **When to Execute**: diff --git a/GETTING_STARTED_CN.md b/GETTING_STARTED_CN.md index 63166d8e..d77f7ca5 100644 --- a/GETTING_STARTED_CN.md +++ b/GETTING_STARTED_CN.md @@ -1,10 +1,12 @@ # 🚀 Claude Code Workflow (CCW) - 快速上手指南 -欢迎来到 Claude Code Workflow (CCW) v4.6.2!本指南将帮助您在 5 分钟内快速入门,体验由 AI 驱动的自动化软件开发流程,以及我们最新的工作流系统优化。 +欢迎来到 Claude Code Workflow (CCW) v5.0!本指南将帮助您在 5 分钟内快速入门,体验由 AI 驱动的自动化软件开发流程,以及我们全新的精简化、零外部依赖的工作流系统。 **项目地址**:[catlog22/Claude-Code-Workflow](https://github.com/catlog22/Claude-Code-Workflow) +> **🎉 v5.0 新特性:少即是多**!我们移除了外部 MCP 依赖,简化了工作流程。CCW 现在使用标准工具(ripgrep/find)以获得更好的稳定性和性能。头脑风暴工作流专注于角色分析,使规划更加清晰。 + --- ## ⏱️ 5 分钟快速入门 @@ -138,33 +140,7 @@ - 具有重大影响的架构决策 - 实现前需要详尽需求分析 -### 场景 4:质量保证 - 概念澄清 - -在生成任务之前,确保您的需求清晰且无歧义: - -```bash -# 在头脑风暴综合或规划分析后,验证概念清晰度 -/workflow:concept-clarify - -# 该命令将: -# 1. 分析工件中的歧义和缺失细节 -# 2. 提出最多 5 个针对性问题以解决关键差距 -# 3. 使用澄清更新 synthesis-specification.md 或 ANALYSIS_RESULTS.md -# 4. 建议是继续进行还是解决未完成的问题 -``` - -**使用时机**: -- 在 `/workflow:brainstorm:synthesis` 之后(在 `/workflow:plan` 之前) -- 在 `/workflow:plan` 的第 3 阶段之后(在任务生成之前) -- 当您想减少规划错误和返工时 - -**优势**: -- 及早检测未明确的需求 -- 防止下游实现错误 -- 确保团队在关键决策上保持一致 -- 减少执行期间的昂贵返工 - -### 场景 5:质量保证 - 行动计划验证 +### 场景 4:质量保证 - 行动计划验证 规划后,验证您的实现计划的一致性和完整性: @@ -302,12 +278,12 @@ CCW 使用分层的 CLAUDE.md 文档系统维护项目上下文。定期更新 ```bash # 重建整个项目的文档索引 -/update-memory-full +/memory:update-full # 使用特定工具进行索引 -/update-memory-full --tool gemini # 全面分析(推荐) -/update-memory-full --tool qwen # 架构重点 -/update-memory-full --tool codex # 实现细节 +/memory:update-full --tool gemini # 全面分析(推荐) +/memory:update-full --tool qwen # 架构重点 +/memory:update-full --tool codex # 实现细节 ``` **执行时机**: @@ -347,10 +323,10 @@ CCW 使用分层的 CLAUDE.md 文档系统维护项目上下文。定期更新 ```bash # 更新最近修改相关的文档 -/update-memory-related +/memory:update-related # 指定工具进行更新 -/update-memory-related --tool gemini +/memory:update-related --tool gemini ``` **执行时机**: diff --git a/INSTALL_CN.md b/INSTALL_CN.md index 9cbcaf0c..33f3699c 100644 --- a/INSTALL_CN.md +++ b/INSTALL_CN.md @@ -4,6 +4,8 @@ Claude Code Agent 工作流协调和分布式内存系统的交互式安装指南。 +> **版本 5.0:精简化安装** - 移除了外部 MCP 依赖,安装更简单、更稳定。使用标准工具(ripgrep/find)提供更好的性能和兼容性。 + ## ⚡ 一键远程安装(推荐) ### 所有平台 - 远程 PowerShell 安装 diff --git a/README_CN.md b/README_CN.md index 7d5ddd00..6c10ace5 100644 --- a/README_CN.md +++ b/README_CN.md @@ -2,10 +2,9 @@
-[![Version](https://img.shields.io/badge/version-v4.6.2-blue.svg)](https://github.com/catlog22/Claude-Code-Workflow/releases) +[![Version](https://img.shields.io/badge/version-v5.0.0-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)]() -[![MCP Tools](https://img.shields.io/badge/🔧_MCP_Tools-Experimental-orange.svg)](https://github.com/modelcontextprotocol) **语言:** [English](README.md) | [中文](README_CN.md) @@ -15,7 +14,14 @@ **Claude Code Workflow (CCW)** 将 AI 开发从简单的提示词链接转变为一个强大的、上下文优先的编排系统。它通过结构化规划、确定性执行和智能多模型编排,解决了执行不确定性和误差累积的问题。 -> **🎉 最新版本: v4.6.2** - 文档优化与 `/memory:load` 命令改进。详见 [CHANGELOG.md](CHANGELOG.md)。 +> **🎉 版本 5.0: 少即是多** +> +> **核心改进**: +> - ✅ **移除外部依赖** - 使用标准 ripgrep/find 替代 MCP code-index,提升稳定性 +> - ✅ **简化工作流** - 优化 TDD 流程,引入冲突解决机制 +> - ✅ **专注角色分析** - 以角色文档为核心,简化规划架构 +> +> 详见 [CHANGELOG.md](CHANGELOG.md)。 > 📚 **第一次使用 CCW?** 查看 [**快速上手指南**](GETTING_STARTED_CN.md) 获取新手友好的 5 分钟教程!