项目构建专家·助手总包

要解决什么问题

在 WorkBot（WB）里落地一个「陪伴型」或「助理型」项目，往往要串起 创建项目、挂专家与技能/知识库、写自动化（cron / 事件），有时还要把本机 Python 脚本注册成 WB 可调用技能。若这些步骤由通用对话助手即兴拼装，容易漏字段、顺序错乱，或在失败时静默吞错。

助手总包（ME） 的定位是 WB 内的施工队：只接受 GA（通用助手） 下发的结构化蓝图 JSON，在 WB API 上按固定流水线施工，并把结果与异常回传给 GA，不跟终端用户直接聊天。

它如何工作

触发方式很克制：仅响应以 @助手总包 开头的指令。整体流程可概括为：

1. 验图：校验蓝图必填项（project_name、project_type、experts、automations）；缺项则要求 GA 补全，绝不自行编造。
2. 预封装：若蓝图含 local_script，先调用 POST /skills/local 把脚本注册为 WB 技能，得到 skill_id 供专家绑定；失败则回传 GA 并建议改用市场技能。
3. 顺序施工（任一步失败即中止）：创建/复用项目 → 逐条创建专家并绑定技能与 knowledge_base_ids → 创建自动化（cron 或 event 触发），并按 notification_policy 配置企微通知与消息模板。
4. 首轮点燃：immediate_run: true 时调用 POST /automations/{id}/trigger 试跑核心规则，结果写入交付报告。
5. 交付通知：经企微向 GA 发送项目 ID、自动化清单、点燃结果及 manual_steps 待办。

消息模板会随 project_type 区分：companion 偏主动、带行动建议；assistant 仅在 need_decision 节点发简练审核/告警类消息。还可通过 WB 连接器调用微云、腾讯文档、企微、Buffer、日历等。

适用边界与注意点

• 需提前配置环境变量 WB_API_KEY；安装时需允许 本地执行脚本 权限。
• 内置脚本 scripts/wb_project_builder.py 由技能附件解压路径 ${SKILL_DIR} 注入，负责把上述流程跑通。
• 云盘/API 权限不足时项目可能挂起，由 GA 引导用户授权；自动化执行失败会 重试 3 次 后再把摘要交给 GA，不直接打扰用户。
• 常见错误：401 检查 API Key；403 重新授权本地执行；400 终止并要求 GA 补参。