如何一步步把技能导入 Claude Code

Claude Code 把你的仓库当作智能体的工作区,这让它是文件型技能最友好的平台。本指南带你在五分钟内安装一个 SkillVault 的 .aiskill 配置。

第一步 —— 下载技能

登录后在任意技能页下载 .aiskill 文件 —— 例如 Code Review Assistant。文件是纯 JSON;打开看一眼 prompts.system 区块和 variables 列表。

第二步 —— 选择接入方式

你有两个选项,而且可以组合使用:

方案 A:项目技能文件。 把原始文件保留在仓库里,人和智能体都能读:

.claude/
  skills/
    code-review-assistant.json

方案 B:斜杠命令。 在 .claude/commands/review.md 创建一个 Markdown 命令,把系统提示词粘贴为正文。此后在该项目的任意会话里,/review 即可调用这个技能。

很多团队两者都用:JSON 作为唯一事实来源,命令作为顺手的人口。

第三步 —— 填充用户模板

复制 prompts.user_template,把 {{变量}} 替换为真实内容 —— 待审查的代码、语言、你的关注点。当模板对「完成标准」描述得足够明确时,Claude Code 的表现最好,所以请保留技能的输出格式指令。

第四步 —— 版本管理

把 .claude/skills/ 纳入 git。当技能在 SkillVault 更新时,重新下载、diff、提交 —— 和管理依赖同样的纪律。技能的 version 和 tested_environment 字段会告诉你,升级是否影响你依赖的行为。

故障排查

• 技能好像被忽略了 —— 检查命令文件是否在粘贴时不慎被截断;长提示词在粘贴时被切断的概率远大于运行时。
• 输出中出现字面量 {{variable}} —— 发送前有占位符没有替换。
• 不同机器行为不一致 —— 有人改了本地副本。集中管理文件并重新同步。

第一个技能装好之后,技能库里的其余技能都是即插即用的。开始构建吧。