LENOVO 软件开发团队 · 内部分享
VIBE CODING · 工程化进阶 · 30 MIN
LENOVO SOFTWARE · DEV TEAM · 内部分享

从"会用"到会用得对
Vibe Coding 工程化进阶。

我们团队都已经在用 AI 写代码了,今天 30 分钟不再科普"什么是 Vibe Coding", 只交付让你从"玩票级"升级到"工程级"的 4 招。

课程提炼自《Claude Code 企业级全链路开发实战》—— 极客时间 · 已踩过的坑帮你跳过去
主题
CLAUDE.md · Rules · MCP · Hooks
时长
30 分钟(含 2 次现场抽人)
交付物
PPT + 工程化 Demo(前后端 + DB + Docker)
张展亮 · Lenovo 大前端团队
目前主要负责:Studio AI · itcode zhangzl39 · 微信/手机 17310568690

下一页   F 全屏   数字键 跳转   名单数据走真实 PostgreSQL · 扫 P2 二维码即可加入

开场暖身 · 现场抽 1 位

先做个"团队踩坑实况调查"

被抽中的同学请用 30 秒分享:最近一次用 AI 写代码踩过的最大坑
你的痛点 = 我接下来 25 分钟要解决的问题。

📱 还没录名字的现在补
扫码加入抽人池 · 写进真实 PostgreSQL
加载中...
点击下方按钮开始 →
已抽中 0 人 · 总名单 0 人

💡 这个抽人小工具,本身就是今天 Demo 的"轻量版"——完整工程化版本会在 P9 演示。

01我们都在 Vibe,但...

我相信在座 90% 的同学每天都在用 Cursor / Claude Code / Copilot 写代码。但我们一起做个诚实的对比——

✕ "玩票级"使用方式(80% 的人停在这里)

  • 每次都从 0 开始写 Prompt,团队没有共识
  • AI 写出来不符合团队规范,自己手动改
  • 重复贴上下文:"我们用 Vue3 + TypeScript + ..."
  • 不同人 vibe 出来的代码风格五花八门
  • AI 不知道项目里能用 / 不能用什么库
  • 没接外部工具,只能"对着空气"写代码

✓ "工程级"使用方式(今天要带你升级的)

  • 项目级 CLAUDE.md:AI 一进项目就懂规则
  • 个人 + 项目级 Rules:风格全员对齐
  • MCP 接入:让 AI 操作浏览器 / DB / Jira
  • Hooks:保存即审查、提交即测试
  • Subagent:分派"代码审查员 / API 设计师"
  • 交付物可以放心交给 Code Review

🎯 接下来 4 招,按 ROI 排序,第一招就是性价比最高的

01

CLAUDE.md · 项目级 AI 宪法

10 分钟写一份,省 100 次重复贴上下文。4 招中性价比最高的一招

🧠 它是什么

