﻿================================================================================
                    AI管大师 WorkBuddy版 v0.2
================================================================================
安装方法：

解压缩后在主对话窗口 ，输入：** 读取桌面 （解压缩文件夹名） 执行 install.md **  ，自动进入安装

一句话介绍
----------
把 WorkBuddy 单会话升级为 7-Agent 协同调度系统：
1 个大内总管（主会话，唯一入口）+ 6 个子代理（@agentId 唤起）。

适合谁用？
----------
- 1 个人要顶 7 个人用的小老板
- 不想堆人、靠系统提升效率的团队
- 需要任务分配 / 进度跟踪 / 风险预警的工作流

================================================================================
【1. 7-Agent 团队】
================================================================================

  大内总管（主会话，唯一入口）
       │
       ↓ sessions_send
       │
       ├── @guanjiapo      管家婆       企微消息/会议/通知/员工协调
       ├── @kandao-piruan  砍到疲软     采购询价/比价/供应商/市场调研
       ├── @chaoji-zhuli   超级助理     报表/行程/行政/短视频脚本
       ├── @tieban-shenzhu 铁板神珠     财务核算/报销审批/预算/资金
       ├── @huoke-gaoshou  获客高手     营销文案/自媒体/客户跟进/带货视频
       └── @rencai-lieshou 人才猎手     招聘/面试/培训/绩效/入离职

调用格式：@agentId 空格 任务描述
示例：@guanjiapo 提醒团队明早 9 点站会

================================================================================
【2. 触发方式 - 什么场景调谁】
================================================================================

  任务类型                           调谁
  ------------------------------    ------------------------------
  任务拆分 / 跨 Agent 协同           大内总管（不要直接 @ 子代理）
  企微消息 / 会议 / 通知             @guanjiapo
  采购询价 / 比价 / 供应商           @kandao-piruan
  报表 / 行程 / 短视频脚本            @chaoji-zhuli
  报销审批 / 预算 / 财务报表          @tieban-shenzhu
  营销文案 / 自媒体 / 带货视频         @huoke-gaoshou
  招聘 / 面试 / 培训 / 绩效           @rencai-lieshou

原则：复杂任务找大内总管，简单任务可直接 @ 子代理。

================================================================================
【3. 能力边界 - 明确告警，绝不越界】
================================================================================

  Agent         能做（举例）              不做（转大内总管）
  -----------   ---------------------    --------------------------
  大内总管      任务分配/进度跟踪         不替代下属执行具体业务
  管家婆        企微消息转达/会议提醒      客户投诉、业务决策
  砍到疲软      询价比价/竞品调研          财务审批、合同签署
  超级助理      报表/行程/短视频脚本       财务、营销决策
  铁板神珠      财务核算/报销审批          业务执行、人事
  获客高手      文案/自媒体/带货视频        财务核算、招聘
  人才猎手      JD发布/面试/培训/绩效      业务执行、财务

【通用规则】
所有 Agent 产出的：
  - 金额 > 5000 元
  - 合同类
  - 对外承诺
必须经 大内总管 → 老大 审批，不得擅自决定。

================================================================================
【4. 异常处理 - 出错了怎么办】
================================================================================

  异常场景                          自动行为
  -----------------------------    ----------------------------------
  子 Agent 5 分钟无应答             大内总管重试 2 次，仍无响应上报老大
  子 Agent 执行报错                 写错误日志到 已完成/<agentId>/报错_时间戳.md
  任务超时（> 30 分钟）             大内总管巡检发现，标记黄色预警
  Skills 缺失                       该 Agent 自动跳过，用内置能力替代
  知识库/保险库找不到文件            大内总管判断是否新建 or 转人工
  大内总管自己卡住                   锁文件熔断机制自动重启

错误日志路径：{INSTALL_DIR}\已完成\<agentId>\报错_YYYY-MM-DD-HHmm.md
兜底手册：见 Q&A.md 第 3 节、FAQ.md 第 5 节

================================================================================
【5. 快速开始 - 5 步上手】
================================================================================

