catlog22 096621eee7 docs: 强调 SKILL 智能整合原则,避免模板直接复制
核心修改:
1. 新增"Core Principle: Intelligent Integration"部分
   - 明确 SKILL 提供参考材料用于智能整合,而非直接复制模板
   - 定义响应策略:分析上下文 → 提取相关信息 → 合成定制化 → 交付目标响应
   - 列出禁止事项和必须遵守的原则

2. 更新所有 6 个 Mode 的 Process 描述:
   - Mode 1 (Command Search): 强调智能过滤和排序,而非 JSON 数据转储
   - Mode 2 (Smart Recommendations): 分析工作流上下文并评估推荐优先级
   - Mode 3 (Full Documentation): 提取用户相关部分,渐进式披露
   - Mode 4 (Beginner Onboarding): 评估用户背景,设计个性化学习路径
   - Mode 5 (Issue Reporting): 智能引导信息收集,适应模板部分
   - Mode 6 (Deep Command Analysis): 合成聚焦解释,处理并整合 CLI 分析

3. 更新示例说明:
   - 每个 Mode 的示例都强调"NOT: [直接返回模板]"
   - 展示如何根据上下文定制响应

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-06 16:56:34 +08:00

🚀 Claude Code Workflow (CCW)

Version License Platform

Languages: English | 中文


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

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

See CHANGELOG.md for full details.

📚 New to CCW? Check out the Getting Started Guide for a beginner-friendly 5-minute tutorial!


Core Concepts

CCW is built on a set of core principles that differentiate it from traditional AI development approaches:

  • Context-First Architecture: Pre-defined context gathering eliminates execution uncertainty by ensuring agents have the correct information before implementation.
  • JSON-First State Management: Task states live in .task/IMPL-*.json files as the single source of truth, enabling programmatic orchestration without state drift.
  • Autonomous Multi-Phase Orchestration: Commands chain specialized sub-commands and agents to automate complex workflows with zero user intervention.
  • Multi-Model Strategy: Leverages the unique strengths of different AI models (Gemini for analysis, Codex for implementation) for superior results.
  • Hierarchical Memory System: A 4-layer documentation system provides context at the appropriate level of abstraction, preventing information overload.
  • Specialized Role-Based Agents: A suite of agents (@code-developer, @test-fix-agent, etc.) mirrors a real software team to handle diverse tasks.

⚙️ Installation

For detailed installation instructions, please refer to the INSTALL.md guide.

🚀 Quick One-Line Installation

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)

Verify Installation

After installation, open Claude Code and check if the workflow commands are available by running:

/workflow:session:list

If the slash commands (e.g., /workflow:*) are recognized, the installation was successful.


🛠️ Command Reference

CCW provides a rich set of commands for managing workflows, tasks, and interacting with AI tools. For a complete list and detailed descriptions of all available commands, please see the COMMAND_REFERENCE.md file.

For a detailed technical specification of every command, see the COMMAND_SPEC.md.


💡 Need Help? Use the Interactive Command Guide

CCW includes a built-in command-guide skill to help you discover and use commands effectively:

  • CCW-help - Get interactive help and command recommendations
  • CCW-issue - Report bugs or request features with guided templates

The command guide provides:

  • 🔍 Smart Command Search - Find commands by keyword, category, or use-case
  • 🤖 Next-Step Recommendations - Get suggestions for what to do after any command
  • 📖 Detailed Documentation - View parameters, examples, and best practices
  • 🎓 Beginner Onboarding - Learn the top 14 essential commands with a guided learning path
  • 📝 Issue Reporting - Generate standardized bug reports and feature requests

Example Usage:

User: "CCW-help"
→ Interactive menu with command search, recommendations, and documentation

User: "What's next after /workflow:plan?"
→ Recommends /workflow:execute, /workflow:action-plan-verify, with workflow patterns

User: "CCW-issue"
→ Guided template generation for bugs, features, or questions

🚀 Getting Started

The best way to get started is to follow the 5-minute tutorial in the Getting Started Guide.

Here is a quick example of a common development workflow:

  1. Create a Plan (automatically starts a session):
    /workflow:plan "Implement JWT-based user login and registration"
    
  2. Execute the Plan:
    /workflow:execute
    
  3. Check Status (optional):
    /workflow:status
    

🤝 Contributing & Support

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

Description
JSON-driven multi-agent development framework with intelligent CLI orchestration (Gemini/Qwen/Codex), context-first architecture, and automated workflow execution
Readme MIT 33 MiB
Languages
TypeScript 38.2%
Python 24.2%
HTML 16.3%
JavaScript 15.2%
CSS 4.5%
Other 1.6%