· 技术笔记 · 6 次阅读

Claude Code 自定义 Slash Commands:把工作流存成一条命令

Claude Code 的自定义 Slash Commands 功能,能把常用的工作流 Prompt 存成文件,一个命令就能触发完整的自动化操作。


昨天下午,我盯着一个之前写的项目发呆。

代码风格混乱,测试覆盖率为零,commit message 写的是「fix」「update」「111」。

我需要把它接手过来,加上测试,整理依赖,对接新的 API。

打开 Claude Code,输入了一行命令:

/test

三十秒后,它开始自动分析项目的测试框架,找到所有未覆盖的模块,然后逐个补测试。

/test 命令执行效果

又输入了一行:

/changelog

它扫了一遍当前分支的所有 commit,按 feat、fix、refactor 分类,自动生成了格式化的更新日志。那些垃圾 commit message 被它读了上下文后重新概括成了可读的描述。

/changelog 命令执行效果

再来一个:

/dep-cleanup

它列出了 package.json 里所有没被源文件引用的依赖,找到了同一功能装了两个库的重复项,还标出了哪些库有已知安全漏洞。

/dep-cleanup 命令执行效果

依赖清理结果

整个项目从零覆盖到 87% 的测试率,加上依赖清理和 changelog,不到半小时。


这不是普通的 AI 编码

重点不在于 Claude Code 能不能做这些事,重点在于我只需要输入一个词,它就知道我要什么。

这背后是一个被我反复调试过的 prompt 模板。

prompt 模板示例

不需要每次都重新描述。这些内容打过一次,存下来,以后永远不用再打。

这个功能叫自定义 Slash Commands

Claude Code 的一个隐藏功能,存在很久了,但很多人并不知道。

Claude Code 文档中关于自定义命令的说明


用法

原理很简单。

在项目根目录下建一个文件夹 .claude/commands/,在里面放 markdown 文件。文件名就是命令名,文件内容就是 prompt 模板。

.claude/commands 目录结构

比如建了一个 test.md,内容大概是这样的:

test.md 文件内容示例

以后在 Claude Code 里输入 /test,它会自动读取这个文件,按照模板去执行。


写好自定义命令的关键

很多人第一次用这个功能,会犯一个错误:prompt 写得太泛。

「帮我写测试」这种 prompt 存成文件没什么意义,Claude Code 本来就会这么做。

你需要存的是那些只有你知道的上下文——比如项目用 Vitest 而不是 Jest,测试文件放在 __tests__ 目录下,fixture 从 ./helpers 引入,mock 的写法要用 vi.fn() 而不是 jest.fn()

这些细节,才是自定义命令真正值钱的地方。

想象一下,如果把团队的代码规范、Git 工作流、部署流程全部做成自定义命令,共享到项目仓库里——新同事入职第一天,clone 代码,输入 /onboard,Claude Code 就自动帮他配好开发环境、跑通测试、生成项目架构说明。


几个常用命令示例

/test          补测试

/changelog     扫 commit 生成更新日志

/dep-cleanup   分析 package.json 清理死依赖

/perf-audit    性能审计,识别瓶颈和优化机会

每一个命令背后都是踩过坑、总结过最佳实践的工作流。存成命令模板后,这些问题不会再出现,因为调教一次,后面就是稳定输出。


vibecoding 总结

自定义 Slash Commands 的门槛极低——不需要会编程,不需要懂 API,只需要会用 Claude Code、会写 Markdown。

编程这件事的抽象层又往上抬了一级。以前觉得写代码是核心能力,现在代码本身正在变成最底层的东西。真正值钱的,是知道该让 AI 干什么、怎么干、按什么标准干。

把经验沉淀成命令,命令变成团队资产,资产变成效率。这个链条跑通了,vibecoding 才真正从偶尔用用的新奇体验,变成日常开发的基础设施。


原文:快跑啊小卢(若川视野 转发)

评论

加载评论中...

发表评论