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

docs: Update README with accurate v1.0 features and reorganize Gemini commands

Browse Source 
Major Changes:
- Update README.md and README_CN.md to reflect v1.0 release instead of v2.0
- Add Gemini CLI integration highlights: dynamic template discovery, auto-selection
- Correct command references from /gemini:pre:* to /gemini:mode:*
- Add Smart Template Auto-Selection usage examples
- Reorganize Gemini commands from /pre/ to /mode/ directory structure

Documentation Improvements:
- Replace v2.0 architecture claims with actual v1.0 achievements
- Highlight 500+ lines of documentation streamlining
- Add practical examples for new auto-selection template system
- Maintain consistency between English and Chinese versions

Command Structure Updates:
- Move auto.md, bug-index.md, plan.md from /pre/ to /mode/ directory
- Update gemini-unified.md path references
- Ensure all command references are accurate and functional

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
catlog22
2025-09-09 23:12:06 +08:00
parent 47493a4db5
commit cda42d6356
6 changed files with 65 additions and 50 deletions
Download Patch File Download Diff File Expand all files Collapse all files

26
.claude/commands/gemini/pre/auto.md → .claude/commands/gemini/mode/auto.md
View File

@@ -1,18 +1,18 @@
--- ---
name: auto name: auto
description: Auto-select and execute appropriate template based on user input analysis description: Auto-select and execute appropriate template based on user input analysis
usage: /gemini:pre:auto "description of task or problem" usage: /gemini:mode:auto "description of task or problem"
argument-hint: "description of what you want to analyze or plan" argument-hint: "description of what you want to analyze or plan"
examples: examples:
- /gemini:pre:auto "authentication system keeps crashing during login" - /gemini:mode:auto "authentication system keeps crashing during login"
- /gemini:pre:auto "design a real-time notification architecture" - /gemini:mode:auto "design a real-time notification architecture"
- /gemini:pre:auto "database connection errors in production" - /gemini:mode:auto "database connection errors in production"
- /gemini:pre:auto "plan user dashboard with analytics features" - /gemini:mode:auto "plan user dashboard with analytics features"
allowed-tools: Bash(ls:*), Bash(gemini:*) allowed-tools: Bash(ls:*), Bash(gemini:*)
model: sonnet model: sonnet
--- ---
# Auto Template Selection (/gemini:pre:auto) # Auto Template Selection (/gemini:mode:auto)
## Overview ## Overview
Automatically analyzes user input to select the most appropriate template and execute Gemini CLI with optimal context. Automatically analyzes user input to select the most appropriate template and execute Gemini CLI with optimal context.
@@ -24,16 +24,16 @@ Automatically analyzes user input to select the most appropriate template and ex
### Auto-Detection Examples ### Auto-Detection Examples
```bash ```bash
# Bug-related keywords → selects bug-fix.md # Bug-related keywords → selects bug-fix.md
/gemini:pre:auto "React component not rendering after state update" /gemini:mode:auto "React component not rendering after state update"
# Planning keywords → selects plan.md # Planning keywords → selects plan.md
/gemini:pre:auto "design microservices architecture for user management" /gemini:mode:auto "design microservices architecture for user management"
# Error/crash keywords → selects bug-fix.md # Error/crash keywords → selects bug-fix.md
/gemini:pre:auto "API timeout errors in production environment" /gemini:mode:auto "API timeout errors in production environment"
# Architecture/design keywords → selects plan.md # Architecture/design keywords → selects plan.md
/gemini:pre:auto "implement real-time chat system architecture" /gemini:mode:auto "implement real-time chat system architecture"
``` ```
## Template Selection Logic ## Template Selection Logic
@@ -140,14 +140,14 @@ User Input: [user_input]"
### Manual Template Override ### Manual Template Override
```bash ```bash
# Force specific template # Force specific template
/gemini:pre:auto "user authentication" --template bug-fix.md /gemini:mode:auto "user authentication" --template bug-fix.md
/gemini:pre:auto "fix login issues" --template plan.md /gemini:mode:auto "fix login issues" --template plan.md
``` ```
### Dynamic Template Listing ### Dynamic Template Listing
```bash ```bash
# List all dynamically discovered templates # List all dynamically discovered templates
/gemini:pre:auto --list-templates /gemini:mode:auto --list-templates
# Output: # Output:
# Dynamically discovered templates in ~/.claude/prompt-templates/: # Dynamically discovered templates in ~/.claude/prompt-templates/:
# - bug-fix.md (用于定位bug并提供修改建议) [Keywords: 规划, bug, 修改方案] # - bug-fix.md (用于定位bug并提供修改建议) [Keywords: 规划, bug, 修改方案]

