TuriX Skills技能系统教程：用Markdown手册教会“数字牛马“点星GitHub（附可直接套用的模板）-开发者社区

TuriX Skills技能系统教程：用Markdown手册教会"数字牛马"点星GitHub（附可直接套用的模板）

【免费下载链接】TuriX-CUAThis is the official website for TuriX Computer-use-Agent项目地址: https://gitcode.com/gh_mirrors/tu/TuriX-CUA

TuriX-CUA是一个会"看屏幕、动鼠标"的计算机使用智能体（Computer Use Agent，简称 CUA），而它的TuriX Skills 技能系统允许你用一篇普通的 Markdown 手册，把操作经验"教"给 AI——从打开浏览器、搜索 GitHub，到最后点下 Star 按钮，全程自动完成。本文手把手带你配置 Skills 系统，并附一份可直接套用的 Skill 模板，零基础 5 分钟上手。

什么是 TuriX Skills 技能系统？

一句话概括：Skills 就是写给 AI 看的"操作手册"，每个技能是一个带 YAML 头的 Markdown 文件，存放在项目的 skills/ 目录下。

系统内置了一个示例技能 github-web-actions.md，它教会 AI：

导航 GitHub 时先打开浏览器、新建标签页
用站内搜索找仓库和用户
点星前先确认 Star 按钮状态（Starred vs Star）
没有明确要求时，不擅自创建 issue、PR 或评论

这套"核心流程 + 安全检查"的写法，正是 TuriX Skills 技能系统的精髓。

它是如何生效的？加载逻辑在 src/utils/skills.py：

启动时扫描skills_dir下所有.md文件，解析出name和description，形成"技能目录"
Planner（规划器）只根据 name/description 挑选与任务相关的技能
Brain（大脑）拿到完整手册内容，逐步对照执行（相关提示词见 src/agent/prompts.py）

3步实操：让"数字牛马"自动点星 GitHub

第1步：获取项目并安装

git clone https://gitcode.com/gh_mirrors/tu/TuriX-CUA cd TuriX-CUA pip install -r requirements.txt

第2步：打开 Skills 开关

编辑 examples/config.json，确认这几项配置：

{ "agent": { "use_plan": true, "use_skills": true, "skills_dir": "skills", "skills_max_chars": 4000 } }

⚠️ 注意：use_plan必须为true。技能选择依赖 Planner 完成，关闭规划器时系统会跳过技能选择（日志会提示 "Skills enabled but planner is disabled"）。

第3步：下发任务

把config.json中的task改成一句话：

"open Chrome, go to github, and search for turix-cua in the github webpage. Enter the TuriX-CUA repository, and star it."

然后运行入口 examples/main.py：

python examples/main.py

执行时你会看到 AI 自动完成：开浏览器 → 进 GitHub → 搜索仓库 → 进入页面 → 点星 → 确认按钮状态 ✅。整个过程与内置技能手册里的每一步严格对应。

可直接套用的模板：写出你的第一个自定义 Skill

新建一个skills/我的技能.md文件，复制下面模板即可（字段缺一不可，否则会被加载逻辑跳过）：

--- name: my-first-skill description: Use when 执行XXX任务（写清楚"什么时候用"） --- # 技能标题 ## Core workflow - 第1步：先做什么（例如：先打开目标应用） - 第2步：然后做什么 - 第3步：核对结果 ## Safety and checks - 重要操作前先向用户确认（如登录、提交表单） - 操作后核对目标状态，再进入下一步

三个关键字段各司其职：

字段	作用	谁在看
`name`	技能唯一标识	Planner 用它挑选技能
`description`	触发场景描述，写得越精准选得越准	Planner
正文（body）	完整操作指南	Brain 逐步执行