TuriX Skills技能系统教程用Markdown手册教会数字牛马点星GitHub附可直接套用的模板【免费下载链接】TuriX-CUAThis is the official website for TuriX Computer-use-Agent项目地址: https://gitcode.com/gh_mirrors/tu/TuriX-CUATuriX-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.py3步实操让数字牛马自动点星 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.pypython 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 逐步执行4条写作技巧让 AI 更听话这些建议来自官方 Clawdbot 集成技能文档 的开发经验description 要精准—— Planner 只凭它选技能模糊的描述 手册白写步骤写具体但不写坐标—— 告诉它点击 Star 按钮而不是点击 (842, 135)一定加安全检查—— 参考内置技能登录前询问用户、点星前确认按钮状态保持简短—— 正文超过skills_max_chars默认 4000 字符会被截断核心内容放前面相关模块速查skills/github-web-actions.md —— 内置的 GitHub 操作技能点星、搜索src/utils/skills.py —— 技能解析、加载、格式化的核心源码src/agent/service.py —— Agent 主循环Planner 选定技能后注入 Brainsrc/agent/planner_service.py —— 规划器任务拆解与技能预选examples/config.json —— Skills 开关与技能目录配置OpenCLaw_TuriX_skill/SKILL.md —— 面向 Clawdbot 的完整 TuriX 技能教程OpenCLaw_TuriX_skill/scripts/run_turix.sh —— 一行命令启动任务的辅助脚本常见问题 FAQQ为什么 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
