2.2 VibeCoding 规范

阅读完本节后，你将会收获：

掌握 VibeCoding 标准五步工作规范：探索 → 规划 → 执行 → 验证 → 提交
理解 Agent Native 开发思维，学会从”怎么做”转向”做什么”的产品导向思维
学会编写高质量提示词：直接描述任务、提供上下文、给出具体约束
掌握权限模式、斜杠命令、检查点功能等 Claude Code 核心交互方式
了解多 Agent 并行协作机制，学会利用 AI 自动化能力提升开发效率

序言中提到的”Spec（开发规范）“是 Vibecoding 的核心，以及 VibeCoding 的标准开发流程。

Agent Native = 以 AI Agent 为中心的开发思维

传统开发中，AI 是辅助工具（Copilot）；Agent Native 中，AI 是自主执行者（Autopilot）。

传统思维 vs Agent Native********************

维度	传统 AI 辅助开发	Agent Native 开发
核心角色	人写代码，AI 帮忙	AI 为主，代码是 AI 的实现细节
工作方式	AI 是 Copilot	AI 是 Autopilot
交互模式	人写 Prompt 指挥 AI	AI 主动提问、规划、执行
输出形态	AI 生成代码片段，人来整合	AI 自主完成完整任务
你的关注点	怎么写代码	写什么产品

Agent Native 的三大原则

1. 意图驱动

告诉 AI 目标，让它自己决定实现方式：bash

❌ 传统思维：
"帮我写一个函数，接收数组参数，用 for 循环遍历，
遇到大于 10 的就 push 到新数组里..."

✅ Agent Native：
"过滤数组中大于 10 的元素，返回新数组"

2. 异步协作

AI 可以在你睡觉时工作：bash

# 你设定目标，AI 自主执行
"实现用户评论功能，包括：
1. 数据库 schema（Comment 模型）
2. CRUD API
3. 前端评论表单
4. 评论列表展示

完成后告诉我，我先去忙别的。"

3. 信任但验证

不要逐行检查 AI 的代码，而是：

验证方式：

功能测试：跑一下看看能不能用
类型检查：tsc 有没有报错
代码审查：只看关键逻辑，不看实现细节

从开发者到编排者

Agent Native 时代，你的角色转变：

传统开发者	Agent Native 编排者
手写代码	描述需求
逐个修复	反馈问题
关注语法	关注产品
是工匠	是指挥官

记住：代码是实现细节，产品才是目的。Agent Native 让你从”怎么做”中解放出来，专注于”做什么”。

:::

核心概念

Vibecoding 的核心理念

Vibecoding = CodingAgent（Coding智能体） + Skills（技能）+ Tools（工具）+ ...

CodingAgent 综合信息，制定计划，执行，检查****Skills 提供具体任务的方法、步骤、数据、标准

提示词的核心原则

AI 是一个强大的编程助手，它理解技术术语、熟悉各种框架、能快速分析代码。

沟通的关键是：直接、具体、有上下文。

❌ 绕弯子：

"你是一位资深的全栈工程师，精通各种技术栈..."

→ AI 不需要角色扮演，它知道自己能做什么

✅ 直接说事：

"检测这个 React 组件的类型安全问题"

→ 一句话讲清楚要做什么

❌ 模糊描述：

"帮我优化一下代码"

→ AI 不知道优化什么方向

✅ 具体需求：

"优化登录页面的加载性能：
1. 添加图片懒加载
2. 延迟加载非关键资源
3. 使用 Next.js 的动态导入"

→ 明确优化目标和实现方式

提示词原则

好提示词的特征

提示词对比：欠佳 vs 推荐****************************

类型	欠佳	推荐
角色扮演	”你是一位拥有 20 年经验的全栈工程师，精通 React、Vue、Angular、Node.js、Python…”	直接说任务：“实现用户登录功能”
模糊指令	”帮我优化一下代码"	"优化登录页面的加载性能：添加图片懒加载、延迟加载非关键资源”
无边界限制	”写一个完整的电商系统"	"实现用户评论功能，包括：评论表单、列表展示、数据持久化”
强行要求	”你必须给出正确答案，不能说不知道"	"如果不确定，请明确说’我不确定’，而不是编造答案”
具体任务	”帮我写一个登录功能"	"实现用户登录功能：用户名+密码登录，使用 Next.js 16 App Router，Drizzle ORM + PostgreSQL，包含表单验证和错误处理”
提供上下文	”修复这个 Bug"	"修复 Bug：文件 app/login/page.tsx，问题：用户登录后没有跳转到首页，预期：跳转到 /dashboard”
指令要具体	”添加测试"	"为 app/login/page.tsx 编写测试用例，框架：Playwright，覆盖场景：密码错误、账号不存在、网络错误”

