跳转至

团队 Kickoff 讲义大纲

用于初次给团队 20 人讲 "我们要怎么用 AI 协作" 的 60 分钟讲座。 实际 PPT 由 Tech Lead 用本大纲生成（可让 Claude Code 转 Markdown → PPT）。

1. 开场（5 min）

  • 项目现状 + AI 加速的迫切性
  • 同行案例：用 AI 把团队产能 1.5-3× 的真实数据
  • 我们的目标：6 个月内全员熟练，AI 协作变默认

2. 蓝图（7 min）

放 docs/00_overview/01_ai-collaboration-blueprint.md 的"五条铁律 + 协作架构"图。

强调： - AI 是助理，不是替代 - 草稿 → review → 成品 - 流程的目的是让正确的事容易做、错误的事难做

3. 工具栈（7 min）

基础设施

  • Claude Code (主) + Codex CLI (备)
  • 本仓库 marketplace + 9 个 plugin（8 能力包 + 1 MCP 配置包）
  • 6 个 MCP（内部：PingCode / Axure LLM Wiki；外部：Gitee / Notion / Figma / 钉钉）

流程引擎

  • OpenSpec — 管"做什么"
  • Superpowers — 管"怎么做好"
  • 本仓库 czerp- — 管"我们项目特有的"

放 02_workflow-diagram.md 全景图。

4. 角色 Demo（18 min，每角色约 3-4 分钟）

PM Demo

  • Notion 一堆原料 → notion-research-distill 提炼
  • Figma 设计稿 → figma-to-axure 转原型
  • user-story-author 写故事
  • pingcode-sync 上传

后端 Demo

  • /user-story-impl 拉故事
  • /openspec-new 起 change
  • crud-scaffold / data-scope skill 引用范式
  • /pre-pr-review 自查

前端 Demo

  • 用 avue-and-element 标准列表
  • metadata 字典工具
  • components-catalog 查公司封装

QA Demo

  • testplan-author 起计划
  • testcase-author 拆 验收标准
  • ai-driven-regression 跑回归
  • 失败 → defect-submission

Ops Demo

  • k8s-troubleshooting cookbook
  • gitops-deploy 改 image tag
  • monitoring-and-alerts 监控

5. 学习路径（4 min）

6. 安全与合规（4 min）

  • 客户敏感数据不进 AI 上下文
  • token / 密钥不进 chat / commit
  • prod 改动双人 + 钉钉广播
  • AI 输出的代码必须人类 review 才能合并

7. Q & A（剩余时间）

前 6 节约 45 分钟，预留约 15 分钟回答疑问（共 60 分钟）。

备料：常见疑问 FAQ

Q：Claude 会不会代替我？ A：不会。它处理重复劳动；业务理解、架构判断、用户体验把关是人类的核心价值。

Q：用 Codex 不行吗？ A：行，本仓库双轨兼容（见 01_onboarding/04_multi-agent.md）。Claude Code 与 Codex 共用同一份 AGENTS.md + skills，按个人习惯选。

Q：万一 AI 写的代码有 bug 谁负责？ A：合并到主干的代码 = 提 PR 的人负责。AI 是工具，人类对代码的正确性、安全性最终负责。

Q：故事还没评审就开始让 AI 写代码？ A：可以先让 AI 帮你"评估"故事完整性，但实现必须在故事评审后。

Q：用 OpenSpec 不烦吗？ A：对小改动可豁免。对中大改动，spec 一开始投资 30 分钟，省后期 3 小时返工。

Q：MCP 装不上 / 跑不通？ A：跟 Ops 反馈，我们有专人维护。