CCJK 团队协作：共享 AI 工作流

当多个开发者使用 AI 助手时，一致性变得至关重要。CCJK 提供强大的团队协作功能，确保每个人都遵循相同的模式和实践。

设置团队配置

项目级配置

在仓库中创建共享配置：

hljs yaml
# .claude/config.yaml
version: "1.0"
team: "your-team-name"

# 共享模型设置
model:
  default: claude-sonnet-4-20250514
  fallback: claude-haiku

# 项目上下文
context:
  description: |
    使用以下技术构建的电商平台：
    - Next.js 14（App Router）
    - TypeScript（严格模式）
    - PostgreSQL + Prisma
    - Redis 缓存
    - Tailwind CSS

  conventions:
    - 使用带 hooks 的函数组件
    - 遵循 Airbnb 代码风格指南
    - 为所有业务逻辑编写测试
    - 使用约定式提交

# 共享忽略模式
ignore:
  - node_modules/
  - .next/
  - coverage/
  - "*.log"
  - .env*

团队权限

定义团队成员可以做什么：

hljs yaml
# .claude/permissions.yaml
roles:
  developer:
    read: ["src/**", "tests/**", "docs/**"]
    write: ["src/**", "tests/**"]
    execute: ["npm test", "npm run lint", "npm run build"]

  senior:
    extends: developer
    write: ["src/**", "tests/**", "config/**"]
    execute: ["npm run migrate", "npm run deploy:staging"]

  lead:
    extends: senior
    write: ["**"]
    execute: ["**"]

# 团队成员的默认角色
default_role: developer

共享技能库

创建团队技能

构建团队特定的技能库：

hljs yaml
# .claude/skills/team/create-feature.yaml
name: create-feature
description: 按照团队约定创建新功能
version: 1.0.0
author: 技术负责人

parameters:
  - name: name
    description: 功能名称（kebab-case）
    required: true
    pattern: "^[a-z][a-z0-9-]*$"

  - name: type
    description: 功能类型
    default: page
    options: [page, component, api, service]

prompt: |
  按照我们的团队约定创建名为 "{{name}}" 的新 {{type}} 功能：

  项目结构：
  - 页面放在 src/app/
  - 组件放在 src/components/
  - API 路由放在 src/app/api/
  - 服务放在 src/services/

  要求：
  - 使用严格类型的 TypeScript
  - 包含单元测试
  - 添加 Storybook 故事（组件）
  - 遵循代码库中的现有模式

  参考类似的现有功能以保持一致性。

技能分类

按用途组织技能：

.claude/skills/
├── team/
│   ├── create-feature.yaml
│   ├── create-api-endpoint.yaml
│   └── create-component.yaml
├── review/
│   ├── code-review.yaml
│   ├── security-review.yaml
│   └── performance-review.yaml
├── docs/
│   ├── api-docs.yaml
│   ├── component-docs.yaml
│   └── readme-update.yaml
└── testing/
    ├── unit-test.yaml
    ├── integration-test.yaml
    └── e2e-test.yaml

新成员入职

自动化设置

创建入职技能：

hljs yaml
# .claude/skills/team/onboard.yaml
name: onboard
description: 为新团队成员设置开发环境

steps:
  - name: "环境检查"
    prompt: |
      验证开发环境：
      - 已安装 Node.js 18+
      - npm 或 pnpm 可用
      - Git 已配置
      - 必需的 VS Code 扩展

  - name: "项目设置"
    commands:
      - "npm install"
      - "cp .env.example .env.local"
      - "npm run db:setup"

  - name: "代码库导览"
    prompt: |
      提供代码库导览：
      - 项目结构概述
      - 关键目录及其用途
      - 重要配置文件
      - 开发工作流程

  - name: "第一个任务"
    prompt: |
      为新团队成员建议一个好的第一个任务：
      - 小而明确的任务
      - 涉及代码库的多个部分
      - 有清晰的验收标准

知识库

创建团队知识库：

hljs yaml
# .claude/knowledge/architecture.yaml
topic: architecture
content: |
  ## 系统架构

  ### 前端
  - Next.js 14 使用 App Router
  - React Server Components 用于数据获取
  - Client Components 用于交互
  - Tailwind CSS 用于样式

  ### 后端
  - Next.js 中的 API 路由
  - Prisma ORM 用于数据库访问
  - Redis 用于会话和缓存
  - BullMQ 用于后台任务

  ### 基础设施
  - Vercel 托管前端
  - AWS RDS 用于 PostgreSQL
  - AWS ElastiCache 用于 Redis
  - CloudFlare 用于 CDN

