腾讯体育 Vibe Coding 实践：基于 Claude Code 的团队 AI 工作流框架落地

传统组件：    团队共享代码  → 减少重复实现
AI 业务组件：团队共享知识  → 减少重复沟通

oh-sports-claudecode/
│
├── knowledge/                          ★ Layer 1: 知识层
│   ├── common/rules/                  通用规范（注入 CLAUDE.md）
│   │   ├── execution.md               执行连续性 + 知识锚定 + 提交规范
│   │   ├── review.md                  CR 规范 + 写审分离
│   │   └── verification.md            完整性验证 + 契约清单
│   ├── backend/rules/                 后端角色规范（注入）
│   │   ├── go-team-conventions.md    Go 团队约定（tRPC/DDD）
│   │   ├── dev-workflow.md            自动路由 + 轻量 AC 清单
│   │   ├── unit-testing.md           GoMock + testify 单测约定
│   │   └── trpc-mcp-usage.md        tRPC MCP 使用策略
│   ├── backend/docs/                  参考文档（按需读取，不注入）
│   ├── ios/rules/                    iOS 角色规范
│   ├── frontend/skills/              前端 osc-fe 技能集合
│   └── android/rules/                Android 角色规范
│
├── skills/                            ★ Layer 2: Workflow 层
│   ├── osc-setup/                    /osc-setup 一键初始化
│   ├── osc-update/                   /osc-update 一键更新
│   ├── osc-ap/                       完整研发 workflow
│   ├── osc-parallel/                 多分支并行开发
│   └── osc-review-code/              MR 代码评审
│
├── scripts/                           ★ Layer 3: 工具层
│   ├── merge-settings.py             知识库注入 CLAUDE.md
│   ├── apply-patches.sh             Patch 应用（LLM 驱动）
│   ├── detect-structural-changes.sh  Hook: 检测结构性变更
│   └── check-knowledge-size.sh      CI: 知识库行数门控
│
├── patches/                          OMC 定制补丁（按版本沉淀）
└── templates/                        项目 CLAUDE.md 模板

┌─────────────────────────────────────────────────────┐
│                  用户触发命令                        │
│            /osc-setup  /osc-ap  /osc-parallel       │
└──────────────────┬──────────────────────────────────┘
                   │
         ┌─────────▼──────────┐
         │   Layer 2: Workflow │  技能编排（Skills）
         │   (osc-ap 等)      │
         └─────────┬──────────┘
                   │ 读取知识 + 调用工具
         ┌─────────▼──────────┐
         │   Layer 1: 知识层   │  团队规范（注入 CLAUDE.md）
         │   (rules/docs)     │  + 按需读取的参考文档
         └─────────┬──────────┘
                   │ 调用
         ┌─────────▼──────────┐
         │   Layer 3: 工具层   │  确定性执行（scripts/hooks）
         │   (scripts/hooks)  │  + CI 门控
         └─────────────────────┘

rules/     → 注入 CLAUDE.md，AI 启动时直接可用（小文件 < 100 行）
docs/      → 按需读取，Skill 执行时再加载完整内容

// templates/hooks.json
{
  "PostToolUse": [
    {
      "matcher": "Edit|Write",
      "glob": "*.go",
      "command": "bash scripts/hook-auto-build.sh"
    }
  ]
}

knowledge/backend/
├── rules/                        ← 自动注入到项目 CLAUDE.md
│   ├── go-team-conventions.md   ← 核心约定（组件选型、tRPC 用法、DDD 分层）
│   ├── dev-workflow.md          ← 自动路由规则 + 轻量 AC 清单
│   ├── unit-testing.md          ← 单测规范
│   └── trpc-mcp-usage.md       ← MCP 使用策略
│
└── docs/                        ← 按需读取（Skill 执行时加载）
    ├── go-standards-full.md     ← Go 编码规范完整版
    ├── trpc-architecture-full.md← DDD 架构完整版（含 CRUD 示例）
    ├── trpc-config.md           ← tRPC 配置详解
    └── security.md              ← 安全规范

用户："实现 XX 功能"
    │
    ├── 1-2 文件小改动 → 快速流程（Edit → Build → Test）
    │                    └── 若含逻辑变更，再补独立 review
    │
    ├── 需求模糊 → 转 /deep-interview（苏格拉底式需求访谈）
    ├── 方案未定 → 转 /omc-plan（结构化规划）
    ├── 高风险变更 → 转 /ralplan（架构决策）
    │
    └── 进入实现阶段 → 生成轻量 AC 清单（非小改动）
                     → /autopilot 执行
                     → 独立 review
                     → 有 MR 时进入 /osc-review-code ↔ /osc-review-mr 闭环

用户直接描述任务 → AI 自动判断路由 → 小改动快速流程 / 大改动进入 autopilot

/osc-ap "<TAPD_URL 或文本需求>"
    → 输入归一化 → 按需澄清 → 规划 → 轻量 AC 清单
    → ★ 展示给用户确认 ★
    → 用户 Approve → /autopilot 执行
                     → 独立评审
                     → MR 阶段 /osc-review-code
                     → /osc-review-mr 修复评论并回环