核心原则：

不要让 AI 猜 → 提供明确上下文
不要含糊其辞 → 给出具体要求
不要强行编造 → 给 AI 一个”不确定”的出口

让 AI 反复提问

"我要开发一个任务管理应用。
请反复问我问题，直到你完全理解我的需求。
不要猜测，直接问。"

提示词模板

代码生成模板

"实现 [功能名称]

技术栈：
- Next.js [版本]
- TypeScript
- Drizzle ORM
- [其他技术]

需求：
1. [具体需求1]
2. [具体需求2]
3. [具体需求3]

注意事项：
- 遵循项目现有代码风格
- 不要引入新依赖，除非必要
- 包含错误处理"

Bug 修复模板

"修复 Bug

文件路径: [完整路径]
错误信息:
[完整报错日志]

当前代码:
[相关代码片段]

期望行为: [描述]
实际行为: [描述]

请分析原因并提供修复方案"

标准工作流

AI 的自动化能力

在开始工作流之前，记住：AI 能自动处理很多任务。

Claude Code vs 其他 AI 工具

关键区别：********************

特性	Claude Code	Cursor/Windsurf	ChatGPT 网页版
项目上下文	✅ 自动读取整个项目	✅ 自动读取	❌ 手动粘贴
命令执行	✅ 直接运行 bash	✅ 集成终端	❌ 复制到终端
文件修改	✅ 自动编辑多个文件	✅ 多文件编辑	⚠️ 逐个复制
版本控制	✅ 自动提交	✅ Git 集成	❌ 手动操作
工作流	✅ 标准化流程	⚠️ 需要手动	❌ 随意对话

为什么 Claude Code 更适合 Vibecoding：

CLI 原生：命令行是开发者的原生环境
自动化程度高：减少手动操作
标准化流程：探索 → 规划 → 实现 → 验证 → 提交
完整上下文：理解整个项目结构

AI 的自动化能力：

✅ 自动探索项目结构（你不需要告诉它看哪些文件）
✅ 自动选择合适的工具（Read、Edit、Bash）
✅ 自动处理错误（失败会重试或换方案）
✅ 自动生成提交信息（根据修改内容）
✅ 自动识别依赖关系（知道修改会影响哪些文件）

你需要做的：

清楚描述任务目标
提供必要的上下文
验证结果并反馈

不需要做：

❌ 指定具体步骤（“先读文件A，再读文件B”）
❌ 告诉它用哪个工具（“用 Read 工具读取”）
❌ 手动组合命令（“运行 git add 然后 git commit”）
❌ 手动处理错误（“如果失败就重试”）

权限模式

什么是权限模式

权限模式控制 AI 执行操作前是否需要你确认，平衡效率与安全。

三种权限模式************

模式	快捷键	特点	适用场景
Default	Shift+Tab 循环切换	自动批准安全操作，询问危险操作	日常开发（推荐）
Plan	Shift+Tab	仅允许读取操作	代码审查、探索
Accept Edits	Shift+Tab	编辑操作需确认，其他自动	高度信任的编辑场景

Default 模式（推荐）

只读操作（读取文件、搜索代码、查看状态、列出文件）自动批准，修改操作（编辑文件、删除文件、运行命令、网络请求、Git push）需要确认。

权限弹窗选项：

Yes：同意本次操作
Yes, don’t ask again for this tool：同意本次，且后续同类操作不再询问
No, and tell AI what to do differently：拒绝并告诉 AI 换个方式

Plan 模式（代码审查）

仅允许只读操作，所有修改操作都会被阻止。

适用场景：

代码审查
了解代码库结构
探索性分析

Accept Edits 模式（高效编辑）

编辑操作需要确认，其他操作自动批准。bash

# 示例行为
"读取配置文件"
"运行测试"
# AI 直接执行（非编辑操作）

"修改函数签名"
"删除这个文件"
# AI 会询问（编辑操作需确认）

适用场景：

需要频繁运行命令/测试
对文件修改要谨慎
高度信任的自动化工作流

模式切换

快捷键

Shift+Tab # 在三种模式间循环切换

常用交互命令

在 Claude Code 中，以 / 开头的命令称为斜杠命令，用于快速执行特定操作：************************************************