代码审查工作流

标准化审查

创建一致的审查流程：

hljs yaml
# .claude/skills/review/pr-review.yaml
name: pr-review
description: 按照团队标准进行全面的 PR 审查

checklist:
  code_quality:
    - "遵循 TypeScript 最佳实践"
    - "没有无理由的 any 类型"
    - "适当的错误处理"
    - "没有 console.log 语句"

  testing:
    - "新函数有单元测试"
    - "API 更改有集成测试"
    - "测试覆盖率保持或提高"

  security:
    - "没有硬编码密钥"
    - "存在输入验证"
    - "SQL 注入防护"
    - "XSS 防护"

  documentation:
    - "公共函数有 JSDoc"
    - "如需要更新 README"
    - "端点更新 API 文档"

  performance:
    - "没有 N+1 查询"
    - "适当的缓存"
    - "考虑包大小影响"

output_format: |
  ## PR 审查：{{pr_title}}

  ### 摘要
  {{summary}}

  ### 检查清单结果
  {{checklist_results}}

  ### 发现的问题
  {{issues}}

  ### 建议
  {{suggestions}}

  ### 批准状态
  {{status}}

共享提示和模板

提示库

hljs yaml
# .claude/prompts/debugging.yaml
name: debug-production-issue
description: 生产问题调试的系统方法

template: |
  报告了一个生产问题：

  **问题**：{{issue_description}}
  **影响**：{{impact_level}}
  **首次报告**：{{timestamp}}

  请帮助调试此问题：

  1. **收集信息**
     - 检查错误日志
     - 审查最近的部署
     - 识别受影响的用户/请求

  2. **形成假设**
     - 列出可能的原因
     - 按可能性排序

  3. **调查**
     - 对于每个假设，描述如何验证
     - 建议诊断查询/命令

  4. **提出修复**
     - 立即缓解措施
     - 长期解决方案
     - 预防措施

指标和分析

使用跟踪

hljs yaml
# .claude/analytics.yaml
tracking:
  enabled: true
  anonymous: true  # 无个人数据

metrics:
  - skill_usage        # 哪些技能使用最多
  - task_completion    # AI 任务成功率
  - time_saved         # 估计节省的时间
  - error_rate         # AI 建议错误率

reports:
  weekly:
    recipients: ["team-lead@company.com"]
    include: [skill_usage, task_completion]

  monthly:
    recipients: ["engineering@company.com"]
    include: [all]

团队仪表板

跟踪团队 AI 使用情况：

┌─────────────────────────────────────────────────────────┐
│                  CCJK 团队仪表板                         │
├─────────────────────────────────────────────────────────┤
│                                                          │
│  本周统计                                                │
│  ─────────────────                                       │
│  完成任务：147                                           │
│  使用技能：23 个不同                                     │
│  节省时间：约 18 小时                                    │
│  成功率：94%                                             │
│                                                          │
│  热门技能                                                │
│  ──────────                                              │
│  1. /review      - 45 次使用                             │
│  2. /test        - 38 次使用                             │
│  3. /commit      - 32 次使用                             │
│  4. /docs        - 18 次使用                             │
│  5. /refactor    - 14 次使用                             │
│                                                          │
│  团队成员                                                │
│  ────────────                                            │
│  小明：42 任务 | 小红：38 任务 | 小李：35 任务           │
│                                                          │
└─────────────────────────────────────────────────────────┘

最佳实践

1. 版本控制配置

hljs bash
# 包含在仓库中
.claude/config.yaml
.claude/skills/**
.claude/prompts/**
.claude/knowledge/**

# 排除个人设置
.claude/local.yaml  # 添加到 .gitignore

2. 定期技能审查

安排每月技能审查：

• 技能是否仍然相关？
• 是否可以改进？
• 是否有需要填补的空白？

3. 文档

记录团队的 AI 工作流：

• 如何使用共享技能
• 何时创建新技能
• 审查和批准流程

4. 反馈循环

创建 AI 反馈渠道：

• 什么运作良好？
• 什么需要改进？
• 新技能请求

总结

CCJK 的团队协作倍增了 AI 辅助的好处。通过共享配置、技能和最佳实践，你可以确保一致性，同时允许个人生产力提升。

从基本的共享配置开始，然后根据常见需求逐步构建团队的技能库。

下一步：了解 CI/CD 集成以自动化 AI 辅助工作流。