Git 版本控制与跨平台协作
10.10 Skills团队知识共享
Tip
团队最大的资产不是代码，而是那群写代码的人脑子里的东西。但这些东西最容易丢。
1. 为什么要学这个?
软件工程里有一个概念叫 "公交车指数" (Bus Factor)： 如果你的团队里有几个人被公交车撞了（或者中了彩票辞职了），项目就会瘫痪？ 很多团队的指数是 1。 核心大佬掌握着所有潜规则：数据库为什么这么设计、部署脚本为什么有一行奇怪的 sleep... 一旦他离开，留下的就是一堆没人敢动的"屎山"。
我们要做的，是把脑子里的知识，变成仓库里的文件。
2. 核心概念：Config as Code (规则即代码)
传统的文档
Wiki / Notion / Word。 缺点：
- 脱节：代码改了，文档没改。
- 难找：新员工根本不知道去哪翻。
AI 时代的文档 (.cursorrules)
把规则写在 AI 能读到的地方。 当新员工让 AI "生成订单表" 时，AI 会自动读取规则："哦，团队规定金额字段必须用 Int 类型"。 文档不再是死的，它变成了生产力的一部分。
3. 解决方案 (HOW)
1. 建立 .cursorrules 文件
在项目根目录创建 .cursorrules。这是给 AI 看的"团队家规"。
# 数据库规范
- 任何金额字段必须使用 Int 类型，单位为分。
- 禁止使用 Float/Double 存储金额。
# 命名规范
- React 组件必须使用 PascalCase (如 UserCard)。
- 辅助函数必须使用 camelCase (如 formatDate)。
# 最佳实践
- 使用 Tailwind CSS 而不是 CSS Modules。
- 只有在必要时才使用 UseEffect。
2. 同步到 Git
这个文件和代码一样，必须提交到 Git 仓库。
git add .cursorrules
git commit -m "docs: add team coding rules"
git push
这样，任何拉取这个项目的人（以及他们的 AI），都会立刻获得这份"团队记忆"。
知识流转图
graph TD
Expert["资深员工"] --"沉淀经验"--> RuleFile[".cursorrules"]
RuleFile --"git push"--> Repo["代码仓库"]
Newbie["新员工"] --"git pull"--> LocalRule[".cursorrules"]
LocalRule --"加载上下文"--> AI["AI 助手"]
AI --"自动遵循规则"--> Code["符合规范的代码"]
style RuleFile fill:#fff9c4,stroke:#fbc02d
style AI fill:#e1bee7,stroke:#8e24aa
4. 真实案例
Story
那个消失的"隐形富豪"
硅谷某初创公司，有一位传奇工程师 Bob。所有最复杂的部署脚本都是他写的。 有一天，Bob 真的中了乐透大奖，当天就辞职去环游世界了，并且断了联系。 一周后，服务器证书过期。 整个团队没人知道怎么更新证书，因为 Bob 写死在了某个只有他知道路径的脚本里。 公司业务中断了 48 小时，最后不得不重构整个部署流程。
Vibe 心法：
知识共享不仅是美德，更是生存技能。
不要让自己成为团队的单点故障 (Single Point of Failure)。
最好的代码是，即使你今天离职，明天来的新人也能照着 .cursorrules 无缝接手。
5. 本章小结
- 显性化：把脑子里的知识，变成 Git 里的文件。
- 自动化：让 AI 成为规则的执行者，而不是让 Tech Lead 每天去吼。
- 同步：代码流转的地方，就是知识流转的地方。