命令	功能	使用场景
/clear	清空对话上下文	开始新任务时
/model	切换 AI 模型	需要更强能力时切换到 Opus
/status	查看使用额度和计费	检查剩余额度
/config	打开配置界面	修改设置
/resume	恢复最近的会话	重启后继续之前的工作
/rewind	恢复到上一个检查点	代码改错需要回退
/agents	管理 Agent	创建/查看自定义 Agent
/init	生成 CLAUDE.md 模板	新项目快速配置
/compact	压缩对话上下文	上下文太多时精简
/export	导出对话记录	分享或保存对话
/statusline	自定义状态栏显示	隐藏/显示状态信息
/vim	启用 Vim 键绑定	熟悉 Vim 的用户

常用场景：bash

# 开新任务时清空上下文
/clear

# 查看剩余额度
/status

# 切换到更强模型
/model opus

# 恢复到之前的状态
/rewind

CLI 命令与启动选项基本命令（必读）``````“

命令	描述	示例
claude	启动交互式 REPL	claude
claude “query”	使用初始提示启动 REPL	claude “解释这个项目”
claude -p “query”	查询后退出（无头模式）	claude -p “检查代码类型错误”
claude -c	继续上一次对话	claude -c
claude -r “id”	恢复指定会话	claude -r “abc123”
claude —continue	加载最近的对话	claude —continue
claude —resume	显示会话选择器	claude —resume

常用启动选项****************

选项	功能	示例
-p “query”	执行查询后退出	claude -p “运行测试”
—model	指定模型	claude —model opus
—permission-mode	设置权限模式	claude —permission-mode plan
—add-dir	添加工作目录	claude —add-dir ../shared

快捷键与输入控制（必读）****************************

快捷键	功能	上下文
Ctrl+C	取消当前输入或生成	标准中断
Ctrl+D	退出会话	EOF 信号
Ctrl+L	清除终端屏幕	保留对话历史
Ctrl+R	反向搜索命令历史	搜索以前的命令
Esc+Esc	回退代码/对话	恢复到之前状态
Tab	切换扩展思考	开启/关闭思考模式
Shift+Tab	切换权限模式	循环切换权限模式

多行输入方法：************

快捷键	上下文
\ + Enter	适用于所有终端
Option+Enter (macOS)	macOS 默认设置
Shift+Enter	配置后可用

快速命令前缀：********

前缀	功能	示例
#	内存快捷方式，添加到 CLAUDE.md	# 添加项目上下文
/	斜杠命令	/clear
!	Bash 模式，直接运行命令	! npm test
@	文件路径引用	@src/app/page.tsx

进阶：高级 CLI 标志

完整 CLI 标志列表：````````````````````````````````````````````````

标志	描述	示例
—add-dir	添加额外工作目录	claude —add-dir ../apps
—agents	JSON 格式定义 Agent	claude —agents ’{…}’
—allowedTools	允许的工具列表	claude —allowedTools “Read,Bash”
—disallowedTools	禁止的工具列表	claude —disallowedTools “Edit”
—system-prompt	替换整个系统提示	claude —system-prompt ”…”
—system-prompt-file	从文件加载系统提示	claude -p —system-prompt-file ./prompt.txt
—append-system-prompt	附加到默认提示	claude —append-system-prompt ”…”
—output-format	输出格式（text/json/stream-json）	claude -p —output-format json
—input-format	输入格式（text/stream-json）	claude -p —input-format stream-json
—verbose	启用详细日志	claude —verbose
—max-turns	限制轮数	claude -p —max-turns 3
—dangerously-skip-permissions	跳过权限提示	claude —dangerously-skip-permissions

系统提示标志区别：****“

标志	行为	模式	用例
—system-prompt	替换整个默认提示	交互 + 打印	完全控制行为
—system-prompt-file	替换为文件内容	仅打印	从文件加载
—append-system-prompt	附加到默认提示	交互 + 打印	添加特定指令

进阶：Vim 模式

使用 /vim 启用或通过 /config 永久配置。

模式切换：````````

命令	操作	来自模式
Esc	进入 NORMAL 模式	INSERT
i	在光标前插入	NORMAL
a	在光标后插入	NORMAL
o	在下方打开行	NORMAL

导航（NORMAL 模式）：``````````

命令	操作
h/j/k/l	左/下/上/右移动
w	下一个单词
b	上一个单词
0/$	行首/行尾
gg/G	输入开始/结束

进阶：后台 Bash 命令

后台运行的工作原理：

异步运行命令，立即返回任务 ID
输出被缓冲，可用 BashOutput 工具检索
Claude Code 退出时自动清理

