Scan to join WeChat groupWorkBuddy 使用指南
本技能是一个打包好的 WorkBuddy 参考手册，安装后开箱即用。
🚀 新手学习路径（45分钟搞定）
第一次使用 WorkBuddy？按这个顺序来，约 45 分钟完成全部配置。
第1步：立规矩（5分钟）
→ 阅读 卡片7，按聊天式引导完成 Soul.md 配置
→ 输出：~/.workbuddy/SOUL.md 已生成
第2步：学下指令（10分钟）
→ 阅读 09-prompting-best-practices.md，掌握任务交代五要素
→ 验证：用一条结构化 Prompt 让 WorkBuddy 一次完成一个简单任务
第3步：连第一个工具（10分钟）
→ 阅读 卡片1，完成任意一个 MCP 连接器配置
→ 验证：工具调用成功一次
第4步：创建第一个专家（10分钟）
→ 阅读 卡片2，用三步法创建你的第一个自定义专家
→ 验证：专家出现在列表中，能正常对话
第5步：选对模式（5分钟）
→ 阅读 10-interaction-modes.md，理解 Ask/Plan/Craft 区别
→ 验证：日常用 Craft，不确定时切回 Ask 或 Plan
第6步：跑一次诊断（5分钟）
→ 运行 scripts/check_env.py，确认环境无异常
→ 输出：诊断报告显示 ✅
完成以上6步 → 你已经可以日常使用 WorkBuddy 了！ 遇到问题 → 从上到下按 速查卡 → 深度文档 → 官方文档 检索
三层检索体系（🚀 升级版）
用户提问 WorkBuddy 相关问题
│
▼
[第1层] 场景速查 → references/05-quick-cards.md
7张"问题-解决方案-验证"卡片，3分钟内定位修复
│
│ 无匹配 ↓
▼
[第2层] 深度文档 → references/ 目录
├── troubleshooting.md 🆕 跨领域综合诊断决策树
├── 01-architecture.md 架构认知、核心概念
├── 02-connector-troubleshooting.md 连接器排查（含错误码对照表）
├── 03-expert-workflow.md 专家创建修改（含Prompt设计模式）
├── 04-automation-patterns.md 自动化配置（含RRULE模板库）
├── 06-scenario-examples.md 🆕 22个真实场景案例
├── 07-advanced-practice.md 🆕 进阶工作习惯（工作空间/任务管理/探索复用/Claw远程）
├── 08-glossary.md 📖 术语表（MCP/RRULE/Soul.md等核心概念速查）
├── 09-prompting-best-practices.md 🆕 提示词最佳实践（五要素/会话管理/质量自检）
├── 10-interaction-modes.md 🆕 交互模式与通道（Ask/Plan/Craft/助理/小程序）
├── 11-memory-system.md 🆕 记忆系统详解（Cloud/Local/Workspace三层架构）
├── 12-faq.md 📖 常见问答（Q&A结构，覆盖连接器/自动化/专家/记忆/模型边界问题）
├── 13-teams-collaboration.md 🆕 Teams团队协作（项目/看板/资产库/任务流转/消息中心）
└── 14-scene-modes.md 🆕 场景模式与工作界面（办公/开发/设计 + 布局）
│
│ 无匹配 / 涉及最新版本 ↓
▼
[第3层] 官方文档 → WebFetch
├── https://www.codebuddy.cn/docs/workbuddy/Overview
├── https://www.codebuddy.cn/docs/workbuddymini/quick-start/Overview
└── https://www.codebuddy.cn/docs/workbuddy/Changelog
参考文件索引
| 场景 | 读取文件 | 新增亮点 |
|------|---------|---------|
| 🆕 综合诊断 | references/troubleshooting.md | 跨领域决策树、一键诊断命令、上报信息模板 |
| 架构认知 | references/01-architecture.md | 核心概念、七层定制化体系（Memories→Skills→Automations→Connectors→Experts→Expert Teams→Teams）、常见误区 |
| MCP/连接器故障 | references/02-connector-troubleshooting.md | 错误码对照表、日志分析、代理修复、逐步骤排查 |
| 专家创建/修改 | references/03-expert-workflow.md | Prompt设计模式(A/B/C)、Team SOP指南、格式错误修复 |
| 自动化配置 | references/04-automation-patterns.md | RRULE模板库、场景模板(6个)、故障排查、编写规范 |
| 快速查问题 | references/05-quick-cards.md | 7张卡片含新手引导，每张含验证步骤 + 错误码修复表 |
| 🆕 场景案例 | references/06-scenario-examples.md | 22个真实案例（通用+职场职能+IMA+腾讯文档） |
| 🆕 进阶习惯 | references/07-advanced-practice.md | 工作空间分区/任务管理/探索复用/专家vsSkill/Claw远程 |
| 📖 术语表 | references/08-glossary.md | 核心概念速查（MCP/RRULE/SOP/Soul.md/模型/网络安全等） |
| 🆕 提示词实践 | references/09-prompting-best-practices.md | 任务交代五要素、会话管理、常见误区、质量自检清单 |
| 🆕 交互模式 | references/10-interaction-modes.md | Ask/Plan/Craft 三种模式、权限管理、三条交互通道 |
| 🆕 记忆系统 | references/11-memory-system.md | 三层记忆架构（Cloud/Local/Workspace）、画像管理、隐私控制 |
| 📖 常见问答 | references/12-faq.md | Q&A 结构，覆盖连接器/自动化/专家/记忆/模型/IMA/Teams 边界问题 |
| 🆕 Teams 协作 | references/13-teams-collaboration.md | 项目创建、看板、资产库、数据源、任务流转、消息中心 |
| 🆕 场景模式 | references/14-scene-modes.md | 办公/开发/设计三种场景、快捷方式联动、界面布局 |
| 手工诊断 | scripts/check_env.py | 🆕 一键环境诊断脚本（自动检测代理/连接器/专家/日志） |
| 关键词搜索 | scripts/quick-search.sh | 在知识库中 grep 关键词，快速定位相关文档（Windows 需 Git Bash） |
难度标记：🔴 新手必读（卡片1/2/7） 🟡 进阶（卡片3/4） 🟢 高级（卡片5/6）
使用规范
- 检索优先级：快速卡 → 深度文档 → 官方文档（不要跳层）
- 读取粒度：先用 Grep 定位关键词，再读取对应段落，避免全文件加载
- 诊断工具：复杂环境问题先运行
python scripts/check_env.py获取全局状态 - 更新维护：发现新踩坑经验时，追加到对应文件的"踩坑经验"区域
- 只读操作：本技能参考文件不修改用户项目文件，仅提供检索和回答
- 聊天式分步引导（来自新手指南）：引导用户配置时，每次只问1个问题，不给表格；等用户回答后再问下一个；确认时只问"OK 还是改？"
- Soul.md 六条规矩书（基于四大支柱：核心性格 + 说话方式 + 工作原则 + 红线，可复用）：
- 第一条：核心性格 — 用 2-3 句话定义 AI 是谁（身份/职业/核心价值），作为所有回答的性格兜底
- 第二条：说话方式 — 明确该说什么、不该说什么。消除 AI 味：禁止"好的呢~""您说得太对了""感谢您的提问"等客套话，按用户偏好切换命令式/分析式/轻松感
- 第三条：工作原则 — 3-5 条铁律保证专业度：带着方案来、干完活顺手复盘、一次到位不反复确认、不确定就说"不确定"但先给最可能答案
- 第四条：嘴严 — 隐私/文件/聊天记录/未公开内容绝不泄露，敏感信息不记录不转述
- 第五条：红线禁区 — 法务合规底线 + 用户个人雷区（特定话题/语气/内容类型），绝不越界
- 第六条：持续进化 — AI 出主意、用户做决定；每次互动都是学习机会，随时用"你应该…""不要…"修正规则；开启全局记忆，长期积累偏好
- Soul.md 互动采集流程（聊天式，每次只问 1 个问题）：
- 启动："准备好了吗，让我来修改你的性格档案"
- Q1 → 你希望我说话什么风格？（命令式/分析式/轻松/严肃…）
- Q2 → 有没有你特别讨厌的回答方式？（具体举例，如"不要客套话"）
- Q3 → 工作中有什么原则是你特别看重的？（"拿不准先问""不要省略步骤"…）
- Q4 → 有没有绝对不能碰的红线？（内容类型/语气/合规边界）
- 生成 Soul.md → 展示确认 → "OK 还是改？" → 写入 ~/.workbuddy/SOUL.md
- 后续维护：随时用"你要…""你应该…""不要…"句式微调规则，无需重新走完整流程
- 按职业推荐技能包（可复用为快速配置模板）：
- 通用必装：Skill安全扫描、Agent Browser、AI绘图、PDF生成、Word生成、PPT生成
- 自媒体/内容运营：小红书图文发布、微信公众号发布、AI写作助手
- 企业培训：AI视频生成、Excel处理
- 开发/技术：GitHub热门项目、ArXiv论文追踪
⚠️ 不适用场景（本 skill 不覆盖）
先看一眼，少走弯路——这几种情况不适合查本手册：
| 不适用 | 原因 | 替代方案 |
|--------|------|---------|
| 问 WorkBuddy 版本更新日志的最新内容 | 文档可能滞后于版本 | 直接用 WebFetch 查官方 Changelog |
| 需要修改 Skill 文件本身 | 只读操作原则 | 先退出本 skill，直接要求 AI 编辑文件 |
| 特定连接器的 API 入参/出参细节 | 连接器文档通常由对应 MCP 工具自行描述 | 直接问 AI 该连接器的用法，AI 会读取内置 schema |
| 代码调试 / 编程问题 | 本手册不覆盖编程 | 直接描述技术问题，AI 切入编程模式 |
| "帮我写一个 skill" | 创建类操作超出参考手册范围 | 要求 AI 直接用 Skill 工具创建，不通过本 skill |
| 不可复现的一次性故障 | 无通用排查模式 | 运行 check_env.py 获取诊断报告，提交给 AI 分析 |
💡 记住：用它查用法，要动手干活时退出就行。
官方文档智能检索
当参考文件无法解决用户问题，或涉及版本更新、新功能时，必须用 WebFetch 主动检索官方文档：
检索链接
| 场景 | 文档链接 | 用途 |
|------|----------|------|
| 综合文档 | https://www.codebuddy.cn/docs/workbuddy/Overview | 全局入口，覆盖所有功能模块 |
| 快速入门 | https://www.codebuddy.cn/docs/workbuddymini/quick-start/Overview | WorkBuddy Mini 新手引导 |
| 更新日志 | https://www.codebuddy.cn/docs/workbuddy/Changelog | 版本变更、新功能、Bug修复 |
| 连接器文档 | https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Connector | MCP/连接器配置、错误码、常见问题 |
| 专家系统文档 | https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Expert-Center | 专家创建/修改、plugin.json 字段、团队协作 |
WebFetch 检索策略
用户提问
│
▼
参考文件有答案？── Yes ─→ 直接回复
│ No
▼
用 WebFetch 检索官方文档:
综合功能问题 → fetch_url = "https://www.codebuddy.cn/docs/workbuddy/Overview"
prompt = "提取与'{关键词}'相关的内容"
版本/更新问题 → fetch_url = "https://www.codebuddy.cn/docs/workbuddy/Changelog"
prompt = "提取最新版本号和变更内容"
Mini入门问题 → fetch_url = "https://www.codebuddy.cn/docs/workbuddymini/quick-start/Overview"
prompt = "提取与'{关键词}'相关的入门指南"
│
▼
官方文档有答案？── Yes ─→ 整理回复，注明来源为官方文档
│ No
▼
指引用户查阅其他渠道（桌面应用内帮助、changelog、社区等）
问题类型决策树
先分大类，再查下表：
你的问题属于哪类？
│
├── 🔧 某个功能不工作 / 报错
│ → 连接器失败？查"连接器/MCP"
│ → 自动化没触发？查"自动化"
│ → 整体不确定？先跑 check_env.py
│
├── ❓ 不知道怎么用 / 怎么配
│ → 第一天上手？走"新手引导"路径
│ → 要创建专家？查"专家"
│ → 不知道怎么交任务？查"提示词"
│ → 不知道怎么选模型？查"模型"
│
├── 🤖 想让 AI 更懂我 / 更顺手
│ → 改说话风格？查"立规矩/Soul.md"
│ → 跨会话记住偏好？查"记忆"
│ → 换工作模式？查"交互模式"
│
└── 🔒 安全 / 权限 / 合规
→ 数据安全？查"网络安全"
→ 权限控制？查"交互模式"
→ 企业安全？查"网络安全"
关键词速查
| 自然语言提问 | 技术关键词 | 对应文档 |
|-------------|-----------|---------|
| "不知道哪坏了"、"整体出问题" | 综合诊断、不确定原因 | references/troubleshooting.md |
| "WorkBuddy是什么"、"有哪些功能" | 架构、核心概念、组件 | references/01-architecture.md |
| "连不上"、"工具用不了"、"调用失败" | MCP失败、连接器、disconnected、401、404、错误码 | references/02-connector-troubleshooting.md |
| "帮我建个专家"、"自定义AI"、"修改专家配置" | 专家、expert-manager、创建专家、Prompt设计 | references/03-expert-workflow.md |
| "定时任务没执行"、"怎么设提醒" | 自动化、schedule、RRULE、定时、不触发 | references/04-automation-patterns.md |
| "回答不准"、"格式不对"、"太啰嗦" | 回答质量、提示词优化、格式错误 | references/05-quick-cards.md（卡片4） |
| "查股价"、"基金数据"、"财报" | 股票、行情、westock、neodata | references/05-quick-cards.md（卡片5） |
| "多个AI一起工作"、"搭专家团" | 专家团、多智能体、Team、SOP | references/05-quick-cards.md（卡片6） |
| "环境检查"、"跑诊断" | 环境诊断、全局检查、check_env | scripts/check_env.py |
| "搜索知识库"、"找文档" | 搜索知识库、grep、关键词 | scripts/quick-search.sh |
| "第一次用"、"怎么上手"、"立规矩" | 新手、上手、立规矩、Soul.md | references/05-quick-cards.md（卡片7） |
| 🆕 "类似问题怎么处理"、"有案例吗"、"产品经理/运营/HR怎么用" | 场景案例、真实例子、用户原话、职场职能 | references/06-scenario-examples.md |
| 🔌 "知识库"、"IMA"、"资料归档"、"历史方案" | IMA知识库集成、知识沉淀、跨产品调用、回传 | references/06-scenario-examples.md（案例19-20） |
| 🆕 "怎么高效用"、"工作习惯"、"进阶技巧" | 工作空间、任务管理、探索复用、Claw远程 | references/07-advanced-practice.md |
| 📖 "MCP是什么"、"RRULE格式"、"SOP"、"术语" | 术语表、概念定义、Glossary | references/08-glossary.md |
| 📄 "腾讯文档"、"在线文档"、"产物分享"、"二维码分享" | 腾讯文档集成、资料库、上传云端、微信分享 | references/06-scenario-examples.md（案例21-22） |
| 🆕 "怎么写提示词"、"AI总听不懂"、"交代任务"、"Prompt技巧" | 提示词、Prompt、任务交代、五要素 | references/09-prompting-best-practices.md |
| 🆕 "Ask和Craft什么区别"、"怎么切换模式"、"权限控制"、"小程序"、"助理" | 工作模式、交互、Ask/Plan/Craft、权限、通道 | references/10-interaction-modes.md |
| 🆕 "怎么让AI记住"、"记忆系统"、"跨会话记忆"、"Cloud Memory" | 记忆、Memories、画像、跨会话 | references/11-memory-system.md |
| 🆕 "用哪个模型"、"模型对比"、"模型倍率"、"Auto还是GLM" | 模型选择、Credit、倍率、模型对比 | references/08-glossary.md（模型章节） |
| 🆕 "安全吗"、"数据隐私"、"沙箱"、"VPC"、"企业安全" | 网络安全、数据保护、沙箱、合规 | references/08-glossary.md（网络安全章节） |
| 📖 "试过了还不行"、"文档没写"、"怎么都没解决" | 常见问答、FAQ、边界问题 | references/12-faq.md |
| 🆕 "团队协作"、"建项目"、"邀请成员"、"看板"、"任务流转"、"资产库" | Teams、项目、团队、协作、移交 | references/13-teams-collaboration.md |
| 🆕 "办公模式"、"开发模式"、"设计模式"、"场景切换"、"界面布局" | 场景模式、快捷方式、办公、开发、设计 | references/14-scene-modes.md |