基础篇
进阶篇
高频篇
精选篇
手写篇
面经篇
AI 篇
原理篇
每日一题
小程序题库
  • 知识卡片碎片时间过考点
  • 场景篇按分类整理的大前端场景考点
  • 历年面经按年份追踪真实考点
  • 算法题库NEW在线编码即时判题
  • 专项自测100 题快速查漏
  • 前端基础
    • HTTP从报文一路讲到 HTTPS
    • 浏览器渲染、事件循环、进程
    • 计算机基础Linux、网络、操作系统
  • 进阶专项
    • 设计模式23 种模式怎么用
    • 前端系统进阶学习大型项目工程化
    • 前端综合文章长期沉淀的实践文
  • 工程与工具
    • Node学习指南从环境搭建到服务端
    • NPM工作流script、依赖与发布
    • Docker容器化部署上手
    • Canvas图形与动画实战
  • 路线与导图
    • 思维导图知识点全景图
    • 学习路线按图索骥不跑偏
  • 动态
    • 公众号动态公众号历史文章
    • 博客动态站长的技术博客
    • 开发者导航常用工具与文档站
    • AI 热点每日 AI 资讯与动向
AI 工作台
旧版
AIHT
内容
精选全部 AI 动态热点榜AI 日报收藏
分类
模型行业编程产品技术观点开源
更多
Agent 接入
返回首页开发者导航
AIHT
精选 / 资讯详情
8.0
热点
AI SCORE
编程提效2026-11-22 17:54

Claude Code 常驻指令与按需技能怎么分

dev.to · AI#Claude Code#上下文管理#技能
Editor brief · 编辑速览

将每次会话都需要的项目约定放进 CLAUDE.md,把部署清单、迁移步骤等低频流程写入按需加载的 SKILL.md。这样能减少日常改代码时被流程文档占用的上下文。

文章思维导图
Knowledge map
拖拽缩放
AI deep read

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,在项目说明里留一行入口。团队以后改部署流程时,更新同一处说明即可。
Original source

本文由 AI 通读原文后重新编写,观点部分为站内判断,细节以原文为准,来源 dev.to · AI,原文版权归原作者所有。

阅读原文
上一篇
Gemini API 预览工具按需检索能力
下一篇
为智能体工具调用设计分层权限判定

资讯速览

dev.to · AI · 2026-11-22 17:54

AI 评分 8.0 / 10

相关标签

#Claude Code#上下文管理#技能

继续阅读

  • 桌面助手如何区分停止播报与取消任务
  • Gemini API 预览工具按需检索能力
  • 为智能体工具调用设计分层权限判定
  • 开源 AI 工程课程带你手写模型与智能体
  • 用只读脚本排查 AGENTS.md 里的失效命令