Claude Code Skill 菜单中文汉化指南:一行配置解决英文菜单痛点

2421 字
12 分钟
Claude Code Skill 菜单中文汉化指南:一行配置解决英文菜单痛点

痛点:装了 30 个 Skill,菜单里全是英文#

昨天有个开发者在群里发了张截图:

/skills
├── remotion-best-practices
├── vercel-react-best-practices
├── web-design-guidelines
├── frontend-design
├── seo-audit
├── playwright-testing
├── typescript-strict-mode
├── accessibility-audit
├── performance-budget
└── docker-compose-best-practices

他问了一个很多 Claude Code 用户都会遇到的问题:你装了 30 多个 Skill,但每次想用时,菜单里全是英文名字。remotion-best-practices 是干什么的?vercel-react-best-practicesreact-best-practices 有什么区别?web-design-guidelines 包含哪些内容?

每次都要翻文档,或者一个个点进去看描述。

而经过汉化后的菜单是这样的:

/skills
├── remotion-best-practices 视频剪辑工具
├── vercel-react-best-practices React开发规范
├── web-design-guidelines Web设计指南
├── frontend-design 前端设计
├── seo-audit SEO审计
├── playwright-testing 浏览器自动化测试
├── typescript-strict-mode TypeScript严格模式
├── accessibility-audit 无障碍访问审计
├── performance-budget 性能预算管理
└── docker-compose-best-practices Docker编排规范

一眼就知道每个 Skill 是干什么的,不用记英文名,不用翻文档,不用猜。

核心原理:SKILL.md 的 YAML Frontmatter#

每个 Claude Code Skill 的配置文件都是一个 SKILL.md 文件,开头有一个 YAML 格式的 Frontmatter 区域:

---
name: remotion-best-practices
description: Best practices for Remotion video development...
---

这里有两个关键字段:

字段作用显示位置
nameSkill 的标识名菜单列表中显示
descriptionSkill 的详细说明详细信息面板中显示

关键操作:把 name 字段改成 英文名 中文说明 的格式。

---
name: remotion-best-practices 视频剪辑工具
description: Remotion视频开发和动画工作流的最佳实践指南,包含转场动画、字幕、音频同步等开发技巧
---

两个字段的分工:

  • name:显示在 /skills 菜单列表中,建议用 英文名 中文说明 格式——保留英文是因为 Claude Code 内部通过 slug 匹配,中文只是为了给你看
  • description:显示在详细信息中,完全可以写纯中文,详细说明这个 Skill 的功能、适用场景、前置条件

保存文件,再打开 Claude Code 输入 /,菜单里显示的就是:

/remotion-best-practices 视频剪辑工具

实战:批量汉化 15+ 个中文 Skill#

我自己部署的 OpenClaw + hermes-agent 环境里,装了十几个中文 Skill。下面是实际改造前后的对比:

热搜类 Skills#

# 改造前
---
name: baidu-hot-cn
description: 百度热榜监控 | Baidu Hot Topics Monitor
---
# 改造后
---
name: baidu-hot-cn 百度热搜
description: 获取百度热搜榜、搜索趋势、关键词热度数据,支持自定义条数
---
# 改造前
---
name: zhihu-hot-cn
description: 知乎热榜监控 - 获取知乎热门话题
---
# 改造后
---
name: zhihu-hot-cn 知乎热榜
description: 获取知乎热门话题、问题和趋势分析,监控科技/互联网/职场等垂直领域
---
# 改造前
---
name: weibo-hot-trend
description: 获取微博热搜榜数据
---
# 改造后
---
name: weibo-hot-trend 微博热搜
description: 获取微博热搜榜数据,返回热搜标题、热度值和跳转链接,支持自定义条数
---

飞书生态 Skills#

# 改造前
---
name: feishu-bridge
description: Connect a Feishu bot to Clawdbot via WebSocket
---
# 改造后
---
name: feishu-bridge 飞书桥接
description: 通过 WebSocket 长连接将飞书机器人接入 Agent,无需公网服务器和域名
---

为什么不全改中文名?#

你可能会问:为什么不直接把 name 改成纯中文,比如 name: 百度热搜

