Claude Code 常驻指令与按需技能怎么分
将每次会话都需要的项目约定放进 CLAUDE.md,把部署清单、迁移步骤等低频流程写入按需加载的 SKILL.md。这样能减少日常改代码时被流程文档占用的上下文。
AI 深度解读
让 Claude Code 给变量改个名,项目的部署清单也跟着进了上下文。作者用这个例子说明 CLAUDE.md 和 SKILL.md 的分工。前者在会话启动时加载,适合存放长期有效的项目约定。后者把具体流程留到任务触发时再加载。
如果团队已经把 CLAUDE.md 写成一本操作手册,这篇最值得带走的是一个整理方法。先看每条信息该在什么时候出现,再决定放哪。这样既能让日常任务更容易看到关键约定,也能保留部署、迁移和审查需要的细节。
每次开工都用得上的信息,才值得常驻
CLAUDE.md 是人主动写给 Claude Code 的常驻说明。应用用哪条命令启动、代码按什么规则命名、目录怎么分、PR 是否必须带工单号,这些信息在许多任务里都可能影响判断,团队也不会频繁改动。作者的筛选标准很直观。如果新人第一天就该知道,而且下个月大概率还成立,就适合写进去。
有些内容跟项目有关,却只对一部分代码有用。比如前端仓库里的组件命名约定可能适用于整个项目,某个旧模块的数据兼容规则则只在改动那个模块时有意义。作者转述的 Anthropic 指引给了两种去向。多步流程可以搬进 skill,局部约束可以写成针对特定目录或模块的规则。个人跨项目的语言偏好和编码习惯则可以放进个人的 CLAUDE.md,与团队共享的项目说明分开。按原文的说法,会话启动时会重新读取 CLAUDE.md,如果手头的会话里刚改了文件,开一个新会话来确认修改生效。
Claude Code 还有一套自动记忆(auto memory)。它会从协作中的纠正和偏好里自行积累笔记。团队要明确维护的规则适合写进 CLAUDE.md,自动记忆则记录 Claude 在实际协作中学到的内容。这两类信息的维护者不同,出了偏差时,排查入口也不同。
任务触发时,才把步骤和资料交给 Claude
一个 skill 是一个小目录,必需文件是 SKILL.md。顶部的 description 告诉 Claude 什么任务适合用它,正文说明触发后怎么做。你可以输入 /skill-name 主动调用,Claude 也可以根据请求与描述的匹配情况自行选择。按作者的解释,被推迟的是 skill 的详细指令和附件。长模板、边界情况和参考手册可以放到单独的文件里,在任务确实需要时再读。
作者把 skill 的用途分成两类。一类是执行有明确起止的任务,例如部署到测试环境、根据 diff 写提交消息、处理带编号的 issue。另一类是提供偶尔用到的参考材料,例如某个子系统的接入说明。决定因素是使用频率。仓库里普遍适用的 API 约定可以常驻,只有接入某个模块才需要查的协议细节可以延期加载。
下面这个例子让 Claude 根据当前 Git 差异写出两到三条变更摘要,再列出缺少错误处理、写死值之类的风险。
---
description: "Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff."
---
## Current changes
!`git diff HEAD`
## Instructions
Summarize the changes above in two or three bullet points, then list any risks such as missing error handling or hardcoded values.
关键是 ! 开头的那一行。按原文的说明,Claude Code 会先运行 git diff HEAD,再把实际输出插入提示,模型拿到的是当下的差异。这个命令会比较工作区与 HEAD,覆盖已跟踪文件的暂存和未暂存改动,未跟踪的新文件需要另行检查。大批量改动时,整份 diff 也可能很长,按需加载省下的是平时携带流程的开销,执行时仍要为具体输入留出空间。
部署可以让 Claude 知道,但由人决定何时触发
作者建议把部署和对外发消息等有实际后果的 skill 设为手动调用。代码看起来已经准备好,和团队决定现在执行部署,中间还隔着一个人为决定。只允许手动调用时,这个流程要等用户亲自输入命令才会运行。原文也提到另一种配置,只允许 Claude 调用,用户的直接调用菜单里不会出现它。
两份文件可以互相配合。CLAUDE.md 用一句话指出部署流程在哪个 skill,测试环境的具体步骤、脚本和常见故障说明放在 skill 目录里。流程增长后,同样可以让主 SKILL.md 保持简短,把例外和参考细节拆成附件。原文还提到,研究或规划可以交给隔离子代理执行,以减少主会话携带的内容。至于隔离执行时能看到哪些项目指令,原文给出了结论,却没有交代版本、具体配置或验证过程。
我的判断
我赞成先问「这条信息在什么任务里会被用到」。靠删字数缩短 CLAUDE.md,容易把真正重要的约定也压得含糊。把整份手册挂到普通文档链接上,也已经能解决一部分问题,尤其是团队成员和 AI 都只是偶尔查阅时。Skill 更适合那些每次都要重新交代触发条件、执行顺序、输入和输出的工作。以部署为例,已有脚本或 CI 流程可以继续执行那些确定的步骤,skill 负责把操作入口、所需信息和检查项交给 Claude。
作者说这是他处理 Claude Code 迟钝或跑偏时常做的整理,但文中没有给出拆分前后的 token 用量、延迟、费用或指令命中率,也没有做对照实验。减少无关指令进入上下文的理由成立,能快多少、能省多少仍是经验判断。文中关于会话内重读和隔离子代理读取范围的说法也没有附版本或复现配置。如果团队的流程依赖这些行为,应该用自己的 Claude Code 环境跑一个小例子确认。
能拿来做什么
- 检查前端或 Node 仓库的
CLAUDE.md,保留真实启动命令、目录约定和 PR 要求,把只在修改旧模块时才用到的兼容规则限定到对应目录。 - 把反复交代的 diff 摘要或提交消息流程做成 skill,在描述里写清什么时候触发、正文里写清输出格式。如果要覆盖新增文件,再补一项检查未跟踪文件的步骤。
- 把部署到测试环境的步骤和相关脚本放进手动调用的 skill,在项目说明里留一行入口。团队以后改部署流程时,更新同一处说明即可。