正规的团队协作，一般不是：

所有人直接改 main

也不是：

每次都 fork

Fork 更多是：

开源社区协作

或者：

外部贡献者

模式。

一、真正工作室 / 公司常见流程（核心）

正常团队：

是：

一个主仓库（origin）
↓
每个人本地 clone
↓
每个人创建自己的 branch
↓
提交 commit
↓
push branch
↓
发 Pull Request（PR）
↓
Code Review
↓
合并到 main

二、真正标准流程（你最该用的）

1️⃣ clone 主仓库

git clone https://github.com/your-org/your-project.git

2️⃣ 创建自己的功能分支

例如：

git checkout -b feat/reader-runtime

或者：

git checkout -b fix/book-feed

3️⃣ 本地修改

4️⃣ commit

git add .
git commit -m "feat(reader): add persistent runtime"

5️⃣ push 分支

git push origin feat/reader-runtime

6️⃣ 发 PR

GitHub 上：

Compare & Pull Request

7️⃣ Review

别人：

comment
review
request changes

8️⃣ merge

Squash and Merge

或者：

Rebase Merge

三、真正成熟团队：

很少直接 push main

因为：

main
=
生产线

四、Fork 是什么时候用（重点）

Fork：

一般用于：

开源项目

例如：

你给 React 提 PR

外部协作者

没有主仓库写权限。

五、你自己的工作室（推荐）

你们：

不要 fork。

直接：

GitHub Organization

然后：

成员 collaborator

六、真正适合你们的结构（推荐）

GitHub Organization

例如：

emptyinkpot-studio

下面：

MyBlog

Game Project

World Bible

Assets

Docs

七、真正成熟协作（重点）

一人一个 branch

例如：

feat/world-archive
feat/ui-refactor
fix/reader-runtime

八、为什么不能都改 main（重要）

因为：

会：

覆盖

冲突

Runtime 崩

无法回滚

九、真正成熟团队（重点）

一切：

都通过 PR

因为：

PR 不只是：

合并代码

还是：

👉 讨论空间

例如：

为什么这样改
架构是否合理
UI 是否统一

十、你现在特别需要（重要）

👉 branch discipline

因为：

你现在已经：

复杂系统

了。

十一、你现在最危险的行为（重点）

在 main 上直接改。

因为：

你现在：

runtime
manifest
mysql
openlist
reader
graph

已经：

高耦合。

十二、真正推荐你的 Git 规范（直接给你）

branch naming

feat/

新功能。

fix/

修 bug。

refactor/

重构。

chore/

杂项。

docs/

文档。

experiment/

实验功能。

十三、commit message（推荐）

例如：

feat(reader): add persistent runtime shell

fix(books): remove stale openlist path

refactor(runtime): split visual metadata layer

十四、真正成熟流程（重点）

不要：

想到什么直接改

要：

issue

branch

commit

PR

merge

十五、你现在最适合（非常推荐）

GitHub Projects

类似：

看板

例如：

Todo

In Progress

Review

Done

十六、真正成熟工作室：

不会：

聊天记录驱动开发

而是：

👉 Issue 驱动。

例如：

[Reader] Runtime persistence
[Books] Collection metadata layer
[Visual] Pinterest partition system

十七、你现在特别适合（重点）

monorepo

你现在其实已经：

很像：

TurboRepo
pnpm workspace

结构了。

十八、真正推荐你的结构（重要）

/apps
  /web
  /admin-next
 
/packages
  /ui
  /runtime
  /reader
  /graph
  /metadata
 
/tools

十九、真正成熟团队：

一定：

code review

因为：

review：

不是：

挑错

而是：

防止架构腐烂。

二十、你现在已经需要（重点）

👉 Architecture Governance

否则：

你这个项目：

很容易：

越做越乱

二十一、真正推荐你们现在立刻做的（非常重要）

1️⃣ 禁止直接 push main

2️⃣ 所有功能走 branch

3️⃣ 所有功能走 PR

