Cadence

# Cadence

Cadence 是一个基于 Claude Code Skills 的多 Agent 协作系统，为 AI 编码助手提供完整的软件开发工作流程。

## 如何工作

Cadence 从你启动编码助手的那一刻开始工作。当它发现你正在构建某样东西时，它不会直接跳进去写代码，而是退后一步，问你真正想做什么。

一旦通过对话明确了需求，它会分块展示设计，让你能够真正阅读和理解。

在你批准设计后，你的助手会制定一个清晰的实现计划，强调真正的红/绿 TDD、YAGNI（你不会需要它）和 DRY。

接下来，一旦你说"开始"，它会启动一个多 Agent 协作流程，让 Agents 通过每个工程任务，检查和审查他们的工作，继续前进。Claude 通常能够自主工作几个小时，而不会偏离你制定的计划。

还有更多功能，但这是系统的核心。而且因为 Skills 会自动触发，你不需要做任何特别的事情。你的编码助手就拥有了节奏（Cadence）。

## 写在安装之前

### 模型推荐

#### 国内模型（推荐）

**1. GLM-5（智谱 AI）**
- ✨ **开源 SOTA 表现**：Coding 和 Agent 能力达到开源模型顶尖水平
- 🚀 **逼近 Opus 性能**：真实编程场景使用体感逼近 Claude Opus 4.5
- 🎯 **擅长复杂工程**：专为复杂系统工程与长程 Agent 任务设计
- 💰 **高性价比**：744B MoE 架构，每次推理仅激活约 10B 参数，成本更低
- 🇨🇳 **国产芯片适配**：对国产芯片适配良好，摆脱海外算力依赖

**2. MiniMax M2.5**
- ⚡ **极速推理**：100 TPS 输出速度，是主流模型的 2 倍
- 💎 **顶尖编程能力**：核心编码能力与海外顶尖闭源模型持平
- 💸 **超高性价比**：价格仅为主流旗舰模型的十分之一，支持本地部署
- 🔧 **Agent 原生设计**：专为 Agent 场景和工程效率优化
- 🌍 **多语言优势**：在多语言编码、推理速度、使用成本上具备显著优势

#### 海外模型（可选）

**1. Claude Opus 4.6**
- 👑 **最强编程能力**：终端编码、代理搜索、抽象推理等极端复杂场景的王者
- 📚 **100 万 Token 上下文**：处理超大规模代码库和文档集（Beta）
- 🎯 **长时程 Agent**：为长时程自主任务设计，可工作数小时
- 🔍 **深度推理**：扩展思考模式，适合需要深度逻辑推理的任务

**2. Claude Sonnet 4.6**
- ⚖️ **最佳性价比**：性能接近 Opus 4.6，价格仅五分之一
- 🎨 **多模态能力强**：在多模态识别与办公任务中表现优异
- 💻 **编程能力出色**：代码修改更精准，支持 100 万 Token 上下文（Beta）
- 🚀 **全面升级**：编码、计算机使用、长上下文推理、代理规划全面增强


### Claude Code 安装方式

#### 方式 1：官网安装（海外用户推荐）
访问 Claude Code 官网：https://claude.com/product/claude-code

#### 方式 2：国内镜像安装（国内用户推荐）

**国内镜像站**
- Claude-CN：https://www.claude-cn.org/
- 提供详细的国内镜像使用指南

#### 方式 3：npm 安装
```bash
# 安装 Node.js（需要 18.0 以上版本）
# 然后全局安装 Claude Code
npm install -g @anthropic-ai/claude-code
```

#### 方式 4：macOS Homebrew 安装
```bash
brew install claude-code
```

#### 方式 5：Linux APT 安装
```bash
# 添加 Anthropic 仓库
curl -fsSL https://packages.anthropic.com/public/gpg.key | sudo apt-key add -
echo "deb https://packages.anthropic.com/public stable main" | sudo tee /etc/apt/sources.list.d/anthropic.list

# 安装 Claude Code
sudo apt update
sudo apt install claude-code
```

### 推荐模型代理工具

**1. CC-Switch（推荐）**
- 🎨 **图形化界面**：操作简单，无需手动编辑配置文件
- 🔄 **一键切换**：支持 GLM、Qwen、DeepSeek 等主流国产大模型
- 🛠️ **多工具支持**：支持 Claude Code、Codex、Gemini CLI 等主流 AI 编程工具
- 📦 **跨平台**：支持 macOS、Linux、Windows
- 🔗 **GitHub**：https://github.com/farion1231/cc-switch

**2. Claude Code Router（ccr）**
- 🚦 **智能路由**：根据任务类型自动选择最适合的 AI 模型
- 🎯 **灵活策略**：支持自定义默认路由模型、背景模型和思考链模型
- 💰 **成本优化**：使用高性价比模型，降低使用成本
- 🔓 **无需官方账号**：支持第三方模型服务商
- 🔗 **GitHub**：https://github.com/musistudio/claude-code-router