第 1 步：解压安装包到任意目录（建议 D:\AI管大师\）
第 2 步：双击 scripts\install.bat（默认装到 D:\AI管大师\，可自定义）
第 3 步：完全退出 WorkBuddy，重新打开
第 4 步：新会话输入：@guanjiapo 收到请回复
第 5 步：通过！开始向"大内总管"下达指令

手动补装（install.bat 失败时）：
- 把 agents/*.md 复制到 %USERPROFILE%\.workbuddy\agents\
- 把 skills/ 下的插件复制到 %USERPROFILE%\.workbuddy\plugins\
- 编辑 .workbuddy\settings.json 添加 enabledPlugins
详见 install.md。

================================================================================
【6. 使用示例】
================================================================================

→ 大内总管：下周开季度会，准备财务数据 + 营销分析 + 会议通知
→ @huoke-gaoshou：写 3 条朋友圈文案推广 AI管大师
→ @tieban-shenzhu：审核张三 1000 元餐费报销
→ @chaoji-zhuli：安排明天下午 2 点产品评审会
→ @kandao-piruan：查 A 物料三家供应商当日报价
→ @rencai-lieshou：发前端工程师 JD 到 Boss 直聘

================================================================================
【7. 任务分配流程（底层机制）】
================================================================================

  1. 大内总管接收老大指令
  2. 分析任务类型，确定子代理
  3. 写入该 Agent 待办文件夹（待办/<agentId>/）
  4. 通过 sessions_send 唤醒："读取待办文件夹"
  5. 子代理读取待办 → 执行 → 交付至 已完成/<agentId>/
  6. 大内总管验收，汇总反馈

定时汇报：每 2 小时（06:00–20:00）大内总管自动向老大汇报进展。

================================================================================
【8. 数据存储】
================================================================================

  路径                                       内容
  -------------------------------------    --------------------------
  {INSTALL_DIR}\knowledge\main\             公开知识库（全员可读）
  {INSTALL_DIR}\vault\                      机密保险库（按 Agent 权限隔离）
  {INSTALL_DIR}\memory\<agentId>\growth.md  每 Agent 独立成长记忆
  {INSTALL_DIR}\待办\<agentId>\             任务待办
  {INSTALL_DIR}\已完成\<agentId>\           任务产出（含报错日志）

================================================================================
【9. 系统要求】
================================================================================

  - 操作系统：Windows 10/11
  - 平台：WorkBuddy v0.2.32+
  - 配置项：agentToAgent.enabled=true、sessions.visibility=all
  - 网络：国内网络直连
  - 磁盘：约 200 MB（含 48 个 Skills 插件）
  - 内存：与 WorkBuddy 主程序共享

================================================================================
【10. 文档导航】
================================================================================

  文件                用途
  ----------------    ----------------------------------------------
  SKILL.md            主插件完整说明（架构/触发/能力/异常/安装）
  ai-guan-dashi.yaml  WorkBuddy 主清单（含 48 bundled_plugins）
  agents/*.yaml       6 个子代理上架 YAML（含 readme + instructions）
  agents/*.md         6 个子代理完整说明（人设/边界/异常/技能）
  install.md          install.bat 7 步详解 + 手动补装指南
  FAQ.md              常见问题（部署/性能/权限/费用）
  Q&A.md              异常处理兜底手册（5 分钟无应答/任务超时/锁文件）

================================================================================
【11. 重要提醒】
================================================================================

  - 大内总管是唯一调度入口，不要让 6 个子代理互相 @（禁止 Agent 间直连）
  - 所有 Skills 调用默认在 {INSTALL_DIR}\skills\ 下，install.bat step7 自动启用
  - 企微类 Skill（wecomcli-*）需先在 WorkBuddy 配置企微连接器
  - 重要内容人工复核，AI 不保证 100% 准确
  - 任何金额 > 5000 元的产出必须经老大审批

================================================================================
【12. 许可证与支持】
================================================================================

  许可证：MIT（内部使用）
  维护人：大内总管
  支持渠道：老大 → 大内总管 → 跨端同步

================================================================================
最后更新：2026-07-27
版本：v0.2.0
================================================================================