WorkBuddy 使用指南

本技能是一个打包好的 WorkBuddy 参考手册，安装后开箱即用。

什么时候用这本手册？

> 遇到以下情况，直接在对话里问就行——本手册会自动匹配，不需要手动激活。

怎么叫出来：在对话中直接提 WorkBuddy 相关的问题即可，比如"连接器连不上怎么办""怎么创建专家"——手册会自动加载。

触发规则（什么时候会触发 / 不会触发）

会触发（15 种场景）：
1. 提到 WorkBuddy 任何功能名（连接器/专家/定时任务/Teams/场景模式/记忆/模型/安全中心/人机双写/资料库/设计创意/多端同步/灵感/场景实战）
2. 描述 WorkBuddy 报错或异常（连不上/用不了/报错/不生效/没反应/错误码）
3. 问 WorkBuddy 配置方法（怎么配/怎么设/怎么连/怎么装）
4. 问 WorkBuddy 使用问题（怎么用/怎么操作/在哪设置）
5. 问定时任务/定时任务相关问题（不触发/怎么设/RRULE 写法）
6. 问专家/专家团相关问题（创建/修改/不生效/注册）
7. 问 IMA 知识库/腾讯文档/腾讯会议集成问题
8. 问版本变更/新功能相关问题（某版本加了什么/某功能怎么没了）
9. 问人机双写/协同编辑/划词改文档相关问题（选中文字让 AI 改/边栏编辑文档）
10. 问资料库相关问题（我的文档/团队空间/三种载体/MD·CSV·HTML联动/本地HTML发在线链接/轻应用）
11. 问设计创意相关问题（Ardot/一句话生成UI/PPT/海报/设计稿转代码/画布精修）
12. 问多端同步相关问题（手机连电脑/移动端远程/锁屏远程/远程停止任务/多设备切换）
13. 问灵感相关问题（灵感库/一键做同款/制作我的版本/套版复刻/七大场景成品）
14. 问场景实战相关问题（个人网站制作/D2C设计稿转代码/定时备课工作流/工作台搭建）
15. 问上下文管理相关问题（用量圈圈/Max模式/compact压缩/切模型/新会话判断/记忆与个性化/技能开关省上下文）

不会触发（4 种场景）：
1. 问其他产品的问题（Claude Code/Cursor/VS Code 等）
2. 纯代码/编程问题（写个函数/改个 bug/解释代码）
3. 要求修改本 skill 文件本身（请直接要求 AI 编辑文件，不通过本 skill）
4. 与 WorkBuddy 完全无关的通用问题（天气/翻译/写作等）

边界模糊问题处理示例：
| 用户原话 | Skill 判定 | 实际处理 |
|---------|-----------|---------|
| "我的 WorkBuddy 好卡" | 边界模糊（可能是网络/上下文/文件多） | 先反问：是连接慢、响应慢、还是文件太多？再给对应排查 |
| "帮我写个 Python 函数" | 不在范围（纯代码） | 礼貌拒绝："这是编程问题，直接让 AI 写代码即可，不用走本手册" |
| "腾讯文档怎么同步到 IMA" | 明确在范围（集成） | 直接给步骤：腾讯文档导出 → IMA 知识库上传 → 跨产品调用 |
| "WorkBuddy 怎么用" | 太宽泛 | 反问角色/场景："你是 HR/开发/运营？想做哪类事？"再指角色路线图 |

设计原则（本手册怎么取舍内容）

1. 只收录高概率真实困惑：FAQ 每条都对应真实踩坑场景，一问一答 ≤150 字，不为凑数而写
2. 纯 bug 修复不收录：客户端已修复的历史 bug 不写进手册（官方 Changelog 可查），只保留当前版本仍有效的应对方案
3. 三级检索不跳层：速查卡 → 深度文档 → 官方文档，由浅入深，避免新手一上来就啃长文
4. 修复路径分级：每个故障给「一级修复（最常见原因）→ 二级修复 → 验证方法」，不堆所有可能性
5. 版本适配只标不展开：客户端新版本仅影响口径时在 FAQ 中标注版本号，不为每个小版本新增条目

🚀 新手学习路径（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         🆕 18个真实场景案例（通用+职场职能）
  ├── 20-scenario-integrations.md     🆕 集成与端到端案例（IMA+腾讯文档+深度闭环）
  ├── 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                🆕 场景模式与工作界面（办公/开发/设计 + 布局）
  ├── 15-ima-official-knowledge.md     🆕 IMA官方知识库兜底检索（可选，需IMA已连接）
  ├── 16-ima-knowledge-base-guide.md   🆕 IMA知识库操作指南（连接/引用/存回/解绑）
  ├── 17-tencent-meeting-guide.md      🆕 腾讯会议Skill实践（安装/会议管理/纪要）
  ├── 19-role-routes.md                🆕 按角色快速上手（6类岗位路线图）
  ├── 21-ziliaoku-guide.md             🆕 资料库指南5.3.11（我的文档/团队空间/三种载体/轻量发布/人机修订）
  ├── 22-design-creative-guide.md      🆕 设计创意指南（Ardot/对话生成UI/PPT/海报/设计稿转代码）
  ├── 23-inspiration-guide.md          🆕 灵感指南（七大场景成品库/一键做同款/自动就位，含三灵感划界）
  └── 24-scenario-practice-guide.md    🆕 场景实战指南（个人网站/D2C设计稿转代码/IMA定时备课，官方实践案例）
        │
        │ 无匹配 / 涉及最新版本 ↓
        ▼
