Vibe Coding on

VibeCoding个人配置

Sun, 24 May 2026 00:00:00 +0000

工欲善其事，必先利其器

status line.sh

Superpowers

Notification

cc switch

过目不忘：CLAUDE

Sun, 24 May 2026 00:00:00 +0000

核心概念
#

CLAUDE.md是Claude Code的核心配置文件，它相当于项目的**”说明书”**，告诉Claude如何理解和处理你的代码库。一个好的CLAUDE.md可以显著提升AI的理解准确性和工作效率。我结合自己的项目来说明如何写一个配置。

其作用如下：

上下文设置：为Claude提供项目背景、技术栈、架构信息
约束定义：设定开发规范、代码风格、质量标准
任务指导：提供明确的执行指令和优先级
知识传承：保存项目的重要决策和设计理念

为什么重要？

减少沟通成本：避免重复解释项目背景
提升准确性：使Claude更好地理解你的意图
保持一致性：确保所有修改都符合项目规范，在团队合作中保持代码的一致性
加速开发：减少调试和返工时间

工作原理
#

当你在项目目录启动 Claude Code 时，发生的“记忆系统初始化”过程如下图所示。

CLAUDE.md 的内容会每次对话都加载，所以要精简。把“每次都需要”的内容放这里，把“偶尔需要”的内容放到 Skills 或文档里。

Claude Code 支持五个层级的记忆，就像洋葱一样，从外到内，按层级结构组织——高层级的文件优先加载，为底层文件提供基础：

其中每个层级都有其用途及使用场景，如下所示：