放在项目根目录的 Markdown 文件(Cursor 里叫 .cursor/rules/*AGENTS.md, Claude Code 里叫 CLAUDE.md)。
每次 AI 启动会话都会自动读它——相当于团队的"隐形协议"。

✦ 必写的 5 个块

  • Project:项目类型、业务一句话
  • Stack:技术栈、关键库版本
  • Conventions:命名、目录、错误处理
  • Don't:明确禁止的(如 any 类型 / console.log)
  • How to run:启动 / 测试 / 部署命令

📄 Lenovo 团队 CLAUDE.md 模板(节选)

# Project
Lenovo 内部 ABC 系统 - 设备管理后台。
用户:IT 运维 ~200 人。语言:中文。

# Stack
- Frontend: Vue 3.4 + Pinia + Element Plus 2.x
- Backend:  Node.js 20 + Fastify 4 + Prisma + PG 16
- 测试: Vitest + Playwright
- 部署: Lenovo 内部 K8s(namespace=abc-prod)

# Conventions
- TS strict 模式,禁止 any
- API 路径 /api/v1/{resource},全部蛇形
- 提交信息走 Conventional Commits
- 所有外部调用必须有 timeout + retry

# Don't
- 不要写 console.log,用 logger.info
- 不要直接拼 SQL,必走 Prisma
- 不要引新依赖前不问我

# How to run
- 启动: pnpm dev
- 测试: pnpm test
- 部署: make deploy ENV=staging
💎 团队最佳实践:把 CLAUDE.md 提交进 Git,让所有人和 AI 共享同一份"宪法"。 新人 onboarding 也比读 README 快 3 倍。
02

Cursor Rules · 全局 + 项目 双层规则

个人偏好放全局,团队约定走项目,不要混在一起

⚙️

全局规则 个人级

位置:Cursor → Settings → Rules for AI

写什么:

  • "用中文回答"
  • "代码注释保持精简,不要废话"
  • "未确认前不要写很长的代码"
  • "提交信息用 Conventional Commits"
📁

项目规则 团队级

位置:.cursor/rules/*.mdc(多文件,可按场景拆分)

写什么:

  • frontend.mdc:Vue 风格、ESLint 约定
  • api.mdc:REST 路径、错误码规范
  • db.mdc:表设计、迁移流程
  • review.mdc:交付前自检清单
# .cursor/rules/api.mdc
---
description: REST API 设计规范
globs: "backend/**/*.ts"
alwaysApply: true
---
- 所有 API 路径前缀 /api/v1
- 响应统一格式:{ code, data, message },code=0 表示成功
- 错误码遵循 Lenovo 内部约定,详见 @docs/error-codes.md
- 列表接口必须支持 page, pageSize,最大 pageSize=200
- 鉴权一律走 @middleware/auth.ts

💡 关键参数:globs 决定什么文件触发这条规则alwaysApply 决定是否强制注入。用 globs 给规则"分场景"是工程化的关键。

03

MCP · 给 AI 接上"真实世界"

不再"对着空气写代码",让 AI 真正动手做事

MCP(Model Context Protocol)是 Anthropic 提的开放协议—— 让 AI 通过统一接口去操作浏览器、读 DB、查 Jira、调内部 API

🌐

Browser MCP 必装

让 AI 自己开浏览器、点按钮、看截图、读 console。 前端 Bug 描述模糊?让 AI 自己看页面

🗄️

PostgreSQL MCP 推荐

让 AI 直接连开发库查 schema / 跑 SQL。 写新接口时,schema 一秒同步给它

📋

Jira / Confluence MCP Lenovo 适配

让 AI 读需求单、写 Confluence 文档。 "按这个 Story 写代码" 一句话搞定

// Cursor: ~/.cursor/mcp.json (或项目级 .cursor/mcp.json)
{
  "mcpServers": {
    "browser": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-browser"] },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "$DATABASE_URL"]
    }
  }
}

🔒 团队注意:连内部数据库的 MCP 一律只给只读账号 + 测试库,绝不要连生产

04

Hooks & Subagent · 自动化 + 分工

不用每次都打 Prompt,把流程固化成肌肉

🪝

Hooks · 工具调用前后触发

Claude 调用工具的前 / 后 / 收尾自动跑命令——PreToolUse 拦危险、PostToolUse 自动 lint、Stop 给 checklist。

// .claude/settings.json
{
  "hooks": {
    "PostToolUse": [{
      "matcher": {
        "tool_name": "Edit",
        "file_path_regex": "backend/.*\\.js$"
      },
      "command": "node --check $CLAUDE_FILE_PATH"
    }]
  }
}
🧬

Subagent · 子智能体

把任务派给"专门角色"——每个 Subagent 有独立的 Prompt + Rules。

  • code-reviewer:只做代码审查,挑刺更狠
  • api-designer:只做接口设计
  • test-writer:只补测试用例
  • doc-writer:只写中文 README / 注释
🎯 Lenovo 团队建议:先把 CLAUDE.md + Rules 用熟(招式 1-2), Hooks/Subagent 等团队有了协作痛点再上——不要为了用而用。

05实战 · Lenovo Vibe Stage 现场互动系统

我用 Vibe Coding 工程化的 4 招造的,完整前后端 + 数据库 + Docker。 现在你看到的开场抽人是"轻量版",这才是工程化版本

FRONTEND
Nginx + 单文件 PPT

11 页 PPT + 3 个 Modal(录入/抽人/承诺)

BACKEND
Node 20 + Express

REST API · 健康检查 · 优雅关闭

DATABASE
PostgreSQL 16

people · picks · commitments 三表

⚡ 一键启动

# 1. clone 仓库
git clone https://gitlab.xpaas.lenovo.com/zhangzl39/lenovo-vibe-stage.git
cd lenovo-vibe-stage

# 2. 一键启动(自动探测 LAN_IP + docker compose up -d)
./start.sh