[第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
        │
        │ WebFetch 仍无明确答案 ↓
        ▼
[第3.5层] IMA 官方知识库（可选）
  ├── 前置条件：IMA 连接器处于 connected 状态
  ├── 调用方式：mcp__ima-mcp__search_knowledge
  │    knowledge_base_id = 7472132158135857
  │    query = 用户原始问题关键词
  └── 适用：本 skill 未覆盖的最新功能、版本特定问题
        │
        │ 未连接 IMA 时跳过，不阻断流程 ↓
        ▼
[第4层] 兜底建议
  → 指引用户查看桌面应用内帮助、社区或提交反馈

参考文件索引

> 难度标记：🔴 新手必读（卡片1/2/7） 🟡 进阶（卡片3/4） 🟢 高级（卡片5/6）

使用规范

1. 检索优先级：快速卡 → 深度文档 → 官方文档（不要跳层）
2. 读取粒度：先用 Grep 定位关键词，再读取对应段落，避免全文件加载
3. 诊断工具：复杂环境问题先运行 python scripts/check_env.py 获取全局状态
4. 更新维护：发现新踩坑经验时，追加到对应文件的"踩坑经验"区域
5. 只读操作：本技能参考文件不修改用户项目文件，仅提供检索和回答
6. 聊天式分步引导（来自新手指南）：引导用户配置时，每次只问1个问题，不给表格；等用户回答后再问下一个；确认时只问"OK 还是改？"
7. Soul.md 六条规矩书（基于四大支柱：核心性格 + 说话方式 + 工作原则 + 红线，可复用）：
   - 第一条：核心性格 — 用 2-3 句话定义 AI 是谁（身份/职业/核心价值），作为所有回答的性格兜底
   - 第二条：说话方式 — 明确该说什么、不该说什么。消除 AI 味：禁止"好的呢~""您说得太对了""感谢您的提问"等客套话，按用户偏好切换命令式/分析式/轻松感
   - 第三条：工作原则 — 3-5 条铁律保证专业度：带着方案来、干完活顺手复盘、一次到位不反复确认、不确定就说"不确定"但先给最可能答案
   - 第四条：嘴严 — 隐私/文件/聊天记录/未公开内容绝不泄露，敏感信息不记录不转述
   - 第五条：红线禁区 — 法务合规底线 + 用户个人雷区（特定话题/语气/内容类型），绝不越界
   - 第六条：持续进化 — AI 出主意、用户做决定；每次互动都是学习机会，随时用"你应该…""不要…"修正规则；开启全局记忆，长期积累偏好
   - Soul.md 互动采集流程（聊天式，每次只问 1 个问题）：
   1. 启动："准备好了吗，让我来修改你的性格档案"
   2. Q1 → 你希望我说话什么风格？（命令式/分析式/轻松/严肃…）
   3. Q2 → 有没有你特别讨厌的回答方式？（具体举例，如"不要客套话"）
   4. Q3 → 工作中有什么原则是你特别看重的？（"拿不准先问""不要省略步骤"…）
   5. Q4 → 有没有绝对不能碰的红线？（内容类型/语气/合规边界）
   6. 生成 Soul.md → 展示确认 → "OK 还是改？" → 写入 ~/.workbuddy/SOUL.md
   7. 后续维护：随时用"你要…""你应该…""不要…"句式微调规则，无需重新走完整流程
8. 按职业推荐技能包（可复用为快速配置模板）：
   - 通用必装：Skill安全扫描、Agent Browser、AI绘图、PDF生成、Word生成、PPT生成
   - 自媒体/内容运营：小红书图文发布、微信公众号发布、AI写作助手
   - 企业培训：AI视频生成、Excel处理
   - 开发/技术：GitHub热门项目、ArXiv论文追踪

⚠️ 不适用场景（本 skill 不覆盖）

先看一眼，少走弯路——这几种情况不适合查本手册：

> 💡 记住：用它查用法，要动手干活时退出就行。

官方文档智能检索

当参考文件无法解决用户问题，或涉及版本更新、新功能时，必须用 WebFetch 主动检索官方文档：

检索链接

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"
    │     → 跨会话记住偏好？查"记忆"
    │     → 换工作模式？查"交互模式"
    │
    └── 🔒 安全 / 权限 / 合规
          → 数据安全？查"网络安全"
          → 权限控制？查"交互模式"
          → 企业安全？查"网络安全"

关键词速查