### 推荐 IDE

**Trae（字节跳动）**
- 🇨🇳 **国产 AI IDE**：字节跳动推出的 AI 原生集成开发环境
- 🎯 **中文优化**：深度适配中文开发者，技术术语精准解析
- 🔧 **Builder 模式**：支持端到端项目构建，设计稿直转前端代码
- 💡 **SOLO 模式**：2025 年 8 月新增，实现全流程自动化开发
- 🆓 **完全免费**：现阶段完全免费使用
- 🌐 **官网**：https://www.trae.ai/

## 安装

### 方式 1: 通过插件市场安装（推荐）

在 Claude Code 中，首先注册市场：

```bash
/plugin marketplace add michaelChe956/Cadence-skills
```

然后从这个市场安装插件：

```bash
/plugin install cadence@cadence-skills-marketplace
```

### 方式 2: 从源码安装

如果你想从源代码安装，可以使用以下步骤：

#### 步骤 1: 获取项目代码

你可以通过以下任意方式获取项目代码：

**方式 A: 使用 Git 克隆（推荐）**
```bash
git clone https://github.com/michaelChe956/Cadence-skills.git
cd Cadence-skills
```

**方式 B: 下载压缩包**
- 从 GitHub 下载：`https://github.com/michaelChe956/Cadence-skills/archive/refs/heads/main.zip`
- 解压到本地目录
- 进入项目目录

#### 步骤 2: 运行安装脚本

项目提供了跨平台安装脚本：

**Linux/macOS**：
```bash
chmod +x install-offline.sh
./install-offline.sh
```

**Windows**：
```cmd
# 双击运行或在命令行中执行
install-offline.bat
```

安装脚本会自动将项目安装到 `~/.claude/plugins/marketplaces/cadence-skills-local/` 目录。

#### 步骤 3: 配置项目启用插件

在需要使用 Cadence 插件的项目目录中，执行以下操作：

1. **创建 `.claude/` 目录**：
```bash
mkdir -p .claude
```

2. **创建 `settings.json` 文件**：
```bash
# Linux/macOS
touch .claude/settings.json

# Windows
type nul > .claude\settings.json
```

3. **复制以下内容到 `settings.json` 文件**：
```json
{
  "enabledPlugins": {
    "cadence@cadence-skills-marketplace": true
  }
}
```

完成以上步骤后，重启 Claude Code 即可在该项目中使用 Cadence 插件。

#### 步骤 4: 更新插件

如果需要更新插件，重复步骤 1 到步骤 3。

### 验证安装

在你选择的平台中开始一个新会话，请求一些应该触发 Skill 的内容（例如，"帮我规划这个功能"或"让我们调试这个问题"）。助手应该自动调用相关的 Cadence Skills。

## 项目初始化

> **重要**：安装完成后，强烈建议执行以下初始化步骤，确保项目环境正确配置。

### 步骤 1：前置条件检查

执行 `/pre-check` 命令，自动检查和配置必要的工具：

```bash
/pre-check
```

该命令会：
- ✅ 检查 npx 是否安装（Node.js 包执行器）
- ✅ 检查 uvx 是否安装（Python 包执行器）
- ✅ 检查 serena 项目是否配置（用于代码分析）
- ✅ 自动安装缺失的工具
- ✅ 引导您完成 serena 项目配置

### 步骤 2：项目初始化

执行 `/init` 命令，初始化项目环境：

```bash
/init
```

该命令会：
- ✅ 检测项目类型和技术栈
- ✅ 创建 `.claude/` 目录结构
- ✅ 配置项目规则和模板

### 步骤 3：项目分析

执行 `/project-analysis` 命令，分析项目结构：

```bash
/project-analysis
```

该命令会：
- ✅ 分析项目技术栈和依赖
- ✅ 生成项目初始化分析摘要文档

### 步骤 4：Claude Code 规则配置

执行 `/rule-config` 命令，配置项目规则：

```bash
/rule-config
```

该命令会：
- ✅ 配置语言规则
- ✅ 配置文档规则
- ✅ 配置命名规则
- ✅ 配置目录结构

### 步骤 5：MCP 配置

执行 `/mcp-configuration` 命令，配置 MCP：

```bash
/mcp-configuration
```

该命令会：
- ✅ 创建 `.mcp.json` 配置文件
- ✅ 配置 MCP 使用规则

### 步骤 6（可选）：项目个性化规则

执行 `/project-rules-examples` 命令，创建项目个性化规则：

```bash
/project-rules-examples
```

该命令会：
- ✅ 创建需求文档模板
- ✅ 创建设计文档模板
- ✅ 创建代码开发规范
- ✅ 创建测试规范

**完成后**，您的项目就准备好使用 Cadence 的完整工作流程了！

## 基本工作流程



... (truncated)