From 95555e282810900a5c0ab4fc04634f88edbee8a3 Mon Sep 17 00:00:00 2001 From: claude_dev Date: Mon, 29 Jun 2026 19:50:18 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0videotext=E6=96=B9?= =?UTF-8?q?=E6=A1=88=E8=B0=83=E6=9F=A5=E6=8A=A5=E5=91=8A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../02-videotext-investigation-report.md | 321 ++++++++++++++++++ 1 file changed, 321 insertions(+) create mode 100644 docs/design/02-videotext-investigation-report.md diff --git a/docs/design/02-videotext-investigation-report.md b/docs/design/02-videotext-investigation-report.md new file mode 100644 index 0000000..236a3e0 --- /dev/null +++ b/docs/design/02-videotext-investigation-report.md @@ -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 | 系统包管理器安装 | + +--- + +**报告结束**