当前位置: 首页 > news >正文

claude code 的三种 skill 类型以及一些常见陷阱

因为 claude code 是一个命令行的工具,所以用起来很轻便。当然 cursor 它直接集成了 IDE ,但论灵活度还是不如 claude code 。

本文全文原文完整版 URL : https://www.ccgxk.com/codeother/689.html

昨天我讲了一些 claude code 的使用技巧,但我没讲完:部分内容有参考 HiTw93 大佬的文章:

https://x.com/HiTw93/article/2032091246588518683

这个是昨天我内容。

https://www.ccgxk.com/codeother/688.html

今天继续来!

善用子 agent

大多数人用 claude code ,只用到了其 30% ~ 50% 的功力。这是不行的。现在这个时代确实如寒武纪大爆发,新工具层出不穷,但是 claude code 是比较重要权威的那个,是唯一一个值得我们去深入研究的软件,因为它目前依然是程序员与 AI 之间最好的桥梁之一,每多学一丢丢,都可以让效率成几倍数提升,性价比很高。

现在 2026 年 3 月,AI 已经很成熟了,有钱用 claude opus ,平价平替是 glm-5 和 kimi-2.5 ,效果差距虽然有点,但也够用,后者比前者便宜 5 倍甚至更多。

所以,我们现在的策略是:「让 AI 自己去干活儿,我们只给目标」!因为 AI 现在不仅可以写代码了,它可以探索、可以策划和写文档、可以调用接口.... 什么都能干。这种模式学名叫 Agentic Engineering 。

其实意思就是善用 子 agent ,让 AI 分身去干活儿,各自干各自的。就好像工厂里,分工流水线,而不是所有工人都从 0 开始搞一个完整的产品。

下面是 skill 的更深入的内容:

三类 skill 类型

skill 分为 3 种,检查清单型、工作流型、领域专家型 。下面是 demo。

第一种,检查清单 demo:

---
name: 发布检查 
description: 发布前用于验证构建、版本号及冒烟测试。
---## 预检项目 (必须全部通过)
- [ ] `cargo build --release` 编译通过
- [ ] `cargo clippy -- -D warnings` 检查无误
- [ ] Cargo.toml 中的版本号已递增
- [ ] CHANGELOG (更新日志) 已更新
- [ ] 纯净环境下 `kaku doctor` 检查通过## 输出格式
按项输出 通过 / 失败。任何一项失败均须在发布前修复。

主要用处就是【预防低级错误】!保证确定性。稳定性。这在 CI/CD 流程中是最后一道人工确认屏障。

第二种,工作流型 demo :

---
name: 配置迁移 
description: 迁移配置 Schema。仅在明确请求时运行。
disable-model-invocation: true
---## 操作步骤
1. 备份:`cp ~/.config/kaku/config.toml ~/.config/kaku/config.toml.bak`
2. 试运行:`kaku config migrate --dry-run`
3. 应用:确认输出无误后移除 `--dry-run`
4. 验证:确保 `kaku doctor` 全部通过## 回滚命令
`cp ~/.config/kaku/config.toml.bak ~/.config/kaku/config.toml`

是吧,跟 SOP 一样,跟在恐怖的又普遍存在的、生死黑白两班倒的流水线工厂里,教工人怎么操作机器一样。一步一步写好。

(注:disable-model-invocation: true 是精髓。剥夺 AI 的“即兴发挥”权。)

它的作用是降低高危操作风险,确保流程可用和安全。换言之,将 AI 的操作风险降到了传统运维脚本的水平,但保留了自然语言触发的便利性。

第三种,领域专家 demo:

---
name: 运行时诊断 
description: 用于处理 kaku 运行时崩溃、卡死或行为异常。
---## 证据采集
1. 运行 `kaku doctor` 并获取完整输出
2. 查看 `~/.local/share/kaku/logs/` 最后 50 行日志
3. 插件状态:`kaku --list-plugins`## 决策矩阵
| 症状 | 首要检查点 |
|---|---|
| 启动时崩溃 | doctor 输出 → Lua 语法错误 |
| 渲染异常 | GPU 后端 / 终端兼容性 |
| 配置未生效 | 配置文件路径 + Schema 版本 |## 输出格式
根本原因 / 影响范围 / 修复步骤 / 验证命令

当系统崩溃时,AI 往往会先建议你“重启”或“检查代码”。而这个 Skill 强制它先看 doctor 输出和 logs。领域专家 skill 的用处,就是约束 AI 的推理路径,让它能使用我们定义的方法去处理疑难杂症。为啥搞这个?? 很简单,抑制 AI 的“幻觉猜测”。AI 解决疑难杂症,有些时候会太飘 ~

简单说,就是运行时出问题时让 Claude 按固定路径收集证据,不要瞎猜。

反模式

什么是反模式,就是 弄巧成拙,就是陷阱,就是坑,下面这些做法,诸位引以为戒。

skill 方面:

  1. 在 skill 编写和设计时,如果这样写:“ description: help with backend ” 或类似写法,称为过度匹配。描述要“短而精”,而不是“短而泛”。这样写,会让我们在 AI 对话时,提到 后端、服务器、API 等等因素,马上就会读取这个 skill ,然后.... 浪费 token 。
  2. 觉得方便,把几百行的完整运维手册塞进 Skill 正文 skill.md 里。这会上下文污染,稀释 claude code 的注意力。
  3. 允许自动调用,而不是写了 disable-model-invocation: true 的一些有危险或副作用的 skill 。千万不要这样!
  4. 一个 Skill 同时负责 Review、Deploy、Debug、Docs、Incident。后果是 AI 会产生角色混乱。正确做法是一个 Skill 只解决一个闭环问题。