/osc-setup
    → Step 1: 确认 OMC 已安装
    → Step 2: 选择开发角色（ios / backend / frontend / android / harmony）
    → Step 3: 选择注入位置（项目级推荐，可提交 git 团队共享）
    → Step 4: 判断当前环境（claude-internal / claude / codebuddy）
    → Step 5: 定位并执行 osc-setup-run.sh 脚本
          ├── 注入知识库到 CLAUDE.md（调 merge-settings.py）
          ├── 生成 .claude/osc-config.json
          ├── 安装角色专属 Skills
          ├── 安装 osc 启动脚本并配置 PATH
          ├── 合并 MCP 配置（调 merge-mcp.py）
          └── CodeBuddy 环境：修复 OMC 兼容性
    → Step 6: 展示结果

/osc-update
    → 拉取 OSC 最新版本（Plugin 机制）
    → 更新 OMC 到最新版本
    → 应用 patches/ 目录下的定制补丁（LLM 驱动）
    → 重新注入知识库到 CLAUDE.md

/osc-ap "https://tapd.woa.com/xxx"
    │
    ├── 输入归一化（TAPD URL / PRD 文本 / 自然语言）
    ├── 按需澄清（需求模糊时调用 /deep-interview）
    ├── 按需规划（方案未定时调用 /omc-plan）
    ├── 生成轻量 AC 清单
    ├── ★ 展示给用户确认 ★（关键卡点）
    ├── 用户 Approve → 调用 /autopilot 执行
    ├── 独立评审（写审分离）
    └── 有 MR 时 → /osc-review-code + /osc-review-mr 闭环

/osc-parallel "feature-A: 实现登录" "feature-B: 重构支付"
    │
    ├── 自动判断可并行性（需求已清晰 + 2-3 个低耦合子任务）
    ├── 为每个子任务创建 worktree + Author Task
    ├── Author claim 任务 → in_progress
    ├── 完成后提交证据 → ready_for_review
    ├── Team Lead 创建 Reviewer Task
    ├── Reviewer 给出 pass / changes_required / blocked
    ├── 通过后 Team Lead 标记 verified
    └── Merge Keeper 顺序合并（每次合并后 build/test）

任务 A 和任务 B 可以并行：
├── 不修改同一个文件
├── 不修改同一个 proto 定义
├── 不同时改 go.mod/go.sum
├── 不存在数据依赖（A 的输出不是 B 的输入）
└── 各自可独立编译通过

pending → in_progress → ready_for_review → verified → completed
                                  ↓
                              blocked（冲突或超时）

git commit 后：
    ├── 新增/删除文件 ≥ 3       → 提醒运行 /osc-init-project
    ├── proto 文件变更           → 提醒更新 CLAUDE.md 模块清单
    ├── go.mod/go.sum 变更       → 提醒更新依赖说明
    └── 仅内部逻辑/bugfix        → 不提醒

# 核心逻辑
for subdir in ["common/rules", f"{role}/rules"]:
    for md_file in glob(f"{subdir}/*.md"):
        content = read(md_file)
        if len(non_empty_lines(content)) < 100:
            inline(content)   # 小文件直接内联
        else:
            reference(md_file)  # 大文件以路径引用方式注入

# 行数门控（CI 模式）
python3 merge-settings.py --role backend --max-lines 200
# 注入后超过 200 行则报错退出

patches/
└── 001-skill-prompt-zh/
    └── ultrawork-SKILL-zh.md

---
target: skills/ultrawork/SKILL.md   # 相对于 OMC 根目录的路径
type: content-replace                # content-replace | append | js-patch
min_omc_version: "4.0.0"
description: "将 ultrawork skill 汉化"
---

# 修改指令（LLM 解释执行）
请将该 SKILL.md 中的所有英文提示词翻译为中文，
保持 YAML frontmatter 格式不变...

需求变更 → 代码改了 → 但项目 CLAUDE.md 没更新
→ 新 session 冷启动 → Agent 基于过时地图工作
→ 浪费 token 重新探索或做出错误决策

session 有代码变更？
    ├── project_memory_add_note          ← 每次都写（变更摘要）
    ├── notepad_write_working           ← 有未完成工作时写
    └── 是否结构性变更？
        ├── 新增/删除目录或模块         → ✅ 更新 CLAUDE.md 模块清单
        ├── 新增 tRPC service          → ✅ 更新 CLAUDE.md 模块清单
        ├── 新增外部系统对接           → ✅ 更新 CLAUDE.md 外部依赖
        └── 仅内部逻辑/bugfix         → ❌ 不更新 CLAUDE.md

1. Claude Code 自动加载 CLAUDE.md        → 项目地图
2. OMC 自动加载 project-memory            → 运行时上下文
3. git log --oneline -10                  → 最近变更概览
4. 检查 .omc/plans/ + notepad             → 未完成工作
5. CLAUDE.md 模块清单 vs 实际目录          → 不一致则主动更新

# 1. 安装 OMC（Claude Code 对话框中手动执行）
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecode

# 2. 安装 OSC
/plugin marketplace add git@git.woa.com:QQSports_iOS/oh-sports-claudecode.git
/plugin install oh-sports-claudecode

# 3. 初始化（选择角色、注入知识库）
/osc-setup

# 4. 日常使用
osc                              # 启动 claude-internal（腾讯内网版）
osc --binary claude              # 使用标准 claude 启动

# 5. 同步更新
/osc-update