常见后台命令：

构建工具（webpack, vite, make）
包管理器（npm, yarn, pnpm）
测试运行器（jest, pytest）
开发服务器

按 Ctrl+B 将常规 Bash 调用移到后台。

Bash 模式（! 前缀）：bash

! npm test
! git status
! ls -la

将命令和输出添加到对话上下文
显示实时进度
支持 Ctrl+B 后台运行进阶：Agent 配置格式

--agents 标志接受 JSON（通常不需要手动使用，/agents 命令会自动处理）：bash

claude --agents '{
  "code-reviewer": {
    "description": "Expert code reviewer",
    "prompt": "You are a senior code reviewer",
    "tools": ["Read", "Grep", "Glob", "Bash"],
    "model": "sonnet"
  }
}'

必需字段：

description：何时调用（自然语言）
prompt：系统提示

可选字段：

tools：可用工具数组
model：模型别名（sonnet/opus/haiku）

五步工作流

工作流是建议而非强制

VibeCoding 五步工作流是一个推荐的实践模式，适合大多数开发场景。但你可以根据实际情况灵活调整：

✅ 推荐遵循：复杂功能、不熟悉的项目、团队协作
🔄 可以简化：简单修改、熟悉的项目、个人开发
⚡ 可以跳过：微小改动、明显的问题修复

核心原则：理解每步的目的后，根据实际情况灵活应用，而非机械执行。

1. 探索项目结构

目的：了解现有代码组织，避免重复工作bash

# 让 AI 探索项目
"探索这个项目的结构，告诉我:
1. 使用的技术栈
2. 文件组织方式
3. 现有的功能模块
4. 配置文件的作用"

输出示例:

项目使用 Next.js 16 + TypeScript + Drizzle
- app/: 页面和 API
- components/: 可复用组件
- src/db/: 数据库模型

2. 规划实现步骤

目的: 先想清楚再动手，减少返工bash

"我要添加用户评论功能。
请规划实现步骤，包括:
1. 需要创建哪些文件
2. 需要修改哪些现有文件
3. 数据库 schema 变更
4. 实现顺序"

输出示例:

步骤:
1. 更新 Drizzle schema (添加 Comment 模型)
2. 运行 npx drizzle-kit push
3. 创建 API route (app/api/comments/route.ts)
4. 创建评论组件 (components/CommentForm.tsx)
5. 集成到详情页

3. 编写代码

目的：按计划实现功能

AI 的自动拆分能力：

复杂任务会被自动拆解：bash

# 你只需要说
"实现用户评论功能"

# AI 会自动拆分为：
1. 更新 Drizzle schema
2. 运行数据库迁移
3. 创建 API 端点
4. 编写前端组件
5. 集成到页面
6. 测试验证

你不需要手动指定每个步骤，AI 会：

识别任务依赖关系
确定执行顺序
并行处理独立部分
验证每个步骤的结果

当然，你也可以分步执行：bash

"按照步骤 1，更新 Drizzle schema"

bash

"按照步骤 2，生成并运行迁移"

bash

"按照步骤 3，创建评论 API"

4. 测试验证

目的：确保功能正常bash

"测试评论功能:
1. 验证 API 能正常创建评论
2. 验证评论能正确显示
3. 验证错误处理"

5. 提交代码

目的: 建立版本记录bash

"评论功能开发完成，提交代码"

让 AI 自动维护 Git 记录

AI 开发非常激进，可能为了修一个 Bug 而破坏旧功能。因此需要高频的版本记录来保护成果。

在项目规则或 CLAUDE.md 中添加这条指令:

“每当你完成一个独立功能的开发，或修复完一个 Bug 并验证通过后，请自动运行 git commit 提交代码，并生成一句简洁的中文 commit message。”

从此，开发流程变成:

AI 写完登录功能 -> 自动存档
AI 写完首页 -> 自动存档
AI 搞崩了代码 -> 随时回退到上一个版本

为什么需要自动提交:

AI 可能为了修复一个问题而破坏三个旧功能
没有版本控制，错误的修改可能导致之前的成果无法恢复
你不需要记住每次手动提交，AI 会自动处理

6. 检查点功能

目的: 自动跟踪文件修改，支持快速回退

Claude Code 自动跟踪文件修改，支持快速回退。

自动创建: 每次发送提示时自动创建检查点，无需手动保存

回退方法: 按 Esc+Esc 或运行 /rewind，选择：

仅对话：回退用户消息，保留代码更改
仅代码：恢复文件更改，保留对话
代码和对话：两者都恢复进阶：检查点工作原理

