WorkBuddy Skill 入门：从零到一写出你的第一个自动化技能
引言
WorkBuddy 是今年最值得关注的桌面 AI 助手——它和 ChatGPT 最大的区别在于：能直接操控你的文件系统和浏览器。
上周我用它的 Skill 系统写了一个 OUCHN 教育平台自动化脚本：每天自动浏览 96 页课程、批改 62 份作业。全程不需要我碰鼠标。
这篇文章就把踩过的坑、学到的经验，完整分享给你。
1. WorkBuddy 是什么
WorkBuddy = AI + 本地操作系统。具体来说它能：
- 读写本地文件、执行 Python/Shell 脚本
- 通过 CDP 协议接管 Chrome/Edge 浏览器
- 定时自动化任务（相当于本地 cron）
- 通过 Skill 系统封装可复用的工作流
核心价值：ChatGPT 只能给你答案，WorkBuddy 能替你干活。
2. 什么是 Skill
Skill 本质上是一个 Markdown 文件（SKILL.md），放在特定目录下。当你的指令命中触发词时，SKILL.md 的完整内容会被注入到 AI 上下文中，指导它按你规定的方式执行。
实际触发流程
你说："帮我批改下今天的作业"
↓
WorkBuddy 识别关键词 → 加载自动化 Skill
↓
AI 读取 SKILL.md → 知道用 Playwright 连接本地 Edge:9222
↓
按 Skill 记录的批改流程一步步执行
有了 Skill 之后，不需要每次都跟 AI 解释怎么做。 它就是你沉淀经验的容器。
3. SKILL.md 的结构
一个标准 Skill 由三部分组成：
3.1 前置元数据（YAML）
---
name: my-automation
description: 我的自动化任务
version: 1.0.0
triggers:
- 自动化
- 自动批改
---
| 字段 | 说明 |
|---|---|
name | 唯一标识，用英文 |
description | 一句话描述，AI 用来判断是否加载 |
version | 语义化版本号 |
triggers | 触发关键词，命中任一即加载 |
3.2 工作流指令（核心）
## 日常运行
1. 确保调试浏览器已启动（端口 9222）
2. 运行主脚本：`venv\Scripts\python.exe main.py`
3. 如遇 Cookie 失效：手动登录后重新运行
写作诀窍：用步骤列表，不要写散文；每步给出确切命令；失败场景单独写。
3.3 附录
## 常见问题
| 问题 | 解决方法 |
|------|----------|
| Cookie 失效 | 手动登录后重跑 |
| 端口占用 | taskkill /F /IM msedge.exe |
4. 从零创建第一个 Skill
Step 1：确定存储位置
| 级别 | 路径 | 范围 |
|---|---|---|
| 用户级 | ~/.workbuddy/skills/<name>/ | 所有项目可用 |
| 项目级 | <workspace>/.workbuddy/skills/<name>/ | 仅当前项目 |
建议：通用技能放用户级，项目专属放项目级。
Step 2：写 SKILL.md
最少包含 triggers + 运行方式即可开始测试。
Step 3：持续迭代
每次跑完一个复杂任务，把新发现的坑写进 Skill。 这是 Skill 系统最核心的价值——经验不会丢失。
5. 实战：让 Skill 真正可靠
5.1 配置区独立
## 配置
| 参数 | 值 | 说明 |
|------|-----|------|
| CDP 端口 | 9222 | Edge 调试端口 |
| 目标页数 | 100 | 每天浏览目标 |
| 评分区间 | 65-92 | 批改分数范围 |
5.2 失败路径必须写清楚
不只是"怎么做"，更要写"失败怎么办"：
## Cookie 失效处理
1. 访问平台首页，被重定向到 login → Cookie 已失效
2. 用户手动登录（含短信验证码）
3. 脚本自动保存新 Cookie
4. 重跑即可恢复
5.3 维护执行日志
| 日期 | 状态 | 浏览 | 批改 | 备注 |
|------|------|------|------|------|
| 06-24 | 成功 | 96页 | 62份 | 角色筛选修复 |
| 06-15 | 成功 | 26页 | 47份 | Cookie 续期 |
5.4 云端共享方案
云端（腾讯乐享）
└── ouchn_auto_scripts.zip
├── main.py
├── setup_venv.py
└── start_browser.bat
终端 A 终端 B
├── venv/（独立） ├── venv/（独立）
├── cookies.json ├── cookies.json
└── main.py ← 云端拉取 └── main.py ← 云端拉取
原则：源码云端唯一，运行环境和登录态各终端独立。
6. 小结
| 你学会的 | 要点 |
|---|---|
| Skill 是什么 | AI 可加载的操作手册 |
| SKILL.md 结构 | 元数据 + 工作流 + 排查表 |
| 可靠性技巧 | 写失败路径、维护日志、配置独立 |
下一篇预告
第 2 节：CDP 浏览器操控原理——Chrome DevTools Protocol + Playwright，Angular scope 注入，Cookie 持久化管理。敬请期待！
本文首发于稀土掘金。作者在 WorkBuddy 上实战运行自动化脚本超 100 次，踩坑无数，总结经验分享。欢迎关注后续连载。