不建议纯中文名,原因有三个:

  1. Slug 匹配问题:Claude Code 内部通过 URL-friendly 的 slug 来匹配 Skill,纯中文 slug 可能在某些环境下出现编码问题
  2. 搜索友好:英文名方便在文件系统中 grepfind 搜索,比如 find . -name "*feishu*"
  3. 兼容性:部分 Skill 加载器可能依赖 name 字段做路径解析,混写中文可能导致加载失败

最佳实践是 英文名 中文说明 的混合格式,兼顾了技术兼容性和人类可读性。

进阶技巧:分类前缀 + 智能排序#

技巧一:分类前缀,同类 Skill 排在一起#

如果你装了特别多 Skill,可以用分类前缀来分组:

---
name: 写作-文档生成
description: 自动生成技术文档和说明
---
---
name: 写作-SEO审计
description: SEO 优化和关键词分析
---
---
name: 开发-视频剪辑工具
description: Remotion 视频开发工作流
---
---
name: 开发-React开发规范
description: Vercel React 最佳实践
---
---
name: 设计-Web设计指南
description: Web 设计规范和最佳实践
---
---
name: 设计-前端设计
description: 前端 UI/UX 设计指导
---

这样菜单里同类 Skill 会排在一起,一目了然:

/skills
├── 写作-文档生成
├── 写作-SEO审计
├── 开发-视频剪辑工具
├── 开发-React开发规范
├── 设计-Web设计指南
└── 设计-前端设计

技巧二:按使用频率排序#

最新版本的 Claude Code 支持按使用频率自动排序。你不需要做任何配置,系统会自动把你最近常用的 Skill 排到前面

推荐使用这个特性,因为它是自适应的——你越用,排序越智能。

技巧三:数字前缀(固定顺序)#

如果你想完全控制顺序,可以加数字前缀:

---
name: 01-baidu-hot-cn 百度热搜
description: 百度热搜监控,每天必用
---

这样菜单会严格按数字顺序排列。适合那些每天必用的 Skill。

懒人福音:让 Claude Code 一键批量翻译#

手动改 30 个 Skill 太累?让 Claude Code 自己帮你翻译!

打开 Claude Code,复制下面这段提示词:

请帮我批量为所有 Claude Code Skills 添加中文翻译。
任务:
1. 扫描 ~/.claude/skills/ 目录下的所有 Skill
2. 读取每个 Skill 的 SKILL.md 文件
3. 检查 name 和 description 字段是否已有中文翻译
4. 如果没有,根据 Skill 的英文名和 description,添加中文翻译
5. 格式:
- name: 英文名 中文说明(4-6字)
- description: 完整的中文描述
要求:
- name 的中文说明要简短(4-6字)
- description 要完整翻译成中文,写详细一点
- 保留原有英文名,只在后面添加中文
- 不要修改其他字段
- 处理完后告诉我修改了哪些 Skill
开始执行。

粘贴到 Claude Code,回车。AI 会自动翻译,而且翻译得比你自己想的还准确。

⚠️ 注意:每次更新 Skill 后会被覆盖,需要重新执行一次翻译。

批量汉化脚本(进阶)#

如果你更喜欢命令行,这里提供一个 Bash 批量汉化脚本:

