企业官网建设流程全解析

Qwen Code 技能系统完全指南：从 0 到 1 打造你的智能开发助手

【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code

Qwen Code 的技能系统（Skills）能把一段反复执行的工作流程，打包成模型可以自己判断、自己调用的能力。它不是一堆手动敲的命令，而是一套让智能开发助手「懂你团队习惯」的机制：把个人经验、团队规范写进一个个SKILL.md，助手会在合适的时机自动把它拿起来用。

一、为什么你的团队需要一个技能系统 📁

先看一个很常见的场景：团队里每个人提交代码前，都要跑一遍同样的动作——检查代码风格、找安全漏洞、给 PR 挑毛病。这些规则每次都在提示词里重复交代，新人来了还得口头再讲一遍。

把这些规则固化成一个技能后，事情变了：你只需要说「帮我审查这个 PR」，助手就会自动按团队约定去查。

技能系统的价值就在这三点上：

• 省掉重复提示：规则写一次，处处生效，不用每轮对话重新描述
• 经验可传承：老手踩过的坑、团队的隐性规范，变成了仓库里的文件
• 助手更聪明：模型能根据你说的话，自己决定该不该用、用哪一个

想深入了解技能的设计与实现，可以读 官方技能文档 和 技能源码。

二、技能是怎么被调起来的

很多人以为技能要靠手动触发。其实 Qwen Code 里技能的默认调用方式，和斜杠命令正好相反。

• 斜杠命令是你主动敲/命令触发的
• 技能是模型自己决定要不要用的，依据是你说的话和技能的description

也就是说，你不需要记住任何调用语法。你只要描述任务，模型会把它和当前可用的技能做匹配，觉得对得上就调起来。

背后的流程分三步：

1. 发现：启动时扫描所有技能目录，把SKILL.md的元信息读进来
2. 匹配：把你的请求和每个技能的描述做关联分析
3. 调用：模型判断该用哪一个，自动载入它的完整说明去执行

如果确实想手动指定，输入/<技能名>也能直接跑。用/skills可以打开技能面板，浏览、搜索、开关技能。

三、从 0 到 1：搭建你的第一个技能

个人技能 vs 项目技能怎么选

技能按存放位置分两种，选哪种取决于它「属于谁」。

一句话原则：跟你走的是个人技能，跟项目走的是项目技能。文档处理、数据分析这类通用能力，放个人目录；「我们的部署流程」「本项目的测试规范」，放项目目录，提交到 git 后队友自动就有。

写好 SKILL.md 的三个关键

每个技能就是一个目录，里面放一个SKILL.md。这个文件分两部分：顶部的 YAML frontmatter（元信息），下面的 Markdown（具体指令）。

--- name: code-reviewer description: 审查代码质量、安全漏洞与最佳实践。当用户请求代码审查、代码检查或 PR 复查时使用。 --- # 代码审查助手 ## 指令 - 先扫描指定文件，按风格、安全、性能三类问题归类 - 给出具体行号与修改建议 - 输出一份简短的审查报告

写好它，主要抓三个点：

1. name要能当标识用：用短横线小写英文，如code-reviewer，别带空格和特殊字符
2. description要写清「做什么 + 什么时候用」：这是模型判断调不调用的唯一依据，越具体越好
3. 正文给出可执行的步骤：告诉助手具体怎么做、按什么顺序、输出长什么样，别只写空泛口号

创建并验证你的技能

创建本身很简单：建目录、写文件。

mkdir -p .qwen/skills/code-reviewer

在.qwen/skills/code-reviewer/下放入上面那个SKILL.md，保存即可。会话中 Qwen Code 会监听技能目录，改完稍等片刻就会自动刷新，不用重启。

验证也很直接——用一句和描述对得上的话去问，比如「帮我审查这个项目的代码质量」。如果描述里写了「PDF」，那就用「帮我从这份 PDF 提取文字」来测。模型若觉得匹配，就会自动把技能调起来，你不用手动敲任何东西。

懒得从零手写？还有/learn命令能把一个已有文档、本地目录甚至一段流程描述，直接提炼成一个项目技能，省去排版成本。

四、进阶与协作

技能没被调用时查这三处 🔍

技能「安静地不干活」是最常见的问题。按这个顺序查，基本能定位：

1. 描述太宽泛：description写成「帮助处理文档」这种，模型根本不知道何时该用。补上具体关键词，比如「提取 PDF 文字、填表单、合并文档，处理 PDF 或表单时使用」。
2. 路径放错了：个人技能要在~/.qwen/skills/<名字>/SKILL.md，项目技能要在.qwen/skills/<名字>/SKILL.md，少一层目录就加载不到。
3. YAML 写坏了：开头---得在第 1 行、结尾---要闭合、缩进别用 Tab。一个语法错误会让整段元信息加载失败。

还搞不定就开调试模式跑一遍，能看到技能加载时到底报了什么错：

qwen --debug

把技能交给团队 🤝

项目技能天生就是为共享设计的。把它放进版本控制，就是最顺滑的协作方式：

git add .qwen/skills/ git commit -m "新增代码审查助手技能" git push

队友拉一下代码，技能就自动出现在他的项目里。这里有两个让协作更顺手的细节：

• 保持聚焦：一个技能只干一件事。「PDF 填表」「Excel 分析」是好技能，「文档处理」这种大而全的应该拆开
• 让队友一起测：会不会在预期时机被触发、说明够不够清楚、有没有漏掉的例子，过一遍再推广

技能不是写完就结束的东西。用着用着发现描述不够准、步骤该调整，直接改SKILL.md即可，改动会实时生效。把团队的规范沉淀成技能、再随版本迭代，这套机制才真正跑起来。

挑一个你团队里最高频的重复动作，按上面的目录建好目录、写一个SKILL.md，然后用一句自然的话去触发它——跑通第一个技能，剩下的照着复制就行。

【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code