自动跟踪：

每个用户提示创建新检查点
检查点在会话间持久存在
30 天后自动清理（可配置）

限制：

Bash 命令更改（rm、mv、cp）无法回退
外部编辑无法回退
检查点用于快速恢复，Git 用于永久历史

理解 Agent

什么是 Agent

Agent = AI 本身

AI 本身就是一个 Agent，它的工作是：

理解你的意图和需求
做决策（用什么工具、先做什么后做什么）
协调各种工具完成任务

可以把 Agent 理解为一个任务执行器：

接收你的指令（提示词）
调用各种工具完成任务
返回执行结果

与普通 AI 对话的区别：

普通 AI 对话	Agent
只能聊天	能调用工具
被动回答	主动决策
单轮交互	持续执行

什么是自定义 Agent

自定义 Agent = 你创建的专门 Agent

自定义 Agent 是主 Agent 可以调用的”专门助手”。每个自定义 Agent：

有特定的用途和专业领域
有独立的上下文窗口（不污染主对话）
有自定义的系统提示（专门训练）
可以限制工具访问权限

使用自定义 Agent 的优势：****************

优势	说明
上下文保留	主对话保持简洁，自定义 Agent 独立处理复杂任务
专业分工	针对特定任务优化（如代码审查、调试）
并行处理	多个 Agent 可同时工作，提高效率
灵活权限	可限制 Agent 只能用特定工具，提高安全性

Agent 类型：************

类型	说明	示例
官方内置	系统自带，自动调用	Plan（计划模式专用）
用户自定义	你创建的专门 Agent	code-reviewer、debugger
通用 Agent	Task 工具调用的通用 Agent	general-purpose、Explore

官方内置 Agent：Plan

Plan Agent 是 Claude Code 自带的专门 Agent，专门用于计划模式：

模型：使用 Sonnet 进行更强大的分析
工具：Read、Glob、Grep、Bash（代码库探索）
目的：搜索文件、分析代码结构、收集上下文
自动调用：在计划模式中研究代码库时自动使用

工作原理：

你：[在计划模式] 帮我重构认证模块
我：让我先研究一下你的认证实现...
[内部调用 Plan Agent 探索认证相关文件]
[Plan Agent 搜索代码库并返回发现]
我：基于研究，这是我的建议方案...

创建自定义 Agent

使用 /agents 命令创建你自己的自定义 Agent。

第0步：在 Claude 内输入 /agents 回车

第一步：选择创建方式 (Creation Method)

这里决定了 Agent 的”大脑”（系统提示词）是如何生成的。********

选项	含义	适用场景
Generate with Claude	让 Claude 帮你生成	90% 的情况推荐。用自然语言描述需求，Claude 自动转化为专业 Prompt
Manual configuration	手动配置	高级用户。已有写好的 Prompt，或需要精确控制每个字符

快捷方式：直接对话修改

创建 Agent 后，你可以直接在对话中用 @agent名字 来修改或者使用它：bash

# 直接告诉 AI 你的需求
"@code-reviewer 以后检查代码时，特别关注安全性问题"

@翻译agent 把这段翻译成英文，但保持技术术语不变

AI 会自动更新 Agent 的配置，无需手动编辑配置文件。

完整流程（第二步至最后一步）

第二步：选择底层模型 (Select Model)

这里决定了 Agent 运行时的”智商”、速度和成本。****************

选项	说明
Sonnet	平衡性能和速度
Opus	最强能力，成本较高
Haiku	最快速度，简单任务
Inherit from parent	继承父级模型，跟随主对话切换

第三步：选择工具权限 (Select Tools)

这里决定了 Agent 能干什么（安全管控的关键）。********************

选项	权限	适用场景
All tools	全权授权	需要完整能力的 Agent
Read-only tools	只读权限	代码审查、文档分析
Edit tools	编辑权限	修改代码、创建文件
Execution tools	执行权限	运行终端命令（风险最高）
MCP tools	外部工具	调用 MCP 服务器连接的服务

第四步：选择存储位置 (Choose Location)

这里决定了 Agent 在哪里可以被看见和使用。********

选项	含义	适用场景
Project (.claude/agents/)	项目级私有	专门为当前项目服务的 Agent
Personal (~/.claude/agents/)	用户级全局	通用工具（翻译、发邮件等），随处可用

第五步：选择背景颜色 (Choose background color)

纯视觉设置，用于在终端里区分不同的 Agent。建议按功能分类：

