docs: 添加videotext方案调查报告
This commit is contained in:
@@ -0,0 +1,321 @@
|
||||
# videotext 方案调查报告
|
||||
|
||||
**来源**: /Volumes/KnowledgeBase/videotext/
|
||||
**图片数量**: 23张
|
||||
**提取时间**: 2026-06-29
|
||||
**文档状态**: 原始回溯，无加工
|
||||
|
||||
---
|
||||
|
||||
## 一、方案概述
|
||||
|
||||
这是一个 **Claude Code + Superpowers + CCB (Claude Code Bridge)** 多 AI 协作开发方案。
|
||||
|
||||
### 核心理念
|
||||
|
||||
**让 Claude 只做决策（高价值），把体力活交给便宜的 AI**
|
||||
|
||||
---
|
||||
|
||||
## 二、三层架构
|
||||
|
||||
### 2.1 架构图
|
||||
|
||||
```
|
||||
CLAUDE.md (规则层)
|
||||
↓ Claude 启动时自动读取，里面定义了协作规范和角色分工
|
||||
|
||||
Superpowers (能力层)
|
||||
↓ 作为 Skills 安装在 .claude/skills/ 目录下，提供标准化的规划、审查、调试流程
|
||||
|
||||
CCB (通信层)
|
||||
↓ 桥接器，让 Claude 能通过 /ask、/pend、/ping 指挥 Codex 和 Gemini
|
||||
```
|
||||
|
||||
### 2.2 完整链路
|
||||
|
||||
```
|
||||
CLAUDE.md 定好规则 → Superpowers 提供标准流程 → CCB 打通多模型通信
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 三、角色分工
|
||||
|
||||
### Claude (架构师 / 项目经理)
|
||||
|
||||
**职责**:
|
||||
- 需求分析、架构设计、任务拆分
|
||||
- 使用 Superpowers 进行规划、审查、调试
|
||||
- 代码审核、最终验收、Git 提交管理
|
||||
- **绝对不亲自编写代码**
|
||||
|
||||
**成本**: 最贵，但用量极少（仅规划、任务拆分、验收）
|
||||
|
||||
### Codex (后端开发)
|
||||
|
||||
**职责**:
|
||||
- 服务端代码、API、数据库、Migration
|
||||
- 单元测试、集成测试
|
||||
|
||||
**调用方式**: `/ask codex "..."`
|
||||
|
||||
**成本**: 几乎免费（代码、数据库、测试）
|
||||
|
||||
### Gemini (前端开发)
|
||||
|
||||
**职责**:
|
||||
- 前端组件、页面、样式、交互逻辑
|
||||
- 代码审查、安全审计
|
||||
|
||||
**调用方式**: `/ask gemini "..."`
|
||||
|
||||
**成本**: 几乎免费（前端页面、代码审查、安全审计）
|
||||
|
||||
---
|
||||
|
||||
## 四、成本结构
|
||||
|
||||
| AI | 角色 | 成本特点 |
|
||||
|---|------|---------|
|
||||
| Claude | 规划、任务拆分、验收 | 最贵，但用量极少 |
|
||||
| Codex | 代码、数据库、测试 | 几乎免费 |
|
||||
| Gemini | 前端、代码审查、安全审计 | 几乎免费 |
|
||||
|
||||
---
|
||||
|
||||
## 五、前置准备
|
||||
|
||||
### 5.1 环境检查
|
||||
|
||||
需要安装三样工具：
|
||||
|
||||
1. **Claude Code**
|
||||
2. **Codex CLI** (OpenAI 的命令行工具)
|
||||
```bash
|
||||
npm install -g @openai/codex
|
||||
export OPENAI_API_KEY="你的 OpenAI Key"
|
||||
```
|
||||
|
||||
3. **Gemini CLI** (Google 的命令行工具)
|
||||
```bash
|
||||
npm install -g @google/gemini-cli
|
||||
export GEMINI_API_KEY="你的 Gemini Key"
|
||||
```
|
||||
|
||||
### 5.2 版本验证
|
||||
|
||||
```bash
|
||||
claude --version # 2.1.39
|
||||
codex --version # codex-cli 0.98.0
|
||||
gemini --version # 有版本号输出
|
||||
```
|
||||
|
||||
### 5.3 tmux 安装
|
||||
|
||||
**Mac**:
|
||||
```bash
|
||||
brew install tmux
|
||||
tmux -V
|
||||
```
|
||||
|
||||
**Linux (Ubuntu/Debian)**:
|
||||
```bash
|
||||
sudo apt-get install tmux
|
||||
tmux -V
|
||||
```
|
||||
|
||||
**Windows**:
|
||||
```bash
|
||||
choco install tmux
|
||||
# 或
|
||||
scoop install tmux
|
||||
tmux -V
|
||||
```
|
||||
|
||||
### 5.4 tmux 配置 (~/.tmux.conf)
|
||||
|
||||
```bash
|
||||
# 启用鼠标支持
|
||||
set -g mouse on
|
||||
|
||||
# 设置前缀键为 Ctrl+a
|
||||
set -g prefix C-a
|
||||
unbind C-b
|
||||
bind C-a send-prefix
|
||||
|
||||
# 设置窗口和面板的索引从 1 开始
|
||||
set -g base-index 1
|
||||
setw -g pane-base-index 1
|
||||
|
||||
# 状态栏配置
|
||||
set -g status-left-length 32
|
||||
set -g status-right-length 150
|
||||
set -g status-interval 5
|
||||
set -g status-bg colour234
|
||||
set -g status-fg white
|
||||
```
|
||||
|
||||
### 5.5 tmux 基本操作
|
||||
|
||||
- 创建新会话: `tmux new -s session_name`
|
||||
- 分离会话: `Ctrl+a d`
|
||||
- 重新连接: `tmux attach -t session_name`
|
||||
- 切换窗口: `Ctrl+a 数字`
|
||||
- 切换面板: `Ctrl+a 方向键`
|
||||
- 垂直分割: `Ctrl+a %`
|
||||
- 水平分割: `Ctrl+a "`
|
||||
- 关闭面板: `Ctrl+a x`
|
||||
|
||||
---
|
||||
|
||||
## 六、CCB (Claude Code Bridge) 安装
|
||||
|
||||
### 6.1 系统要求
|
||||
|
||||
- Python 3.10 以上版本
|
||||
|
||||
```bash
|
||||
python3 --version # 需要 3.10+
|
||||
```
|
||||
|
||||
### 6.2 安装步骤
|
||||
|
||||
```bash
|
||||
git clone https://github.com/bfly123/claude_code_bridge.git
|
||||
```
|
||||
|
||||
**注意**: CCB 是社区项目，作者 bfly123 开源，不是官方内置功能。
|
||||
|
||||
### 6.3 CCB 安装后自动配置
|
||||
|
||||
安装后，CCB 会自动：
|
||||
- 往 CLAUDE.md 追加配置
|
||||
- 注册 `/ask`、`/pend`、`ping` 命令
|
||||
- 更新 Codex skills 目录
|
||||
- 更新 AI 协作规则
|
||||
- 安装辅助脚本 (ccb-status.sh, ccb-border.sh, ccb-nit.sh)
|
||||
|
||||
### 6.4 可用命令
|
||||
|
||||
```bash
|
||||
# Codex 通信
|
||||
cask / cping / cpend
|
||||
|
||||
# Gemini 通信
|
||||
gask / gping / gpend
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 七、CLAUDE.md 核心规范
|
||||
|
||||
### 工作模式
|
||||
|
||||
**Superpowers + AI 协作**
|
||||
|
||||
### 角色分工
|
||||
|
||||
**Claude (我) — 架构师 / 项目经理**:
|
||||
- 需求分析、架构设计、任务拆分
|
||||
- 使用 Superpowers 进行规划、审查、调试
|
||||
- 代码审核、最终验收、Git 提交管理
|
||||
- **绝对不亲自编写代码**，所有编码任务必须委派给 Codex 或 Gemini
|
||||
|
||||
**Codex — 后端开发**:
|
||||
- 服务端代码、API、数据库、Migration
|
||||
- 单元测试、集成测试
|
||||
- 通过 `/ask codex "..."` 调用
|
||||
|
||||
**Gemini — 前端开发**:
|
||||
- 前端组件、页面、样式、交互逻辑
|
||||
- 代码审查、安全审计
|
||||
- 通过 `/ask gemini "..."` 调用
|
||||
|
||||
### 降级机制
|
||||
|
||||
降级时在任务描述中注明"降级接管"，便于后续追溯。
|
||||
|
||||
### 协作方式
|
||||
|
||||
**使用 Superpowers skills 进行**:
|
||||
- 规划: `superpowers:writing-plans`
|
||||
- 执行: `superpowers:executing-plans`
|
||||
- 审查: `superpowers:requesting-code-review`
|
||||
- 调试: `superpowers:systematic-debugging`
|
||||
- 完成: `superpowers:finishing-a-development-branch`
|
||||
|
||||
**调用 AI 提供者执行代码任务**:
|
||||
```bash
|
||||
# 指派 Codex 实现后端
|
||||
/ask codex "实现 XXX 后端功能，涉及文件：..."
|
||||
|
||||
# 指派 Gemini 实现前端
|
||||
/ask gemini "实现 XXX 前端功能，涉及文件：..."
|
||||
|
||||
# 查看执行结果
|
||||
/pend codex
|
||||
/pend gemini
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 八、Linus 三问 (决策前必问)
|
||||
|
||||
1. **这是现实问题还是想象问题？** → 拒绝过度设计
|
||||
2. **这个问题真的需要解决吗？** → 拒绝伪需求
|
||||
3. **这个方案真的能解决问题吗？** → 拒绝自嗨
|
||||
|
||||
---
|
||||
|
||||
## 九、实战演示架构
|
||||
|
||||
### 启动顺序
|
||||
|
||||
```
|
||||
askd started at 127.0.0.1:32779
|
||||
↓
|
||||
Starting Gemini backend (tmux)
|
||||
Gemini started! (tmux pane: #1)
|
||||
↓
|
||||
Starting Codex backend (tmux)
|
||||
Codex started! (tmux pane: #2)
|
||||
↓
|
||||
Waiting for codex...
|
||||
Codex connection OK (Session healthy)
|
||||
↓
|
||||
Starting Claude...
|
||||
Session ID: 1770888307-6072
|
||||
Runtime dir: /tmp/claude-ai-dev-ai-1770888307-6072
|
||||
Active backends: codex, gemini, claude
|
||||
```
|
||||
|
||||
### 三个终端界面
|
||||
|
||||
1. **Claude 端** — 规划与指挥
|
||||
2. **Gemini 端** — 前端开发
|
||||
3. **Codex 端** — 后端开发
|
||||
|
||||
---
|
||||
|
||||
## 十、Superpowers Marketplace 安装
|
||||
|
||||
```bash
|
||||
/plugin marketplace add https://github.com/obra/superpowers-marketplace
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 附录：技术栈和版本
|
||||
|
||||
| 组件 | 版本 |
|
||||
|------|------|
|
||||
| Claude Code | v2.1.39 |
|
||||
| CCB | v5.2.3 |
|
||||
| Codex CLI | 0.98.0 |
|
||||
| Python | 3.10+ |
|
||||
| tmux | 系统包管理器安装 |
|
||||
|
||||
---
|
||||
|
||||
**报告结束**
|
||||
Reference in New Issue
Block a user