16
.claude/commands/gemini/pre/bug-index.md → .claude/commands/gemini/mode/bug-index.md
View File

@@ -1,17 +1,17 @@
--- ---
name: bug-index name: bug-index
description: Bug analysis and fix suggestions using specialized template description: Bug analysis and fix suggestions using specialized template
usage: /gemini:pre:bug-index "bug description" usage: /gemini:mode:bug-index "bug description"
argument-hint: "description of the bug or error you're experiencing" argument-hint: "description of the bug or error you're experiencing"
examples: examples:
- /gemini:pre:bug-index "authentication null pointer error in login flow" - /gemini:mode:bug-index "authentication null pointer error in login flow"
- /gemini:pre:bug-index "React component not re-rendering after state change" - /gemini:mode:bug-index "React component not re-rendering after state change"
- /gemini:pre:bug-index "database connection timeout in production" - /gemini:mode:bug-index "database connection timeout in production"
allowed-tools: Bash(gemini:*) allowed-tools: Bash(gemini:*)
model: sonnet model: sonnet
--- ---
# Bug Analysis Command (/gemini:pre:bug-index) # Bug Analysis Command (/gemini:mode:bug-index)
## Overview ## Overview
Systematic bug analysis and fix suggestions using expert diagnostic template. Systematic bug analysis and fix suggestions using expert diagnostic template.
@@ -20,17 +20,17 @@ Systematic bug analysis and fix suggestions using expert diagnostic template.
### Basic Bug Analysis ### Basic Bug Analysis
```bash ```bash
/gemini:pre:bug-index "authentication error during login" /gemini:mode:bug-index "authentication error during login"
``` ```
### With All Files Context ### With All Files Context
```bash ```bash
/gemini:pre:bug-index "React state not updating" --all-files /gemini:mode:bug-index "React state not updating" --all-files
``` ```
### Save to Workflow Session ### Save to Workflow Session
```bash ```bash
/gemini:pre:bug-index "API timeout issues" --save-session /gemini:mode:bug-index "API timeout issues" --save-session
``` ```
## Command Execution ## Command Execution

16
.claude/commands/gemini/pre/plan.md → .claude/commands/gemini/mode/plan.md
View File

@@ -1,17 +1,17 @@
--- ---
name: plan name: plan
description: Project planning and architecture analysis using specialized template description: Project planning and architecture analysis using specialized template
usage: /gemini:pre:plan "planning topic" usage: /gemini:mode:plan "planning topic"
argument-hint: "planning topic or architectural challenge to analyze" argument-hint: "planning topic or architectural challenge to analyze"
examples: examples:
- /gemini:pre:plan "design user dashboard feature architecture" - /gemini:mode:plan "design user dashboard feature architecture"
- /gemini:pre:plan "plan microservices migration strategy" - /gemini:mode:plan "plan microservices migration strategy"
- /gemini:pre:plan "implement real-time notification system" - /gemini:mode:plan "implement real-time notification system"
allowed-tools: Bash(gemini:*) allowed-tools: Bash(gemini:*)
model: sonnet model: sonnet
--- ---
# Planning Analysis Command (/gemini:pre:plan) # Planning Analysis Command (/gemini:mode:plan)
## Overview ## Overview
Comprehensive project planning and architecture analysis using expert planning template. Comprehensive project planning and architecture analysis using expert planning template.
@@ -20,17 +20,17 @@ Comprehensive project planning and architecture analysis using expert planning t
### Basic Planning Analysis ### Basic Planning Analysis
```bash ```bash
/gemini:pre:plan "design authentication system" /gemini:mode:plan "design authentication system"
``` ```
### With All Files Context ### With All Files Context
```bash ```bash
/gemini:pre:plan "microservices migration" --all-files /gemini:mode:plan "microservices migration" --all-files
``` ```
### Save to Workflow Session ### Save to Workflow Session
```bash ```bash
/gemini:pre:plan "real-time notifications" --save-session /gemini:mode:plan "real-time notifications" --save-session
``` ```
## Command Execution ## Command Execution

2
.claude/workflows/gemini-unified.md
View File