子 agent 方面:

因为很多事,比如隔离,扫代码库、跑测试、做审查,会浪费大量的 token ,放到主进程,会占用上下文。因此发明了 子代理 。这样主进程只拿一个摘要,干净多了。

  1. 一定不要违背最小特权原则!子代理 要有权限隔离,权限越小越好!tools / disallowedTools 这些配置,可以限定能用什么工具
  2. 一个大坑,你们迟早会遇到:输出格式随机化 。我们要强制要求 Subagent 使用 json_schema 或固定的 Markdown Table 输出,主线程只负责路由和聚合。

高频斜杠命令

要作为一个深度使用 claude code 的用户,应该熟练使用下面这些 斜杠命令 :

# 上下文
/context        # 查看当前会话 Token 占用结构
/clear          # 彻底清空当前会话
/compact        # 压缩当前上下文,仅保留核心重点
/memory         # 检查内存加载状态# 调控
/mcp            # 管理 MCP 连接
/hooks          # 管理拦截钩子
/permissions    # 查看或更新工具调用权限
/sandbox        # 配置沙箱环境隔离
/model          # 动态切换模型# 工程集成
claude --continue               # 恢复当前目录最近会话,适合中断后的任务衔接
claude --resume                 # 从历史会话列表中恢复指定任务
claude --continue --fork        # 基于当前会话分叉 (Fork),测试同一问题的不同解法
claude --worktree               # 自动创建隔离的 Git Worktree,避免污染主分支代码
claude -p "prompt"              # 非交互模式运行,常用于 CI/CD 或 Pre-commit 脚本
claude -p --output-format json  # 强制结构化输出,便于上游脚本或工具链自动化# 高级调试(强烈推荐,这些是很好用的命令)
/simplify       # 对刚改完的代码进行复用性、质量与效率审查
/rewind         # 回到指定的 Checkpoint 节点,丢弃偏离路径的后续对话
/btw            # 干活时,插话,问问题
/insight        # 新功能,是会话复盘
claude -p --output-format stream-json # 实时 JSON 事件流,用于长任务监控与增量处理# 本地 HACK 技巧
[Double ESC]    # 纠正手误
grep -rl "KEY" ~/.claude/projects/ # 定位包含特定关键词的历史会话 JSONL 文件

claude code 环境体检

下面这个 skill 可以帮我们检查当前 claude code 有哪些改进的,感兴趣的朋友可以试试: https://github.com/tw93/claude-health

http://www.jsqmd.com/news/519320/

相关文章:

  • Unity:Cinemachine Virtual Camera(虚拟摄像机)的智能追踪艺术
  • 打工人必备!用Coze把微信/邮箱发票自动同步到飞书表格(避坑指南)
  • 《信息服务与应用》 第三章 研究方法及应用
  • 新手避坑指南:FileZilla连接Linux报错‘拒绝连接’的5种解决方法(附SSH完整配置流程)
  • 实测对比后 8个AI论文写作软件:本科生毕业论文与科研写作必备工具推荐
  • 内网环境搞定OpenResty离线安装:从依赖包下载到避坑全记录
  • 佛山宏昭自动化技术有限公司是做什么的?主营产品、业务范围及服务优势全解析
  • 用HTML5 Canvas和原生JS手搓一个Emoji消消乐(附完整源码和算法解析)
  • Comsol声子晶体能带计算,包含六角晶格不同原胞的选取以及简约布里渊区高对称点选择
  • simulink仿真 双机并联逆变器自适应虚拟阻抗下垂控制(Droop)策略模型 逆变器双机并联
  • Ubuntu18.04虚拟机300GB配置全攻略:Vivado2019.2+Vitis+Petalinux一站式安装
  • 从Tacotron到智能语音:端到端语音合成的原理、应用与未来
  • 《情报分析与研究》第三周课程笔记
  • 真的太省时间! 降AIGC工具 千笔·降AI率助手 VS 灵感风暴AI 全领域适配
  • ArcGIS数据驱动页面隐藏技巧:这样设置‘裁切’与‘排除图层’,让你的专题图效果提升一个档次
  • COMSOL求解计算流体力学中动压润滑方程组的2D模型案例
  • 从SMS网格到FVCOM:.grd与.2dm文件结构解析与海洋建模实战
  • 超声波探伤技术在工业检测中的前沿应用与创新突破
  • 计算机毕业设计springboot基于的地铁综合服务管理系统的设计与实现 基于SpringBoot框架的城市轨道交通运营服务平台设计与实现 基于Java技术的地铁乘客服务与内部协同管理系统开发
  • LeetCode 48 1886.矩阵旋转与判断
  • 1588v2协议实战:如何在工业自动化场景中实现纳秒级时间同步?
  • 别再乱用to_dict了!Pandas数据转换orient参数避坑手册(附场景对照表)
  • STM32入门(13)
  • AutoGen Manager-Broadcast机制详解:手把手教你配置多代理聊天组(含Python代码示例)
  • 字符串 I:border 理论 I
  • 计算机毕设 java基于微信小程序点餐系统的设计与实现 微信小程序智能点餐平台开发 基于 SpringBoot 的餐饮在线点餐系统设计
  • 避坑指南:WRF下垫面数据替换中的5个常见错误及解决方法(基于GDAL转换经验)
  • 从西工大网安导论出发:构建网络空间安全的知识体系与实践视角
  • Hyper-V虚拟机安装Deepin避坑指南:从镜像选择到循环安装解决
  • Flink内存管理实战:如何用堆外内存提升大数据处理性能(附配置参数详解)