mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-12 02:37:45 +08:00
Initial release: Claude Code Workflow (CCW) v2.0
🚀 Revolutionary AI-powered development workflow orchestration system ## 🔥 Core Innovations - **Document-State Separation**: Markdown for planning, JSON for execution state - **Progressive Complexity Management**: Level 0-2 adaptive workflow depth - **5-Agent Orchestration**: Specialized AI agents with context preservation - **Session-First Architecture**: Auto-discovery and state inheritance ## 🏗️ Key Features - Intelligent workflow orchestration (Simple/Medium/Complex patterns) - Real-time document-state synchronization with conflict resolution - Hierarchical task management with 3-level JSON structure - Gemini CLI integration with 12+ specialized templates - Comprehensive file output generation for all workflow commands ## 📦 Installation Remote one-liner installation: ``` iex (iwr -useb https://raw.githubusercontent.com/catlog22/Claude-CCW/main/install-remote.ps1) ``` ## 🎯 System Architecture 4-layer intelligent development architecture: 1. Command Layer - Smart routing and version management 2. Agent Layer - 5 specialized development agents 3. Workflow Layer - Gemini templates and task orchestration 4. Memory Layer - Distributed documentation and auto-sync 🤖 Generated with Claude Code Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
catlog22
245
INSTALL_CN.md
Normal file
245
INSTALL_CN.md
Normal file
@@ -0,0 +1,245 @@
|
||||
# Claude Code Workflow (CCW) - 安装指南
|
||||
|
||||
[English](INSTALL.md) | **中文**
|
||||
|
||||
Claude Code Agent 工作流协调和分布式内存系统的交互式安装指南。
|
||||
|
||||
## ⚡ 一键远程安装（推荐）
|
||||
|
||||
### 所有平台 - 远程 PowerShell 安装
|
||||
```powershell
|
||||
# 从功能分支进行交互式远程安装（最新版本）
|
||||
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1)
|
||||
|
||||
# 包含统一文件输出系统的全局安装
|
||||
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1) -Global
|
||||
|
||||
# 强制覆盖（非交互式）- 包含所有新的工作流文件生成功能
|
||||
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1) -Force -NonInteractive
|
||||
|
||||
# 一键备份所有现有文件（无需确认）
|
||||
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1) -BackupAll
|
||||
```
|
||||
|
||||
**远程安装器的功能：**
|
||||
- ✅ 检查系统要求（PowerShell 版本、网络连接）
|
||||
- ✅ 从 GitHub 下载最新版本（main 分支）
|
||||
- ✅ 包含所有新的统一文件输出系统功能
|
||||
- ✅ 自动解压并运行本地安装程序
|
||||
- ✅ 安全确认和用户提示
|
||||
- ✅ 自动清理临时文件
|
||||
- ✅ 设置 .workflow/ 目录结构进行会话管理
|
||||
|
||||
**注意**：为了跨平台兼容性，界面使用英文
|
||||
|
||||
## 📂 本地安装
|
||||
|
||||
### 所有平台（PowerShell）
|
||||
```powershell
|
||||
# 克隆包含最新功能的仓库
|
||||
git clone -b main https://github.com/catlog22/Claude-CCW.git
|
||||
cd Dmsflow
|
||||
|
||||
# Windows PowerShell 5.1+ 或 PowerShell Core（仅支持全局安装）
|
||||
.\Install-Claude.ps1
|
||||
|
||||
# Linux/macOS PowerShell Core（仅支持全局安装）
|
||||
pwsh ./Install-Claude.ps1
|
||||
```
|
||||
|
||||
**注意**：功能分支包含所有最新的统一文件输出系统增强功能，应用于新安装。
|
||||
|
||||
## 安装选项
|
||||
|
||||
### 远程安装参数
|
||||
|
||||
所有参数都可以传递给远程安装器：
|
||||
|
||||
```powershell
|
||||
# 全局安装
|
||||
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1) -Global
|
||||
|
||||
# 安装到指定目录
|
||||
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1) -Directory "C:\MyProject"
|
||||
|
||||
# 强制覆盖而不提示
|
||||
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1) -Force -NonInteractive
|
||||
|
||||
# 从特定分支安装
|
||||
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1) -Branch "dev"
|
||||
|
||||
# 跳过备份（更快）
|
||||
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1) -NoBackup
|
||||
```
|
||||
|
||||
### 本地安装选项
|
||||
|
||||
### 全局安装（默认且唯一模式）
|
||||
安装到用户主目录（`~/.claude`）：
|
||||
```powershell
|
||||
# 所有平台 - 全局安装（默认）
|
||||
.\Install-Claude.ps1
|
||||
|
||||
# 自动备份（从 v1.1.0 开始默认）
|
||||
.\Install-Claude.ps1 -BackupAll
|
||||
|
||||
# 禁用自动备份（不推荐）
|
||||
.\Install-Claude.ps1 -NoBackup
|
||||
|
||||
# 自动化的非交互式模式
|
||||
.\Install-Claude.ps1 -Force -NonInteractive
|
||||
```
|
||||
|
||||
**全局安装结构：**
|
||||
```
|
||||
~/.claude/
|
||||
├── agents/
|
||||
├── commands/
|
||||
├── output-styles/
|
||||
├── settings.local.json
|
||||
└── Claude.md
|
||||
```
|
||||
|
||||
**注意**：从 v1.2.0 开始，仅支持全局安装。移除了本地目录和自定义路径安装，以简化安装流程并确保所有平台的一致行为。
|
||||
|
||||
## 高级选项
|
||||
|
||||
### 强制安装
|
||||
覆盖现有文件：
|
||||
```powershell
|
||||
.\Install-Claude.ps1 -Force
|
||||
```
|
||||
|
||||
### 跳过备份
|
||||
不创建备份文件：
|
||||
```powershell
|
||||
.\Install-Claude.ps1 -NoBackup
|
||||
```
|
||||
|
||||
### 卸载
|
||||
删除安装：
|
||||
```powershell
|
||||
.\Install-Claude.ps1 -Uninstall -Force
|
||||
```
|
||||
|
||||
## 平台要求
|
||||
|
||||
### PowerShell（推荐）
|
||||
- **Windows**：PowerShell 5.1+ 或 PowerShell Core 6+
|
||||
- **Linux**：PowerShell Core 6+
|
||||
- **macOS**：PowerShell Core 6+
|
||||
|
||||
安装 PowerShell Core：
|
||||
- **Ubuntu/Debian**：`sudo apt install powershell`
|
||||
- **CentOS/RHEL**：`sudo dnf install powershell`
|
||||
- **macOS**：`brew install powershell`
|
||||
- **或下载**：https://github.com/PowerShell/PowerShell
|
||||
|
||||
## 完整安装示例
|
||||
|
||||
### ⚡ 超快速（一键）
|
||||
```powershell
|
||||
# 一条命令完成安装
|
||||
iex (iwr -useb https://raw.githubusercontent.com/catlog22/Dmsflow/main/install-remote.ps1) -Global
|
||||
|
||||
# 完成！🎉
|
||||
# 开始使用 Claude Code Agent 工作流！
|
||||
```
|
||||
|
||||
### 📂 手动安装方法
|
||||
```powershell
|
||||
# 手动安装步骤：
|
||||
# 1. 安装 PowerShell Core（如果需要）
|
||||
# Windows：从 GitHub 下载
|
||||
# Linux：sudo apt install powershell
|
||||
# macOS：brew install powershell
|
||||
|
||||
# 2. 下载 Claude Code 工作流系统
|
||||
git clone https://github.com/catlog22/Claude-CCW.git
|
||||
cd Dmsflow
|
||||
|
||||
# 3. 全局安装（交互式）
|
||||
.\Install-Claude.ps1 -Global
|
||||
|
||||
# 4. 开始使用 Claude Code Agent 工作流！
|
||||
# 使用 /workflow 命令和 DMS 系统进行开发
|
||||
```
|
||||
|
||||
## 验证
|
||||
|
||||
安装后，验证：
|
||||
|
||||
1. **检查安装：**
|
||||
```bash
|
||||
# 全局
|
||||
ls ~/.claude
|
||||
|
||||
# 本地
|
||||
ls ./.claude
|
||||
```
|
||||
|
||||
2. **测试 Claude Code：**
|
||||
- 在项目中打开 Claude Code
|
||||
- 检查全局 `.claude` 目录是否被识别
|
||||
- 验证工作流命令和 DMS 命令是否可用
|
||||
- 测试 `/workflow` 命令的 Agent 协调功能
|
||||
- 测试 `/dmsflow version` 检查版本信息
|
||||
|
||||
## 故障排除
|
||||
|
||||
### PowerShell 执行策略
|
||||
如果出现执行策略错误：
|
||||
```powershell
|
||||
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
|
||||
```
|
||||
|
||||
### 工作流命令无效
|
||||
- 确保项目中存在 `.claude` 目录
|
||||
- 验证 workflow.md 和 agent 文件是否正确安装
|
||||
- 检查 Claude Code 是否识别配置
|
||||
|
||||
### 权限错误
|
||||
- **Windows**：以管理员身份运行
|
||||
- **Linux/macOS**：如果需要全局 PowerShell 安装，使用 `sudo`
|
||||
|
||||
## 安装器功能说明
|
||||
|
||||
### 🛡️ 用户配置保护
|
||||
安装器会智能处理现有文件：
|
||||
- **新文件**：直接复制
|
||||
- **非配置文件**：覆盖更新
|
||||
- **用户配置文件**（如 `settings.local.json`）：提供选项
|
||||
- 保留现有文件（推荐）
|
||||
- 覆盖为新文件
|
||||
- 备份后覆盖
|
||||
|
||||
### 📦 安全卸载
|
||||
卸载时保护用户数据：
|
||||
- **选项 1**：仅删除安装的文件（保留用户配置）
|
||||
- **选项 2**：删除整个目录（需要二次确认）
|
||||
- **选项 3**：不删除任何内容
|
||||
|
||||
### 🔄 智能备份
|
||||
- 自动为现有文件创建带时间戳的备份
|
||||
- 备份文件格式：`filename.backup_yyyyMMdd_HHmmss`
|
||||
- 可以使用 `-NoBackup` 跳过备份
|
||||
|
||||
## 常见问题
|
||||
|
||||
**Q：为什么安装器界面是英文的？**
|
||||
A：为了确保跨平台兼容性并避免字符编码问题，安装器使用英文界面。
|
||||
|
||||
**Q：可以自定义安装位置吗？**
|
||||
A：是的，使用 `-Directory` 参数指定任何位置。
|
||||
|
||||
**Q：如何更新到最新版本？**
|
||||
A：再次运行一键安装命令，它会自动获取最新版本。
|
||||
|
||||
**Q：卸载会删除我的配置吗？**
|
||||
A：默认情况下，卸载只删除我们安装的文件，保留您的个人配置。
|
||||
|
||||
## 支持
|
||||
|
||||
- **问题**：[GitHub Issues](https://github.com/catlog22/Claude-CCW/issues)
|
||||
- **文档**：[主 README](README_CN.md)
|
||||
- **工作流文档**：[.claude/commands/workflow.md](.claude/commands/workflow.md)
|
||||
Reference in New Issue
Block a user