@@ -113,7 +113,7 @@ FUNCTION analyze_and_run_gemini(analysis_type):
// Step 3: Construct and execute the gemini command. // Step 3: Construct and execute the gemini command.
// Always include project standards from CLAUDE.md. // Always include project standards from CLAUDE.md.
// Uses a pre-defined analysis template for consistency. // Uses a mode-defined analysis template for consistency.
command = "gemini -p \"" + patterns + " @{CLAUDE.md} $(cat ~/.claude/workflows/gemini-templates/prompts/analysis/pattern.txt)\"" command = "gemini -p \"" + patterns + " @{CLAUDE.md} $(cat ~/.claude/workflows/gemini-templates/prompts/analysis/pattern.txt)\""
execute_shell(command) execute_shell(command)

45
README.md
View File

@@ -8,7 +8,7 @@
A sophisticated multi-agent automation workflow framework that transforms complex software development tasks from conceptualization to implementation review into manageable, trackable, AI-orchestrated processes. A sophisticated multi-agent automation workflow framework that transforms complex software development tasks from conceptualization to implementation review into manageable, trackable, AI-orchestrated processes.
> **🎉 Major Architecture Upgrade (v2.0)**: Recently underwent comprehensive refactoring with **JSON-only data model**, **marker file session management**, and **unified complexity standards**. See [WORKFLOW_SYSTEM_UPGRADE.md](WORKFLOW_SYSTEM_UPGRADE.md) for details. > **🎉 v1.0 Release**: Complete Gemini CLI integration with template system, dynamic template discovery, streamlined documentation, and intelligent auto-selection capabilities. See [CHANGELOG.md](CHANGELOG.md) for details.
## 🏗️ Architecture Overview ## 🏗️ Architecture Overview
@@ -39,7 +39,13 @@ CCW intelligently adapts its file structure and workflow processes based on unif
- **Action Planning Agent**: Converts high-level concepts into executable implementation plans - **Action Planning Agent**: Converts high-level concepts into executable implementation plans
- **Code Developer**: Implements code based on plans - **Code Developer**: Implements code based on plans
- **Code Review Agent**: Reviews code quality and compliance - **Code Review Agent**: Reviews code quality and compliance
- **Memory Gemini Bridge**: Intelligent CLAUDE.md documentation system with 4-layer hierarchy, context-aware updates, and automatic scaling based on project complexity - **Memory Gemini Bridge**: Intelligent CLAUDE.md documentation system with context-aware updates
### Gemini CLI Integration (v1.0)
- **Dynamic Template Discovery**: Automatically detects and loads templates from `~/.claude/prompt-templates/`
- **Intelligent Auto-Selection**: Matches user input against template keywords and descriptions
- **Template System**: Bug-fix, planning, and custom analysis templates
- **Streamlined Commands**: Consolidated documentation with 500+ lines reduced
### Workflow Session Management ### Workflow Session Management
- Create, pause, resume, list, and switch workflow sessions - Create, pause, resume, list, and switch workflow sessions
@@ -124,7 +130,8 @@ For Gemini CLI integration, configure your `settings.json` file:
| `/gemini:chat:plan` | `/gemini:chat:plan <planning-topic> [--all-files] [--save-session]` | Project planning using specialized architecture template | | `/gemini:chat:plan` | `/gemini:chat:plan <planning-topic> [--all-files] [--save-session]` | Project planning using specialized architecture template |
| `/gemini-execute` | `/gemini-execute <task-id\|description> [--yolo] [--debug]` | Intelligent executor with automatic file context inference | | `/gemini-execute` | `/gemini-execute <task-id\|description> [--yolo] [--debug]` | Intelligent executor with automatic file context inference |
| `/gemini-mode` | `/gemini-mode <analysis-type> <target> [options]` | Template-driven codebase analysis (pattern, architecture, security) | | `/gemini-mode` | `/gemini-mode <analysis-type> <target> [options]` | Template-driven codebase analysis (pattern, architecture, security) |
| `/update-memory` | `/update-memory [related\|full]` | Intelligent CLAUDE.md documentation system with context-aware updates and strict hierarchy preservation | | `/gemini:mode:auto` | `/gemini:mode:auto "<description>"` | 🆕 Auto-select and execute appropriate template based on user input analysis |
| `/update-memory` | `/update-memory [related\|full]` | Intelligent CLAUDE.md documentation system with context-aware updates |
### Workflow Management ### Workflow Management
@@ -193,19 +200,21 @@ For Gemini CLI integration, configure your `settings.json` file:
/workflow:review /workflow:review
``` ```
### Advanced Code Analysis ### Smart Template Auto-Selection (v1.0)
```bash ```bash
# 1. Security audit # 1. Automatic template selection based on keywords
/gemini-mode security "Scan authentication modules for vulnerabilities" /gemini:mode:auto "React component not rendering after state update"
# → Auto-selects bug-fix template
# 2. Architecture analysis # 2. Planning template for architecture work
/gemini-mode architecture "Analyze component dependencies and data flow" /gemini:mode:auto "design microservices architecture for user management"
# → Auto-selects planning template
# 3. Performance optimization # 3. Manual template override when needed
/gemini-mode performance "Identify bottlenecks in React rendering" /gemini:mode:auto "authentication issues" --template plan.md
# 4. Pattern recognition # 4. List available templates
/gemini-mode pattern "Extract reusable component patterns" /gemini:mode:auto --list-templates
``` ```
### Intelligent Documentation Management ### Intelligent Documentation Management
@@ -232,12 +241,12 @@ git commit -m "Major refactoring"
| **Medium** | 5-15 tasks | 2 levels (impl-N.M) | Enhanced + auto-generated TODO_LIST.md | Optional brainstorming → Action plan → Progress tracking | | **Medium** | 5-15 tasks | 2 levels (impl-N.M) | Enhanced + auto-generated TODO_LIST.md | Optional brainstorming → Action plan → Progress tracking |
| **Complex** | >15 tasks | 3 levels (impl-N.M.P) | Complete document suite | Required brainstorming → Multi-agent orchestration → Deep context analysis | | **Complex** | >15 tasks | 3 levels (impl-N.M.P) | Complete document suite | Required brainstorming → Multi-agent orchestration → Deep context analysis |
### 🚀 Architecture v2.0 Benefits ### 🚀 v1.0 Release Benefits
- **Performance**: 95% faster session operations with marker file system - **Smart Automation**: Intelligent template selection reduces manual template discovery
- **Consistency**: 100% data consistency with JSON-only model - **Documentation**: 500+ lines streamlined while maintaining functionality
- **Efficiency**: 40-50% reduction in maintenance overhead - **Template System**: Dynamic discovery and YAML-based metadata parsing
- **Scalability**: Support for hundreds of concurrent sessions - **Cross-Platform**: Unified path handling for Windows/Linux compatibility
- **Onboarding**: 50% faster learning curve with progressive complexity - **Developer Experience**: Simplified commands with powerful auto-selection
## 🔧 Technical Highlights ## 🔧 Technical Highlights