红色：危险操作（删除文件）
蓝色：辅助查询
粉色/紫色：创意写作

最后一步：确认并保存 (Confirm and save)````````

按键	操作
s 或 Enter	保存并创建
e	保存后立刻进入编辑器（微调 Prompt）
Esc	放弃创建

多 Agent 并行协作

什么是多 Agent 协作

Claude Code 会自动启用多 Agent来并行处理独立任务，每个 Agent 有独立的上下文窗口，专注完成特定工作。

两种方式：

自动并行：我识别到独立任务，自动创建通用 Agent 并行处理
专门协作：调用你创建的自定义 Agent（如 code-reviewer）

自动启用

Claude Code 根据任务描述主动委派任务，使用 Task 工具创建通用 Agent 并行处理：

任务描述中的关键词：“并行”、“同时”、“多 Agent”
自定义 Agent 配置中的 description 字段
当前上下文和可用工具

Task 工具

当 Claude Code 识别到独立任务时，会自动使用 Task 工具创建通用 Agent 来并行处理。

通用 Agent vs 自定义 Agent：********“

类型	调用方式	用途
通用 Agent	Task 工具自动创建	通用任务（探索、搜索、读取文件）
自定义 Agent	/agents 命令创建	特定领域（代码审查、调试、测试）

特点：

处理大量文件读取和搜索时更高效
多个通用 Agent 可以并行工作，加快速度
不需要预先配置，Claude 自动创建

多个并行 Agent************

关键词	效果
”并行”	同时执行多个独立任务
”同时”	多个 Agent 一起工作
”多 Agent”	明确使用多个 Agent 协作

并行能力说明

Claude 的并行能力：

在单个响应中，Claude 最多可以并行调用 5-10 个独立工具/子代理。

这意味着如果你有多个独立的任务（比如同时读取多个文件、执行多个独立的搜索等），Claude 可以在一条消息里一次性发出所有请求，大大提高效率。

举例 1：并行调研多个技术文档

任务：了解 Prisma、Drizzle、Supabase 三种数据持久化方案

串行方式：
读 Prisma 文档 → 等待 → 读 Drizzle 文档 → 等待 → 读 Supabase 文档 → 等待 → 总结对比

并行方式：
1 个消息 → 同时发起 3 个文档调研请求 → 收集所有信息 → 生成对比报告

举例 2：并行编写多个相关组件

任务：开发用户设置页面的多个功能模块

串行方式：
写头像上传 → 等待 → 写密码修改 → 等待 → 写通知偏好 → 等待 → 集成测试

并行方式：
1 个消息 → 同时启动 3 个 Agent 分别编写 3 个模块 → 收集所有代码 → 统一集成测试

最佳实践：

确保任务之间没有依赖关系
在提示词中使用”同时”、“并行”等关键词
让 Claude 自动识别哪些任务可以并行

使用示例bash

# 自动并行 - AI 自动识别独立任务
"同时做这三件事：
1. 编写后端 API（用户认证）
2. 编写前端 UI（登录表单）
3. 编写数据库 schema（User 表）"

# 明确使用多 Agent
"使用多 Agent 并行开发任务模块：
- 后端团队做 CRUD API
- 前端团队做任务列表和表单
- 数据库团队做 Task 模型"

进阶：恢复之前的对话

两个选项：

--continue：自动继续最近的对话
--resume：显示对话选择器

使用示例：bash

# 继续最近的对话
claude --continue

# 使用特定提示继续
claude --continue -p "显示我们的进度"

# 显示对话选择器
claude --resume

# 非交互模式继续
claude --continue -p "再次运行测试"

工作原理：

对话自动保存在本地
恢复时加载完整消息历史
工具状态和结果被保留
上下文完整恢复进阶：并行会话与 Git Worktrees

使用场景：同时处理多个任务，完全隔离代码

创建 worktree：bash

# 使用新分支创建
git worktree add ../project-feature-a -b feature-a

# 使用现有分支创建
git worktree add ../project-bugfix bugfix-123

在每个 worktree 中运行 AI：bash

cd ../project-feature-a
claude

管理 worktrees：bash

# 列出所有 worktrees
git worktree list

# 删除 worktree
git worktree remove ../project-feature-a

优势：

每个工作目录完全隔离
更改不会相互影响
共享相同的 Git 历史进阶：Unix 风格实用程序用法

添加到验证流程：json

// package.json
{
  "scripts": {
    "lint:claude": "claude -p '你是 linter。检查 vs main 的更改，报告拼写错误。每行一个文件名和行号，第二行描述问题。不返回其他文本。'"
  }
}