#!/bin/bash
# 一键汉化 Claude Code Skill 菜单
# 用法:./localize-skills.sh ~/.claude/skills/
SKILLS_DIR="${1:-$HOME/.claude/skills}"
# 定义汉化映射(slug -> 中文说明)
declare -A TRANSLATIONS=(
["remotion-best-practices"]="视频剪辑工具"
["vercel-react-best-practices"]="React开发规范"
["web-design-guidelines"]="Web设计指南"
["frontend-design"]="前端设计"
["seo-audit"]="SEO审计"
["playwright-testing"]="浏览器自动化测试"
["typescript-strict-mode"]="TypeScript严格模式"
["accessibility-audit"]="无障碍访问审计"
["performance-budget"]="性能预算管理"
["docker-compose-best-practices"]="Docker编排规范"
)
for skill_dir in "$SKILLS_DIR"/*/; do
skill_file="$skill_dir/SKILL.md"
if [[ ! -f "$skill_file" ]]; then
continue
fi
slug=$(basename "$skill_dir")
translation="${TRANSLATIONS[$slug]}"
if [[ -z "$translation" ]]; then
echo "⏭️ $slug 未配置翻译,跳过"
continue
fi
# 检查是否已经汉化过
if grep -q "name:.*${translation}" "$skill_file" 2>/dev/null; then
echo "✅ $slug 已汉化,跳过"
continue
fi
# 修改 name 字段
sed -i "s/^name: ${slug}$/name: ${slug} ${translation}/" "$skill_file"
echo "✅ $slug${slug} ${translation}"
done
echo "🎉 批量汉化完成!"

使用方法:

Terminal window
# 先预览(不实际修改)
cat localize-skills.sh
# 执行汉化
chmod +x localize-skills.sh
./localize-skills.sh ~/.claude/skills/

Claude Code 4.0+ 的 Skill 生态变化#

随着 Claude Code 进入 4.0 时代,Skill 生态正在发生几个重要变化:

1. Skill 市场爆发#

GitHub 上的 agentskills.io 已经收录了 500+ 个开源 Skill,涵盖:

  • 前端开发(React/Vue/Svelte/Astro)
  • 后端开发(Node.js/Python/Go)
  • DevOps(Docker/K8s/CI/CD)
  • AI 辅助(代码审查/文档生成/测试)
  • 垂直领域(金融/医疗/教育)

2. 自定义 Skill 标准化#

SKILL.md 的格式正在成为行业事实标准。不仅 Claude Code 在用,OpenClaw 的 hermes-agent、Cursor、GitHub Copilot 等工具都开始兼容这个格式。

3. 中文 Skill 生态崛起#

国内开发者开始贡献中文原生 Skill,比如:

  • 百度热搜监控:调用百度 API 获取实时热榜
  • 飞书文档管理:读写飞书在线文档
  • 抖音热榜:获取抖音热门话题和视频
  • 今日头条:聚合新闻和技术资讯

这些 Skill 从第一天起就是中文友好的,namedescription 都是中英双语。

常见问题#

Q: 改了 name 后 Skill 还能正常使用吗?#

能。 Claude Code 通过文件路径(目录名)来定位 Skill,而不是通过 name 字段。name 只是显示用。

Q: description 太长会怎样?#

建议控制在 200 字以内。太长会导致菜单展开时占用过多空间,影响浏览体验。

Q: 如何批量检查哪些 Skill 还没汉化?#

Terminal window
# 检查所有没有中文说明的 Skill
for f in ~/.claude/skills/*/SKILL.md; do
name=$(grep "^name:" "$f" | head -1)
# 如果 name 后面没有中文字符
if ! echo "$name" | grep -qP '[\x{4e00}-\x{9fff}]'; then
echo "未汉化: $(dirname $f | xargs basename) → $name"
fi
done

Q: 团队共享 Skill 配置怎么办?#

把汉化后的 skills/ 目录提交到 Git 仓库,团队成员 clone 后直接复制 ~/.claude/skills/ 即可。或者用 Symbolic Link 链接到共享目录。

总结#

操作耗时效果
修改 1 个 Skill 的 name10 秒菜单中显示中文说明
批量汉化 30 个 Skill2 分钟(用脚本)所有菜单一目了然
配置按频率排序0(自动)常用 Skill 自动置顶
添加自定义 Skill5 分钟扩展专属能力

一行配置,就能让 AI 编程工具的菜单从”天书”变成”人话”。 这不是花里胡哨的优化,而是实打实的效率提升——再也不用在 30 个英文名字里翻来翻去猜哪个是你要用的了。

下次打开 Claude Code,输入 / 的那一刻,你会感谢自己花了这两分钟。

文章分享

如果这篇文章对你有帮助,欢迎分享给更多人!

Claude Code Skill 菜单中文汉化指南:一行配置解决英文菜单痛点
https://boke.hackerdream.xyz/posts/claude-code-skill-menu-localization/
作者
晴天
发布于
2025-02-20
许可协议
CC BY-NC-SA 4.0
Profile Image of the Author
晴天
Hello, I'm 晴天.
公告
欢迎来到我的博客!这是一则示例公告。
音乐
封面

音乐

暂未播放

0:00 0:00
暂无歌词
分类
标签
站点统计
文章
125
分类
17
标签
287
总字数
257,955
运行时长
0
最后活动
0 天前

目录