Qwen Code 技能系统完全指南从 0 到 1 打造你的智能开发助手【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-codeQwen Code 的技能系统Skills能把一段反复执行的工作流程打包成模型可以自己判断、自己调用的能力。它不是一堆手动敲的命令而是一套让智能开发助手「懂你团队习惯」的机制把个人经验、团队规范写进一个个SKILL.md助手会在合适的时机自动把它拿起来用。一、为什么你的团队需要一个技能系统 先看一个很常见的场景团队里每个人提交代码前都要跑一遍同样的动作——检查代码风格、找安全漏洞、给 PR 挑毛病。这些规则每次都在提示词里重复交代新人来了还得口头再讲一遍。把这些规则固化成一个技能后事情变了你只需要说「帮我审查这个 PR」助手就会自动按团队约定去查。技能系统的价值就在这三点上省掉重复提示规则写一次处处生效不用每轮对话重新描述经验可传承老手踩过的坑、团队的隐性规范变成了仓库里的文件助手更聪明模型能根据你说的话自己决定该不该用、用哪一个想深入了解技能的设计与实现可以读 官方技能文档 和 技能源码。二、技能是怎么被调起来的很多人以为技能要靠手动触发。其实 Qwen Code 里技能的默认调用方式和斜杠命令正好相反。斜杠命令是你主动敲/命令触发的技能是模型自己决定要不要用的依据是你说的话和技能的description也就是说你不需要记住任何调用语法。你只要描述任务模型会把它和当前可用的技能做匹配觉得对得上就调起来。背后的流程分三步发现启动时扫描所有技能目录把SKILL.md的元信息读进来匹配把你的请求和每个技能的描述做关联分析调用模型判断该用哪一个自动载入它的完整说明去执行如果确实想手动指定输入/技能名也能直接跑。用/skills可以打开技能面板浏览、搜索、开关技能。三、从 0 到 1搭建你的第一个技能个人技能 vs 项目技能怎么选技能按存放位置分两种选哪种取决于它「属于谁」。类型目录适用场景个人技能~/.qwen/skills/跨所有项目通用的工作流、你个人的习惯项目技能.qwen/skills/团队约定、项目专属流程、共享脚本一句话原则跟你走的是个人技能跟项目走的是项目技能。文档处理、数据分析这类通用能力放个人目录「我们的部署流程」「本项目的测试规范」放项目目录提交到 git 后队友自动就有。写好 SKILL.md 的三个关键每个技能就是一个目录里面放一个SKILL.md。这个文件分两部分顶部的 YAML frontmatter元信息下面的 Markdown具体指令。--- name: code-reviewer description: 审查代码质量、安全漏洞与最佳实践。当用户请求代码审查、代码检查或 PR 复查时使用。 --- # 代码审查助手 ## 指令 - 先扫描指定文件按风格、安全、性能三类问题归类 - 给出具体行号与修改建议 - 输出一份简短的审查报告写好它主要抓三个点name要能当标识用用短横线小写英文如code-reviewer别带空格和特殊字符description要写清「做什么 什么时候用」这是模型判断调不调用的唯一依据越具体越好正文给出可执行的步骤告诉助手具体怎么做、按什么顺序、输出长什么样别只写空泛口号创建并验证你的技能创建本身很简单建目录、写文件。mkdir -p .qwen/skills/code-reviewer在.qwen/skills/code-reviewer/下放入上面那个SKILL.md保存即可。会话中 Qwen Code 会监听技能目录改完稍等片刻就会自动刷新不用重启。验证也很直接——用一句和描述对得上的话去问比如「帮我审查这个项目的代码质量」。如果描述里写了「PDF」那就用「帮我从这份 PDF 提取文字」来测。模型若觉得匹配就会自动把技能调起来你不用手动敲任何东西。懒得从零手写还有/learn命令能把一个已有文档、本地目录甚至一段流程描述直接提炼成一个项目技能省去排版成本。四、进阶与协作技能没被调用时查这三处 技能「安静地不干活」是最常见的问题。按这个顺序查基本能定位描述太宽泛description写成「帮助处理文档」这种模型根本不知道何时该用。补上具体关键词比如「提取 PDF 文字、填表单、合并文档处理 PDF 或表单时使用」。路径放错了个人技能要在~/.qwen/skills/名字/SKILL.md项目技能要在.qwen/skills/名字/SKILL.md少一层目录就加载不到。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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考