记忆类型	位置	用途	使用场景	共享范围
企业策略	macOS:/Library/ApplicationSupport/ClaudeCode/CLAUDE.md Linux: /etc/claude-code/CLAUDE.md Windows: C:\Program Files\ClaudeCode\CLAUDE.md	组织级指令，由 IT/Devops管理	公司编码标准、安全策略、合规要求	组织内所有用户
项目记忆	./CLAUDE.md或者./claude/CLAUDE.md（必须提交到git）	团队共享的项目指令	项目架构，编码标准，常用工作流	通关版本管理与团队成员共享
模块记忆	./claude/rules/*.md	模块化的、特定主题的项目指令	语言特定指南、测试规范、API标准	通关版本管理与团队成员共享
用户记忆	~/.claude/CLAUDE.md	跨所有项目的个人偏好	代码风格偏好、个人工具快捷方式	仅自己
项目本地	./CLAUDE.local.md（记得把他加到.gitignore）	跨所有项目的个人偏好	你的沙箱URL、偏好的测试数据	仅自己

基础结构
#

项目记忆一般来说是整个开发过程中最常用的“说明书”了，一个完整的项目CLAUDE.md文件包含以下几个部分：

触类旁通：Skill

Tue, 19 May 2026 00:00:00 +0000

Skill的背景
#

每个公司每个团队都与自己的一套规范，例如代码风格规范、API设计规范、安全审查清单规范、部署流程规范，这些规则并不复杂，但是数量很多。开发者通常不可能将他们全部记忆下来，大部分工程师的做法是：需要时再查阅。

如果我们把 Claude 当作真正的工程助手，它也会面临同样的问题。最直接的做法，是把所有团队规范写进 CLAUDE.md，让模型每次对话都读取这些内容。短期看这是可行的。但当知识规模扩大到几十页甚至上百页时，问题就出现了——每一次对话都在为“可能用不到的知识”支付上下文成本。这不仅消耗 token，更重要的是，它会稀释模型的注意力。真正需要用到的规则，反而淹没在冗余信息里。

Skills的出现解决了这一问题。Skills 并不是简单的“能力扩展机制”，它本质上是一种按需加载的认知结构。与其把所有知识常驻在上下文中，不如把它们封装成可独立触发的能力单元。当模型判断当前任务涉及某个特定领域时，再加载对应的知识与操作流程。Skills 解决的核心问题是，在有限的上下文窗口中，让 Agent 在正确的时刻拥有正确的领域知识。

对于企业来说，把专业流程、领域知识和行动判断封装成可复用的能力单元，然后让智能体按需加载和调用，这是一种让通用模型具备专业化、按需调用能力的通用设计模式。类似 Skills 的模块化能力已经被用于数据分析、校验、报告生成等任务，把自然语言指令转化成结构化的专业工作流；也有技术方案将企业组件库、开发规范等封装成“技能包”，让模型自动发现、理解并正确应用这些业务能力。

正因为“模型调度能力”和“可操作知识”的重要性，Skills 已经逐渐脱离了 Claude 的语境，成了 Agent 生态中的通用概念。“技能化”思路正在从 Claude 系统扩展到其他智能体平台，以及 AI 赋能的工程工具中。在 Claude 发布的 Agent Skills 公用仓库中，集成了大量可复用的能力。Coze 也推出了技能商店，为 Coze 智能体生态提供即插即用的能力组件。

Skill的类型
#

从工程角度，Skill 内容分为两类，参考型和任务型。参考型 Skill 影响“怎么做”，任务型 Skill 决定“做什么”。前者是语义环境，后者是具体行动。

参考型
#

参考型 Skill 更像组织的行为规范层。它定义“在这个世界里，什么是正确的做法”——例如 API 设计标准、代码风格、错误处理约定。这类 Skill 通常由模型根据语义自动判断是否加载，它不主导行动，而是塑造行动的方式。它属于“世界规则”。

防微杜渐：Hook

Tue, 19 May 2026 00:00:00 +0000

Hook出现背景
#

如果你有 Web 开发经验，你一定熟悉中间件（Middleware）的概念。

请求 → 中间件1 → 中间件2 → 中间件3 → 处理函数 
                 ↓ 认证、日志、限流

中间件在请求到达最终处理函数之前插入检查和处理，实现横切关注点（Cross-cutting Concerns）。这些逻辑不属于任何一个业务功能，但又必须贯穿所有请求——认证要每个接口都检查，日志要每个操作都记录，限流要每个入口都控制。

Claude Code 的 Hooks 机制与此异曲同工，但它针对的不是 HTTP 请求，而是 AI Agent 的工具调用。

用户请求 → Claude 决策 → [PreToolUse Hook] → 工具执行 → [PostToolUse Hook] → 响应 
                               ↓ 权限检查、拦截                 ↓格式化、验证、日志

Hooks 是 AI 助手的中间件——拦截、监控、增强每一次交互。这个类比不仅是形象上的相似。Web 中间件解决的核心问题是“业务代码不应该操心安全和日志”，Hooks 解决的核心问题也一样——Claude 不应该操心格式化和权限检查，它只管写好代码就行。安全防线、质量守卫、审计日志，全部由 Hooks 在“幕后”自动完成。

Hook事件
#

截至 2026 年 3 月，根据 Anthropic 官方文档，Claude Code 支持 17 种 Hook 事件，覆盖了从会话启动到结束的完整生命周期：

各司其职：SubAgent

Wed, 22 Apr 2026 00:00:00 +0000

为什么需要SubAgent
#

我们先从一个常见场景开启今天的内容。

某天，你让 Claude Code 帮你跑一个测试套件，结果输出了 500 行日志；然后你想让它分析一下代码结构，又输出了 200 行；接着你想让它改一个 bug……这时候，你的对话上下文已经被各种“中间过程”塞满了，真正重要的信息被淹没在茫茫的输出海洋里。

其实，究其根本。如果你觉得 Claude Code 越用越“健忘”，并不是模型退化了，而是你的对话上下文，已经被一次次中间过程污染了,这正是子代理要解决的核心问题。因为只有子代理，才在系统层面天然拥有一个独立的上下文窗口。不是因为它“聪明”，不是因为它“更强”，而是因为它是 Claude Code 里唯一一个，结构上允许“执行完即丢弃”的东西。

在前面的现象里，上下文里充斥着这些内容：

跑测试 → 500 行日志。
搜索代码 → 200 行 grep。
分析错误 → 一堆中间推理过程……

这些信息有一个共同特征：它们对“当下执行”是必要的，但对“后续决策”是噪声。而 Claude Code 的主对话上下文是线性追加的，不会自动过期，默认“都当成重要记忆”。所以问题不是 Claude 突然不聪明了，而是它把临时执行数据，当成了长期决策记忆。这在工程上，本来就一定会“炸”。

而子代理，通过上下文隔离，让专业的 Agent 做专业的事儿，不是为了让 Claude 做得更多，而是为了让 Claude 记得更少，但记得对。

什么是SubAgent
#

SubAgent当于一个“专职小助手”，它拥有独立的：

Vibe Coding on

VibeCoding个人配置

过目不忘：CLAUDE

核心概念 #

工作原理 #

基础结构 #

触类旁通：Skill

Skill的背景 #

Skill的类型 #

参考型 #