通义灵码：Skill 安装和使用
概述
通义灵码支持通过复制文件夹的方式添加自定义 Skill。推荐使用 remote-repo-copy 工具一键拉取团队 Skill 仓库并复制到目标目录，无需手动下载；复制完成后重启 IDE 即可在对话中调用。
一、使用 remote-repo-copy 复制
remote-repo-copy 是一个 CLI 工具：自动克隆远程 Skill 仓库到临时目录，再按配置把文件或目录复制到目标文件夹，复制完成后自动清理临时目录。
目录级别
- 项目级：
.lingma/skills/，仅当前项目生效 - 用户级：
~/.lingma/skills/，当前用户的所有项目生效 - 项目级优先级高于用户级；同时兼容
.agents/skills/目录
1. 安装工具
环境要求：Node.js >= 16.7、已安装 Git 并加入 PATH。
npm i -g remote-repo-copy2. 一键复制（项目级，推荐）
在项目根目录执行：
remote-repo-copy run零配置内置：拉取 https://gitee.com/WilliamHao/skills.git 的 main 分支，把仓库根目录全部内容复制到当前目录下的 .lingma/skills（同时复制到 .opencode/skills、.dsh/skills，供其他 AI 工具使用）。执行完成后结构如下：
.lingma/skills/vue-code-review/SKILL.md
.lingma/skills/vue-best-practices/SKILL.md
...3. 复制到用户级（自定义配置）
先导出内置默认配置：
remote-repo-copy init -c ./remote-repo-copy.config.json将 mappings 中的 to 修改为用户级目录的绝对路径：
{
"repoUrl": "https://gitee.com/WilliamHao/skills.git",
"branch": "main",
"mappings": [
{ "from": ".", "to": "/Users/<用户名>/.lingma/skills" }
]
}再指定配置执行：
remote-repo-copy run -c ./remote-repo-copy.config.json4. 常用参数
--repo-url <url>/--branch <name>：临时覆盖仓库地址与分支--keep-cache：保留临时克隆目录（默认自动清理）- 配置中设置
"clean": true：复制前清空目标目录，可清除已删除 Skill 的残留文件
二、Skill 地址
| 名称 | 内网地址 | 外网地址 | 描述 |
|---|---|---|---|
| vue-code-review | 瑶光代码仓：skills | vue-code-review | 按照团队规范自动审查代码，检查潜在问题和最佳实践 |
| vue-best-practices | 瑶光代码仓：skills | vue-best-practices | Vue.js 任务必用，Composition API 配合 <script setup> 和 TypeScript 的标准方案 |
| vue-debug-guides | 瑶光代码仓：skills | vue-debug-guides | Vue 3 调试和错误处理，包括运行时错误、警告、异步失败和 SSR/水合问题 |
| vue-pinia-best-practices | 瑶光代码仓：skills | vue-pinia-best-practices | Pinia 状态管理最佳实践、常见陷阱和 Store 模式 |
| vue-router-best-practices | 瑶光代码仓：skills | vue-router-best-practices | Vue Router 4 模式、导航守卫、路由参数和路由组件生命周期交互 |
| ant-design-vue | 瑶光代码仓：skills | ant-design-vue | Ant Design Vue 组件库全面指导，适用于使用 Vue 3 和 Ant Design 构建企业级 UI |
| element-plus-skills | 瑶光代码仓：skills | element-plus-skills | Element Plus 组件、主题、国际化、暗黑模式和设计规范 |
| tailwind-css-patterns | 瑶光代码仓：skills | tailwind-css-patterns | Tailwind CSS 实用优先样式模式，包括响应式设计、布局工具和现代 CSS 最佳实践 |
| web-design-guidelines | 瑶光代码仓：skills | web-design-guidelines | 根据 Web 界面指南评审 UI 代码，检查可访问性、审计设计和 UX |
三、重启 IDE 生效
复制完成后重启 IDE，通义灵码会在启动时自动扫描 Skill 目录并加载所有有效技能。
验证加载
重启后可在对话输入框中输入 /，查看已加载的 Skills 列表。
四、使用 Skill
方式一：自动触发
直接描述需求，模型会根据 Skill 的 description 字段自动判断是否调用。
示例：
帮我审查一下这段 Vue2 代码
如果已加载 vue-code-review Skill 且其 description 中包含“代码审查”“review”等关键词，模型会自动调用该 Skill。
方式二：手动触发
输入 /skill-name 直接调用指定 Skill：
/vue-code-review五、常见问题
Skill 未生效？
请依次排查：
- 确认目录路径正确：
.lingma/skills/<skill-name>/SKILL.md - 确认
SKILL.md文件头部包含有效的 YAML frontmatter（name和description字段） - 确认文件夹名与 frontmatter 中的
name一致 - 重启 IDE 后重新检查
同名的项目级和用户级 Skill 会冲突吗？
不会。项目级 Skill 会覆盖用户级的同名 Skill。
可以复制多个 Skill 吗？
可以。仓库中的所有 Skill 都在同一目录下，执行一次 remote-repo-copy run 即把全部 Skill 复制到目标目录，无需逐个操作。
目标目录有已删除 Skill 的残留文件怎么办？
在配置文件中设置 "clean": true，复制前会先清空目标目录。注意该操作不可恢复，首次使用建议先备份。
Skill 文件夹中的脚本如何被调用？
当模型触发某个 Skill 后，会根据 SKILL.md 中的指令说明，按需读取附加文档或运行 scripts/ 目录下的脚本。脚本以相对路径引用，因此复制时必须保留整个文件夹结构，不可拆散复制。
注意事项
- 执行前先确认所在目录：配置中的相对路径基于执行命令时的工作目录解析。
- 谨慎使用
"clean": true，它会清空整个目标目录。 - 克隆内网或私有仓库时，需确保当前 Git 已配置访问权限（SSH key 或 HTTPS 凭证）。
- 项目级与用户级同时存在时，优先使用项目级配置。