4️⃣ main 只接受 merge

5️⃣ 建立 issue board

6️⃣ 写 architecture decision record（ADR）

二十二、ADR 是什么（很重要）

例如：

为什么 OpenList 不作为 runtime truth
为什么 Reader Runtime persistent
为什么 metadata 不再 overlay

二十三、你现在真正需要的（最终）

不是：

更多功能

而是：

👉 “工程秩序”

因为：

你已经不是：

单文件博客

了。

而是：

一个长期演化系统。

非本地开发。

能。

而且：

你这种项目以后最好尽量“去本地化”。

因为你已经不是：

单机开发

了。

你开始进入：

Distributed Runtime Development

阶段。

现在成熟方案有 4 种

一、GitHub Web IDE（最简单）

直接：

按：

（点号）

GitHub 会进入：

github.dev

本质：

网页版 VSCode

你可以：

改文件
搜索
提交 commit
多文件编辑

不需要 clone。

适合：

README
contracts
configs
小改动
markdown
prompt
json

不适合：

大型 refactor
node_modules
runtime build
本地调试

二、GitHub Codespaces（真正高级）

这是：

云端完整开发机。

本质：

GitHub 仓库
+
远程 Linux 容器
+
VSCode

你可以：

npm install
pnpm dev
astro build
terminal
git
node
docker

全部：

云端完成。

非常适合你。

因为：

你现在：

monorepo
runtime pipeline
AI agents
大仓库

已经开始：

不适合 Windows 本地了。

你现在最该用的其实是：

Codespaces。

三、OpenVSCode Server / code-server（极推荐）

你自己服务器部署：

浏览器 VSCode。

完整 VSCode。

优点（你会很适合）

1. 不需要 clone 到本地

直接：

服务器仓库
=
工作目录

2. AI 工具能共存

比如：

Claude Code
OpenCode
Continue
Copilot
Cursor-like 插件

3. Runtime 原地存在

比如：

vault
runtime
build cache
docker

全部：

原地。

4. 避免 Windows Git 地狱

你现在：

已经明显：

Windows
+
巨型 runtime
+
Git

开始炸了。

四、真正高级路线（你最终会这样）

Remote Workspace Runtime

也就是：

Server
=
Truth Runtime

你本地：

浏览器

只是：

terminal/surface。

你真正最终架构会像：

Operator Browser
↓
Remote VSCode Runtime
↓
AI Agents
↓
Workspace Runtime
↓
Git Repositories
↓
Build Pipelines

你现在真正最推荐路线

不要：

Windows
+
本地 clone
+
Git 大仓库

了。

正确：

服务器：

/home/projects/MyBlog

长期存在。

然后：

用：

code-server

或者：

OpenVSCode Server

浏览器直接开发。

五、真正高级玩法（你会很适合）

AI Agents 直接改服务器仓库

也就是：

Claude
Codex
Gemini

都：

直接操作远程 workspace。

而不是：

本地 clone
→ patch
→ push

六、真正关键

Git clone 应该：

极少发生。

正确：

长期 workspace

一直存在。

然后：

git pull
branch
worktree

七、你现在真正应该用：

Git Worktree

而不是：

clone 一堆副本。

比如：

git worktree add ../MyBlog-feature-x feature/x

这样：

不重复 objects
不重复 history
不重复 runtime

八、真正适合你的最终架构

Server Workspace
├── MyBlog
├── mortis
├── runtime
├── vault
├── agents
└── worktrees/

浏览器：

VSCode Web

连接。

九、真正高级高见

你现在：

最大问题已经不是：

怎么开发

而是：

“workspace topology”

你最终：

一定会变成：

Persistent Remote AI Workspace

而不是：

“本地电脑项目”。

十、最后真正建议（非常重要）

你现在：

最推荐：

code-server

Git worktree

server-side runtime

别再：

Windows 本地 clone 大仓库

了。

你现在项目规模：

已经开始超过这种模式的舒适区了。