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：

1. 启动时扫描skills_dir下所有.md文件，解析出name和description，形成"技能目录"
2. Planner（规划器）只根据 name/description 挑选与任务相关的技能
3. 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 - 重要操作前先向用户确认（如登录、提交表单） - 操作后核对目标状态，再进入下一步

三个关键字段各司其职：

4条写作技巧：让 AI 更"听话"

这些建议来自官方 Clawdbot 集成技能文档 的开发经验：

1. description 要精准—— Planner 只凭它选技能，模糊的描述 = 手册白写
2. 步骤写具体，但不写坐标—— 告诉它"点击 Star 按钮"，而不是"点击 (842, 135)"
3. 一定加安全检查—— 参考内置技能：登录前询问用户、点星前确认按钮状态
4. 保持简短—— 正文超过skills_max_chars（默认 4000 字符）会被截断，核心内容放前面

相关模块速查

• skills/github-web-actions.md —— 内置的 GitHub 操作技能（点星、搜索）
• src/utils/skills.py —— 技能解析、加载、格式化的核心源码
• src/agent/service.py —— Agent 主循环：Planner 选定技能后注入 Brain
• src/agent/planner_service.py —— 规划器：任务拆解与技能预选
• examples/config.json —— Skills 开关与技能目录配置
• OpenCLaw_TuriX_skill/SKILL.md —— 面向 Clawdbot 的完整 TuriX 技能教程
• OpenCLaw_TuriX_skill/scripts/run_turix.sh —— 一行命令启动任务的辅助脚本

常见问题 FAQ

Q：为什么 AI 没按我的手册执行？检查两点：① 文件是否缺少name/description（缺失会被跳过）；②skills_dir是否指向了正确目录（支持相对config.json或相对项目根目录两种解析方式，见 examples/main.py）。

Q：不开 Skills 会怎样？use_skills: false时 AI 纯靠"直觉"操作，遇到固定流程的任务容易跑偏；开启后成功率更稳定，这正是技能系统的价值所在。

Q：手册写得超长可以吗？建议控制在 4000 字符内；超出部分会被截断并标记[Truncated]（src/utils/skills.py）。

到这里，你已经掌握了 TuriX Skills 技能系统的完整玩法：一份 Markdown 手册 + 三行配置，就能把 AI 变成懂规矩的"数字牛马"。下一步，试着为你的常用网站（比如内部系统、订票页面）写一份专属 Skill 吧 🚀

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