# 1. 添加仓库（首次需要）
brew tap workbuddy/tap

# 2. 安装 GUI 版
brew install --cask workbuddy

# 3. 或者只装 CLI
brew install workbuddy-cli

# Windows 10/11 默认带 winget
winget install WorkBuddy.WorkBuddy
winget install WorkBuddy.CLI      # 仅命令行版

# Ubuntu 22.04+ / Debian 12+
curl -fsSL https://pkg.workbuddy.com/key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/workbuddy.gpg
echo "deb [signed-by=/usr/share/keyrings/workbuddy.gpg] https://pkg.workbuddy.com/apt stable main" | sudo tee /etc/apt/sources.list.d/workbuddy.list
sudo apt update && sudo apt install workbuddy

{
  "mcpServers": {
    "internal-crm": {
      "command": "node",
      "args": ["/opt/mcp/internal-crm/dist/index.js"],
      "env": {
        "CRM_TOKEN": "${secret:internal_crm_token}",
        "CRM_BASE": "https://crm.internal.workbuddy.com"
      },
      "description": "公司内部 CRM 数据",
      "permission": "read"
    },

    "weather": {
      "command": "uvx",
      "args": ["mcp-weather-server"]
    }
  }
}

• spawn ENOENT — command 路径不对。绝对路径优先，例如 /usr/local/bin/uvx 而不是 uvx。
• Permission denied: /var/... — macOS 沙箱拦截。系统设置 → 隐私 → 完全磁盘访问 → 启用 WorkBuddy。
• SSL: CERTIFICATE_VERIFY_FAILED — 企业代理替换了证书。导入公司根证书到系统钥匙串。
• Connection timed out (5s) — 网络层没问题但 server 没回包。先 wb mcp test <name> 看启动日志。
• Schema validation failed — server 端 tool 定义不符合 MCP spec 1.0。用 wb mcp schema <name> 检查。
• 401 Unauthorized — token 过期或被回收。重新走 OAuth 流程，或 wb secret rotate <name>。

• 人感开场 — 一段"我是谁、我擅长什么、我会先问什么"的自我介绍，决定 AI 怎么开始对话。
• 工作流剧本 — 把任务拆成 N 步，每步明确输入、动作、输出、确认条件。
• 工具调用约定 — 哪些 MCP / 命令可以用、用之前要不要再确认、敏感数据怎么处理。
• 输出规范 — 表格 / Markdown / PDF / 邮件？要不要署名、要不要附时间戳、要不要带源链接。

expense-audit/
├── SKILL.md             # 必填 · 入口描述（人感开场 + 工作流）
├── prompt.md            # 可选 · 长提示词 / system prompt
├── tools/
│   ├── approve.json      # 工具 schema：审批规则查询
│   └── notify.json       # 工具 schema：邮件通知
├── examples/
│   ├── 01-国内差旅.md     # 真实使用例子（few-shot）
│   └── 02-招待餐.md
├── checks/             # 可选 · 自检脚本
│   └── lint.py
├── README.md           # 给同事看的说明
└── assets/            # logo / 截图 / 模板
    └── flow.png