# 3. 浏览器打开(一个 URL 全搞定)
http://本机IP:8080
# 右上 📝录入 / 🎯抽人 / 🤝承诺 弹窗
# 学员手机扫 P2/P11 二维码自动开

🎯 4 轮 Prompt 造出整个系统

  • R1 · 先写 CLAUDE.md(不写一行代码) — Stack / Conventions / Don't / How to run
  • R2 · 后端 + DB + Docker — 三表 ensureSchema · 7 个 endpoint · compose 编排
  • R3 · 单页 PPT + 三 Modal — 11 slide · enroll/pick/commit hash 路由 · CDN 引 qrcodejs + html2pdf
  • R4 · 收尾打磨 — 一键 PDF · @media print · 承诺墙 + 念 1 条

✦ 完整代码:gitlab.xpaas.lenovo.com/zhangzl39/lenovo-vibe-stage
✦ 工程化样板:CLAUDE.md · .cursor/rules/ · .claude/{settings.json,agents/}

065 条 Lenovo 团队工程化经验

!

① 不要把团队的"约定"塞个人 Rules

个人偏好(语言/语气)放全局;团队规范一定提交进 Git,新人拉代码就有。

!

② CLAUDE.md 不是写一次的

项目演进时同步更新。建议在 PR 模板里加:"本次是否需要更新 CLAUDE.md?"

!

③ MCP 一律给只读账号

连内部数据库 / Jira 时绝不要给写权限。AI 误操作的代价比 Bug 大得多。

!

④ AI 写的代码必须过 CR

别因为 "AI 写的"就放松审查。Reviewer 不是 AI 是你。挂你名字的代码你负责。

⑤ 最大的坑:不思考

AI 是放大器:你脑子糊涂它放大糊涂,你思路清晰它放大清晰。 "为什么这么做"永远留给自己
Lenovo 工程师的稀缺性,不在打字速度,在判断力

07回家学什么 · 性价比清单

系统课程(建议入手 1 门)

  • 《Claude Code 企业级全链路开发实战》本课基础 · 极客时间
  • 《MCP 协议从入门到实战》进阶 · 极客时间
  • 《AI 大模型应用开发实战》原理 · 极客时间
  • 性价比逻辑:系统化省时间,比刷 100 篇博客快 10 倍

🛠官方文档(最有信息密度)

  • cursor.com/docs · Rules / MCP 最新参数
  • docs.anthropic.com/claude-code · CLAUDE.md 规范
  • modelcontextprotocol.io · MCP 协议文档
  • github.com/modelcontextprotocol/servers · 官方 MCP 列表

🌐跟对人 / 看对内容

  • X:@karpathy @swyx @sama @amasad
  • GitHub:awesome-cursor / awesome-claude-code
  • 国内:B 站 "AI 编程实验室"、即刻 AI 编程圈
  • 公众号:歸藏宝玉的分享AI 进化论

🎯Lenovo 团队最值钱的事

  • 给我们项目各自写一份 CLAUDE.md,下周分享
  • 团队共建 .cursor/rules/,沉淀规范
  • 选 1-2 个内部 MCP 试点(建议 Jira)
  • 每月一次"AI 开发实践复盘会"

💎 公式:1 门系统课 + 每个项目 1 份 CLAUDE.md + 5 位高质量博主 = 30 天内团队 AI 编码能力跃升

收尾互动 · 公开承诺 + 1 周回访

不要"听完就忘"——给自己留一个钩子

Google re:Work 团队的研究:公开承诺能把"听完就忘"的概率降到 1/10。
现在花 60 秒,把"本周内要落地的 1 件事"写进承诺墙—— 下周同一时间,我会逐条回访。

扫码加载中…
SCAN · WRITE · COMMIT
扫这个码 → 30 秒写一句
动词开头、本周内、可验证
例:本周内给 Studio AI 写一份 CLAUDE.md 并提 PR
扫不到?讲师投影右上角 → 🤝 承诺
↑ 抽 1 个承诺当场念出来 ↑

AI 替代 Lenovo 工程师 = 放大 Lenovo 工程师

从 17:30 起,写 CLAUDE.md 是新的 git init。Happy Vibe Coding ✨

张展亮 · Lenovo 大前端 · Studio AI
欢迎私聊一起聊 Vibe Coding · itcode zhangzl39 · 微信/手机 17310568690