Qwen Code 技能系统完整教程技能怎么创建、怎么调用、怎么排查【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code每个周五下午你都要让 AI 帮忙写同一份周报收集团队提交记录、整理本周待办、按团队模板排版后发出去。同一个提示词重复了三周之后你会开始觉得——这套流程其实可以沉淀成一个技能以后直接复用。Qwen Code 的技能系统Skills干的就是这件事把你的工作经验打包成一份模型能读懂的说明书遇到相关请求时由它自动调用不用再反复交代。先懂 Qwen Code 技能系统技能是什么放在哪里 技能就是一份模型能读懂的工作说明书一个技能就是一个目录核心是里面的SKILL.md文件。文件开头是一段配置块术语叫 YAML frontmatter你可以理解为---两条横线之间的一段键值对声明技能叫什么、什么时候用、能用哪些工具后面是用 Markdown 写清做事的步骤、标准和产出格式。说白了这就是一份给 AI 看的工作说明书。模型自主调用不用记命令技能和传统命令最大的区别在于谁来发起。命令是你主动敲出来的而技能是模型自己决定的它接到你的请求后会对照每个技能的描述做判断觉得对得上就把那份SKILL.md的内容读进来、照着执行。你不需要记住技能名用自然语言说任务就行当然想直接调用某个技能时也可以手动输入/技能名强制触发。个人技能 vs 项目技能放对地方技能系统有两个存放位置个人技能放在用户目录~/.qwen/skills/下对你所有项目生效。适合换个项目也用得上的通用能力比如你的行文习惯、通用文档处理流程。项目技能放在项目根目录.qwen/skills/下随项目共享给团队。适合和团队约定强绑定的流程比如周报怎么汇总、发布怎么走。以周报技能为例两种位置长这样~/.qwen/skills/ └── weekly-report-digest/SKILL.md .qwen/skills/ └── weekly-report-digest/SKILL.md技能怎么创建SKILL.md 的三个关键字段 name、description、allowedTools 各管一摊写 frontmatter 时三个字段最关键name技能的唯一标识只供系统识别和调用建议起一个描述性的英文名。description技能的简历说清楚它做什么、什么时候用——这是模型决定调不调用的核心依据别写虚。allowedTools这个技能允许使用的工具白名单比如读文件、跑命令按需最小化授权。完整示例周报汇总助手还是周报这个场景。在技能目录下新建SKILL.md内容如下--- name: weekly-report-digest description: 汇总团队本周提交、改动与待办生成标准周报。适用于写周报、工作总结、站会材料整理场景。 allowedTools: [read_file, shell] --- # 周报汇总助手 ## 工作流程 1. 读取本周的提交记录和分支改动 2. 按模块归类剔除 merge 提交等噪音 3. 输出标准周报本周亮点、进行中、风险项怎么触发、怎么验证生效触发很简单用一句和描述对得上的自然语言比如帮我汇总本周的提交记录写一份周报。如果技能生效模型会先加载这份SKILL.md再按工作流程执行。验证看两点执行过程是否走你写好的流程、产出格式是否是你定义的亮点/进行中/风险项三段。如果没被调用直接看下面这份排查清单。技能不被调用时的排查清单从能用到好用⚠️ 技能库按职能域归类技能攒到十几个之后别堆成一坨。按职能域归组织文档处理一类、代码相关一类、部署运维一类结构上保持一个目录一个技能目录里只放一个SKILL.md。归类时顺手立个原则一个技能只干一件事名叫文档处理的大杂烩技能不如拆成提取文本和排版输出两个小技能。两个常见问题的速查技能不被调用八成是 description 太模糊。Helps with documents这种写法模型完全无法锁定场景改成从 PDF 文件里提取文本和表格处理 PDF 或文档提取任务时使用命中率立刻不一样。其次是核对路径个人技能在~/.qwen/skills/技能名/SKILL.md项目技能在.qwen/skills/技能名/SKILL.md和检查 frontmatter 的 YAML 语法——开头结尾的---是否完整、缩进是否用了制表符配置块解析失败元数据就根本读不进来。权限配置不当allowedTools给最小够用即可。一个只读分析型的技能没必要同时开 shell 和写文件权限先让模型带着读权限跑通流程确认需要了再逐步放开执行和写入。团队协作git 管理 迭代反馈闭环项目技能直接提交进 git把.qwen/skills/加入仓库、提交推送队友拉取代码后自动拥有同一套技能不用互相拷文件。之后建立一个反馈闭环留意哪些技能被频繁调用、哪些从未触发定期复盘使用效果和产出质量再根据真实需求迭代描述与流程。技能是活的文档越用越要打磨。字段的完整规则和进阶选项比如按文件路径触发、优先级排序可以查官方技能配置说明。今天就能做的三件事挑一件你这周最重复的流程周报、晨会材料都算创建第一个个人技能走一遍写描述 → 触发 → 验证的完整流程。盘点团队里大家反复交代的 2~3 条约定做成项目技能并提交到 git。下次技能没被调用先改 description写清做什么 什么时候用模型才会精准命中。关键收获Qwen Code 技能系统的本质是把你的经验写一次、让 AI 自主调用——描述决定它能不能被选中流程决定它用起来有多靠谱。【免费下载链接】qwen-codeAn open-source AI coding agent that lives in your terminal.项目地址: https://gitcode.com/GitHub_Trending/qw/qwen-code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考