10
README_CN.md
View File

@@ -8,7 +8,7 @@
一个精密的多智能体自动化工作流框架，将复杂的软件开发任务从概念构思到实现审查转化为可管理、可追踪、AI协调的流程。 一个精密的多智能体自动化工作流框架，将复杂的软件开发任务从概念构思到实现审查转化为可管理、可追踪、AI协调的流程。
> **🎉 重大架构升级 (v2.0)**：最近进行了全面重构，采用 **JSON纯数据模型**、**标记文件会话管理** 和 **统一复杂度标准**。详见 [WORKFLOW_SYSTEM_UPGRADE.md](WORKFLOW_SYSTEM_UPGRADE.md)。 > **🎉 v1.0 版本发布**：完整的 Gemini CLI 集成，包含模板系统、动态模板发现、精简文档和智能自动选择功能。详见 [CHANGELOG.md](CHANGELOG.md)。
## 🏗️ 架构概览 ## 🏗️ 架构概览
@@ -39,7 +39,13 @@ CCW 根据统一的任务数量阈值智能调整其文件结构和工作流程
- **行动规划智能体**：将高层概念转化为可执行的实施计划 - **行动规划智能体**：将高层概念转化为可执行的实施计划
- **代码开发智能体**：基于计划实现代码 - **代码开发智能体**：基于计划实现代码
- **代码审查智能体**：审查代码质量和合规性 - **代码审查智能体**：审查代码质量和合规性
- **记忆桥接智能体**：同步 Claude 和 Gemini 记忆，维护 CLAUDE.md 文件 - **记忆桥接智能体**：智能 CLAUDE.md 文档系统，提供上下文感知更新
### Gemini CLI 集成 (v1.0)
- **动态模板发现**：自动检测和加载来自 `~/.claude/prompt-templates/` 的模板
- **智能自动选择**：根据模板关键词和描述匹配用户输入
- **模板系统**：Bug修复、规划和自定义分析模板
- **精简命令**：整合文档，减少500+行代码
### 工作流会话管理 ### 工作流会话管理
- 创建、暂停、恢复、列出和切换工作流会话 - 创建、暂停、恢复、列出和切换工作流会话