docs(ai): 新增 Claude Code 工作流总结并统一目录结构

This commit is contained in:
liumangmang
2026-03-11 19:53:26 +08:00
parent e0941914e3
commit dfcbc51391
6 changed files with 249 additions and 13 deletions

View File

@@ -247,9 +247,50 @@ export default sidebar({
},
],
},
"chatgpt.md",
"openclaw.md",
"iflow.md",
{
text: "Claude Code",
icon: "mdi:source-branch",
collapsible: true,
children: [
{
text: "多分支工作流实战总结2026",
link: "claude-code-branch-workflow-2026.md",
},
],
},
{
text: "ChatGPT",
icon: "mdi:chat-processing-outline",
collapsible: true,
children: [
{
text: "chatgpt-使用记录与实践",
link: "chatgpt.md",
},
],
},
{
text: "OpenClaw",
icon: "mdi:robot-outline",
collapsible: true,
children: [
{
text: "openclaw-24h在线部署实战",
link: "openclaw.md",
},
],
},
{
text: "iFlow",
icon: "mdi:sitemap-outline",
collapsible: true,
children: [
{
text: "iflow-流程编排实践记录",
link: "iflow.md",
},
],
},
],
"/": false,
});

View File

@@ -15,7 +15,9 @@ tag:
<!-- more -->
- OpenCode
- ChatGPT
- OpenClaw
- iFlow
- OpenCode CLI 实战指南
- OpenCode TUI 实战指南
- Claude Code 多分支工作流实战总结2026
- ChatGPT 使用记录与实践
- OpenClaw 个人 24 小时在线部署实战
- iFlow 流程编排实践记录

View File

@@ -1,5 +1,5 @@
---
title: ChatGPT
title: ChatGPT 使用记录与实践
icon: mdi:chat-processing-outline
date: 2026-03-06
category:
@@ -8,7 +8,7 @@ tag:
- ChatGPT
---
# ChatGPT
# ChatGPT 使用记录与实践
ChatGPT 使用记录与实践。

View File

@@ -0,0 +1,193 @@
---
title: Claude Code 多分支工作流实战总结2026
icon: mdi:source-branch
date: 2026-03-11
category:
- AI
- 开发工具
tag:
- ClaudeCode
- Git
- Worktree
- AI编程
- 工作流
---
# Claude Code 多分支工作流实战总结2026
这篇是对一篇 Claude Code 工作流文章的中文实战整理版。
核心结论很直接:不要在一个分支里让 AI 连续改代码,要用“任务隔离 +
并行执行 + 人工验收”的方式把效率和可控性同时拉起来。
<!-- more -->
---
## 一、为什么单分支跑 AI 容易翻车
文章先指出了一个常见误区:在 `main`(或同一个功能分支)里持续让 AI
修改,短期快,后期很容易失控。
典型问题有 3 个:
1. 上下文污染:修 A 时顺手改了 B/Cdiff 越滚越大。
2. 任务串行:只能一个任务一个任务排队,浪费 AI 并行能力。
3. 协作困难:主分支被污染后,团队很难判断哪些改动可合并、可回滚。
一句话:单分支的主要代价不是慢,而是不可控。
---
## 二、核心原则:一个任务,一个分支
更稳的做法是把每个任务放到独立分支,让 AI 在隔离环境工作。
```bash
# 不建议:直接在 main 上跑
git checkout main
claude
# 建议:每个任务独立分支
git checkout -b claude/fix-login-bug
claude
```
建议统一前缀,方便识别 AI 分支:
- `claude/feat-xxx`
- `claude/fix-xxx`
- `claude/refactor-xxx`
- `claude/exp-xxx`
这样在 PR 列表里,一眼就能区分 AI 产出的变更。
---
## 三、进一步提速:用 git worktree 做并行
如果你一次要推进多个任务,`git worktree` 是关键工具:
同一仓库开多个工作目录,每个目录绑定一个分支,多个 Claude 实例并行跑。
```bash
git worktree add ../myproj-feature-a claude/feature-a
git worktree add ../myproj-feature-b claude/feature-b
git worktree add ../myproj-fix-c claude/fix-c
```
然后在不同终端分别运行 Claude
```bash
# 终端 1
cd ../myproj-feature-a && claude
# 终端 2
cd ../myproj-feature-b && claude
# 终端 3
cd ../myproj-fix-c && claude
```
你负责统筹和验收AI 负责并行执行。
---
## 四、上下文管理:给 AI 刚刚好的信息
文章给了 3 个高频技巧,实用性很强。
### 1`CLAUDE.md` 保持精简
别写成项目百科,重点写“当前任务约束 + 必须遵守的架构规则”。
推荐结构:
- 可改范围(哪些目录能动)
- 禁改范围(哪些目录不能动)
- 验收标准(测试、风格、安全约束)
- 架构红线(必须走哪一层、禁止直连什么)
### 2用 `/compact` 控制会话长度
长对话容易导致注意力发散,子任务完成后执行一次压缩更稳。
```text
/compact
```
如果模型明显跑偏,可考虑清空后重给最小上下文再继续。
### 3用 `--resume` 续接中断任务
```bash
claude --resume
```
第二天可直接接续昨天上下文,减少重复沟通成本。
---
## 五、可复用的 5 步工作流模板
### Step 1先建分支再开始任务
```bash
git checkout -b claude/JIRA-1234-user-profile-api
```
### Step 2先让 AI 给实施计划,再执行
先对齐“目标、边界、参考实现、验收条件”,避免直接开改导致返工。
### Step 3并行执行人工做 Code Review
```bash
git diff main
```
重点看:
- 是否改了不该改的文件
- 逻辑是否符合需求
- 是否引入安全或稳定性风险
### Step 4测试通过后再合并
```bash
npm test
# 或项目实际测试命令
```
### Step 5任务结束及时清理
```bash
git worktree remove ../myproj-feature-a
git branch -d claude/JIRA-1234-user-profile-api
```
---
## 六、团队落地建议(可直接抄)
1. 统一 AI 分支命名规范。
2. 给 AI 分支单独准备 PR 模板。
3. 在仓库维护共享 `CLAUDE.md`,降低团队上手成本。
4. 把“人工 Review + 测试通过”设为合并前置条件。
---
## 七、总结
这套方法本质上是在做一件事:
把“AI 的执行力”和“人的决策权”拆开。
- AI 负责生成和修改
- 你负责边界、评审、验收和最终合并
如果你现在还在一个分支里连续跑 Claude Code最先该改的不是提示词
而是 Git 工作流。
---
## 参考
- 原文https://blog.ccino.org/p/claude-code-branch-workflow-secrets-2026/

View File

@@ -1,5 +1,5 @@
---
title: iFlow
title: iFlow 流程编排实践记录
icon: mdi:sitemap-outline
date: 2026-03-06
category:
@@ -8,7 +8,7 @@ tag:
- iFlow
---
# iFlow
# iFlow 流程编排实践记录
iFlow 使用记录与实践。

View File

@@ -1,5 +1,5 @@
---
title: OpenCode
title: OpenCode CLI 实战指南
icon: mdi:application-braces-outline
date: 2026-03-06
category:
@@ -11,7 +11,7 @@ tag:
- AI编程
---
# OpenCode
# OpenCode CLI 实战指南
这篇文章基于 OpenCode 官方文档的 CLI 章节,整理出一套更偏实战的
使用方式:先跑起来,再把它接入日常开发流程。