管道输入输出：bash

# 管道数据
cat build-error.txt | claude -p '简明解释构建错误的根本原因' > output.txt

# 控制输出格式
cat data.txt | claude -p '总结数据' --output-format text > summary.txt
cat code.py | claude -p '分析代码 bug' --output-format json > analysis.json
cat log.txt | claude -p '解析日志错误' --output-format stream-json

输出格式：

text：纯文本响应（默认）
json：完整对话日志的 JSON 数组
stream-json：实时 JSON 对象流

人在环路

AI 能够自主完成很多任务，但以下场景建议保持人工审查：************************

场景	原因	建议做法
生产环境部署	影响所有用户	AI 生成方案，人工审核后执行
数据库结构变更	难以回滚，影响数据	先 review schema，再执行迁移
安全相关代码	漏洞后果严重	代码审查必不可少
支付/财务逻辑	涉及资金安全	测试+双人验证
性能关键路径	影响用户体验	性能测试+基准对比
API 兼容性变更	影响第三方集成	版本管理+通知机制

小白提示

如果你是编程新手，遇到上述场景不确定如何处理： 1.

不要独自承担风险

寻求团队中有经验的人帮助 review
在测试环境先验证
询问 AI 风险点和注意事项

渐进式信任

从简单任务开始让 AI 自主完成
复杂/高风险任务逐步增加人类审查
建立 checklist 确保关键点都被检查

寻找帮助的途径

团队 senior 成员
技术社区（Stack Overflow、GitHub Issues）
让 AI 解释风险点：“这样做有什么风险？” 需要人工审查的信号

AI 建议时保持警惕：

AI 说”可能破坏XXX”
AI 建议删除大量代码
AI 修改核心配置文件
AI 建议重构核心模块

操作建议：

要求 AI 解释改动原因
检查受影响的文件列表
考虑先在分支测试
必要时寻求第二意见

Hooks 自动化

什么是 Hooks

Hooks = 在特定事件时自动执行的 Shell 命令

当 Claude Code 触发某些事件（如工具调用、用户提交提示）时，可以自动执行你注册的脚本命令。

常见用途：

代码写完后自动格式化（运行 prettier/eslint）
AI 要删除重要文件时先拦截确认
提交代码前自动运行测试

安全提示

Hooks 会以你的用户权限执行 Shell 命令，配置前请理解它在做什么。

新手建议：

🟢 从简单场景开始（如自动格式化）
🟡 复杂场景寻求有经验的人帮助
🔴 只使用可信来源的 Hooks

使用 Hooks

运行 /hooks 打开交互式配置界面，这是最推荐的创建方式。

配置流程： 1.

选择 Hook 事件类型：

PreToolUse - 工具调用前
PostToolUse - 工具调用后
PostToolUseFailure - 工具执行失败后
Notification - 发送通知时
UserPromptSubmit - 用户提交提示时（推荐）

配置 Hook 行为：

选择触发条件（matcher）
编写执行的 Shell 命令
设置超时时间（默认 60 秒）

保存并生效

重要说明

每个事件可注册多个 Hooks，并行执行
/hooks 目录外的修改需要重启才能生效
超时时间：60 秒
权限：以你的完整用户权限执行

常用场景````

场景	事件	触发时机	执行命令
自动格式化	PostToolUse	Write/Edit 后	prettier —write $FILE
保护敏感文件	PreToolUse	要修改 .env 时	拦截并警告
运行测试	UserPromptSubmit	提交包含”测试”的提示时	npm test
添加上下文	UserPromptSubmit	每次提交提示前	自动加载项目信息

进阶：配置文件说明

注意：以下内容仅供参考，一般不需要手动编辑配置文件。

配置位置（优先级从高到低）：

.claude/settings.local.json - 本地项目设置（不提交）
.claude/settings.json - 项目设置
~/.claude/settings.json - 用户全局设置

常用事件对照：````````````

事件	触发时机	典型用途
PreToolUse	工具调用前	验证、修改输入、权限控制
PostToolUse	工具调用后	格式化、通知、验证结果
PostToolUseFailure	工具执行失败后	错误处理、回滚操作
SessionStart	会话开始时	加载环境、安装依赖
SessionEnd	会话结束时	清理、记录统计
UserPromptSubmit	用户提交提示时	验证提示、添加上下文

实用示例

自动格式化json

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [{
          "type": "command",
          "command": "\\"$CLAUDE_PROJECT_DIR\\"/.claude/hooks/format-code.sh"
        }]
      }
    ]
  }
}

