技能介绍

要解决什么问题

在微信公众号（wxoa）或企业微信客服（wxcw）场景里，一个可用的 XAgent 分身（charagent） 往往横跨人格画像、行为规则、角色记忆、知识库、FAQ、特殊事件、ASR 热词，还有头像/肖像素材与模板。日常运维里常见需求是：先列出并核对现有分身，再逐项改配置或跑向导生成候选，而不是在控制台里对着一堆内部字段和 JSON 硬改。

本技能面向 WorkBuddy 对话场景：在用户要列举、检视、设计、配置、优化或排查上述模块时介入，并把结果用「人格画像」「行为向导」「知识库」「常见问题」等业务名解释清楚。

技能如何工作

第一步是加载服务端技能 xcharagent_design：若环境里有原生 MCP 工具 xagent_skill_load，则调用 { "skill": "xcharagent_design" }；否则直接使用本包内置适配器拉取同等内容，无需先装 WorkBuddy 自定义连接器。后续以返回内容中的规则为唯一准绳。

调用 XAgent 能力时，优先用可见的原生工具；缺失则经适配器走同一远程接口。复杂 JSON 建议走 stdin，避免 shell 引号问题。适配器不打印 MCP token；只对安全读操作自动重试，写配置与向导生成在结果不确定时应先读回受影响模块再决定是否重试。头像/肖像可走 prepare + upload，对外只汇报 uploaded: true 后的公开引用。

交互上：接受用户熟悉的显示名，用 charagent_manageable_list 解析内部键；多账号时才简短让用户选。默认先读后写、保留无关配置、用返回的 item id 更新，并在写后读回校验。删除、套用/追加模板、大范围重置或新建平台对象前，需明确确认。

边界与注意点

这是 SkillHub 独立包；没有 WorkBuddy 连接器条目不算错误，只有适配器返回 auth_required 时才需要用户在 XAgent 登录并保存 MCP token（账号鉴权，不是再装插件）。
XApp 的代码/工作区/预览/发布归 XApp 开发技能；公众号/企微的广泛集成、插件升级、配额、商品授权、资源对象与风控记录等归管理类技能。
不要把向导生成的候选说成已落盘的配置；也不要向用户暴露原始 JSON、内部键、token、签名 URL 或审计载荷。