除了执行命令（type: "command"），还可以用 LLM 做智能决策（type: "prompt"）。

适用场景：需要理解内容后再决定是否放行。

敏感文件保护python

#!/usr/bin/env python3
# .claude/hooks/protect-files.py

import json, sys

data = json.load(sys.stdin)
path = data.get('tool_input', {}).get('file_path', '')

# 阻止写入敏感文件
if any(p in path for p in ['.env', '.key', '.pem']):
    print("受保护：不允许写入敏感文件", file=sys.stderr)
    sys.exit(2)

进阶：Hook 输入输出格式

输入（通过 stdin 接收 JSON）：json

{
  "session_id": "会话ID",
  "cwd": "当前工作目录",
  "hook_event_name": "事件名称",
  "tool_name": "工具名称",
  "tool_input": {...}
}

输出方式：

退出代码：0=成功，2=阻止操作
JSON 输出：可返回 decision、reason 等字段

安全注意事项

安全注意事项

不要把敏感信息发送给 AI：

❌ API 密钥、密码
❌ 生产数据库连接字符串
❌ 用户隐私数据

使用环境变量：bash

# .env 文件（不要提交到 Git）
DATABASE_URL="postgresql://..."
OPENAI_API_KEY="sk-..."

# .gitignore
.env

不要让 AI 修改敏感配置文件：

项目根目录的 .env
SSH 密钥
生产环境配置

核心理念

Workflow 让 AI 开发可预测、可复现。

记住工作流五步曲：探索 → 规划 → 执行 → 验证 → 提交（根据情况灵活应用）

灵活应用

复杂任务：严格遵循五步，减少返工
简单修改：可以跳过探索，直接执行
紧急修复：最小化流程，快速解决

关键是有意识地思考每一步是否需要，而不是机械执行。

提示词自检清单

发送提示词前检查：

任务描述清晰具体
提供了必要的上下文
明确了输出格式
给了 AI”不确定”的出口
包含了必要的约束条件
避免了冗长的角色设定
没有包含敏感信息（API Key、密码等）

常见问题

Q1: 提示词越长越好吗？

A: 不是。

提示词的质量在于精确，不在于长度。

简洁但具体的提示词 > 冗长但模糊的提示词

Q2: AI 还是会编造答案怎么办？

A: 加强约束：

"只使用项目已有的依赖。
如果需要新功能，先告诉我。
不要编造不存在的 API。"

Q3: 为什么不直接让 AI 写代码？

A: 直接写容易返工。

探索 → 规划 → 编写，这个流程能让你：

避免重复造轮子
发现潜在问题
保持代码风格一致

Q4: 工作流会不会太慢？

A: 不会。

看似多了步骤，实际上减少了返工时间。整体效率更高。

对比：

直接写：10 分钟，返工 30 分钟
按流程：15 分钟，一次通过

Q5: 什么时候该停止对话？

A: 信号：

连续 3 轮没有进展
AI 开始重复相同的建议
问题需要更多信息（如查看生产环境日志）

策略：切换模型或换思路

2.2 VibeCoding 规范

传统思维 vs Agent Native********************

Agent Native 的三大原则

从开发者到编排者

核心概念

Vibecoding 的核心理念

提示词的核心原则

提示词原则

好提示词的特征

提示词对比：欠佳 vs 推荐****************************

让 AI 反复提问

提示词模板

代码生成模板

Bug 修复模板

标准工作流

AI 的自动化能力

权限模式

三种权限模式************

Default 模式（推荐）

Plan 模式（代码审查）

Accept Edits 模式（高效编辑）

模式切换

快捷键

常用交互命令

CLI 命令与启动选项基本命令（必读）************“

五步工作流

1. 探索项目结构

2. 规划实现步骤

3. 编写代码

4. 测试验证

5. 提交代码

6. 检查点功能

理解 Agent

什么是 Agent

什么是自定义 Agent

创建自定义 Agent

多 Agent 并行协作

自动启用

多个并行 Agent************

使用示例bash

人在环路

Hooks 自动化

使用 Hooks

常用场景````

自动格式化json

敏感文件保护python

安全注意事项

核心理念

提示词自检清单

常见问题

Q1: 提示词越长越好吗？

Q2: AI 还是会编造答案怎么办？

Q3: 为什么不直接让 AI 写代码？

Q4: 工作流会不会太慢？

Q5: 什么时候该停止对话？

相关内容

CLI 命令与启动选项基本命令（必读）``````“