你需要的条件
一个平台可管理的服务号或微信客服智能体；一台安装 Codex / WorkBuddy 的电脑，或网页控制台；个人中心生成的 MCP 开发秘钥。
Before You Start
先准备一个可管理的入口和一份真实资料
目标不是生成一段很长的提示词，而是把服务定位、知识事实、FAQ、风险边界和素材拆成可维护模块。先确定要配置的服务号或微信客服智能体，再为它建立一个专属资料文件夹。
建议资料范围
公司或个人介绍、产品与服务、价格政策、服务流程、FAQ、案例、表达样例及禁止事项。不要把密码、隐私或内部敏感资料放入公开素材或知识库。
先建服务号专属资料夹
先为这个服务号创建一个文件夹，建议命名为【XXX服务号分身】；后续所有资料都放在这里，避免不同服务号的素材混在一起。
XXX服务号分身/
00-角色与目标.md
01-个人或公司介绍/
02-产品与服务/
03-价格与政策/
04-服务流程/
05-FAQ/
06-案例与表达样例/
07-禁止事项与风险边界/
08-图片音视频素材/
Install & Enter
选择一种工作方式
三种方式共享同一平台配置真相：AI 宿主（Codex 或 WorkBuddy，适合整理资料、生成计划与持续迭代）通过授权能力调用平台；网页控制台直接打开真实配置页面。
安装智能体分身设计器
- 左侧进入【专家·技能·连接器】，选择【技能】。
- 在右上角输入搜索【10knet】并确认。
- 在【SkillHub】下找到【智能体分身设计器（xcharagent design）】，点击加号安装。
- 安装完成即可；不需要再单独配置连接器。
把公开安装说明交给 Codex 执行
Codex 安装完成后应同时拥有 xagent 与 xagent-files 两个本地 stdio MCP 服务。前者连接平台工具与动态 Skill；后者执行获授权的 workspace、素材和资源文件操作。
请读取并严格执行 https://x.10knet.com/mcp/install/codex，
为当前 Codex 安装 XAgent 插件和 xagent、xagent-files 两个 MCP 服务。
需要开发秘钥时请提醒我到 10knet 个人中心的【设置 -> 开发秘钥】生成，
安装完成后运行 doctor，确认两个 MCP 服务均可用，并提醒我重启 Codex 或新建任务。
- 需要 Node.js 18+、Codex CLI 与 tar。
- macOS 的 Codex Desktop 需要让 GUI 进程获得 MCP Token。
- 不要把 Token 粘贴到公开聊天、截图或资料文件中。
不安装插件，也能直接配置
进入运营中心，在【我的微信服务号】或【我的企业微信号 → 数字员工】找到目标入口，进入服务号总控台或微信客服后台，再打开【智能体配置】。
- 可使用助手模板、智能向导、基础信息、主要设定、服务规则、记忆、知识库、FAQ、特殊事件、失败兜底、技能应用、热词与操作记录。
- 适合逐项修改和可视化检查；批量整理资料与跨模块方案更适合交给 Codex / WorkBuddy。
平台秘钥配置（只需一次）
- 打开 x.10knet.com，进入个人中心；在资料选项卡下的【开发秘钥】点击生成并复制秘钥。
- 在 WorkBuddy 新开对话，点击加号添加【智能体分身设计器】，输入“请帮我配置秘钥”，再输入秘钥并发送。
- 稍后输入“请列出我创建的服务号”。WorkBuddy 能列出你上一步在平台绑定的微信服务号，即表示已经完全连通。
First Success
按七步完成第一次可测试配置
选择工作空间
在 WorkBuddy 对话框底部的【选择工作空间】中，选择刚才创建的【XXX服务号分身】文件夹。它将作为你保存和使用各种素材资料的唯一位置。
加载智能体设计 Skill
点击输入框的加号，或在输入框输入斜杠 /，添加【智能体分身设计器】。
先读取当前可用规则和版本，不要凭记忆配置平台。
列出可配置智能体
先确认你有权管理哪些服务号或微信客服智能体；不要为了方便创建游离智能体，也不要只凭私有 key 取得授权。
请列出我当前有权配置的服务号和微信客服智能体，
按账号类型、名称和可管理关系展示；先不要修改任何配置。
整理资料，先找缺口
把已有文档放入资料目录，或让宿主采访式收集并先列出缺失项。资料事实与后续设计判断要分开。
先生成模块化配置计划
第一次只读资料、生成计划，不直接写入平台。
请阅读 ./XXX服务号分身，先不要写入平台。
请针对我选定的智能体生成一份模块化配置计划：基础信息、主要设定、服务规则、角色记忆、知识库、FAQ、特殊事件、素材与热词。
说明每项来自哪份资料、哪些是事实、哪些是设计判断、哪些仍需我确认，并保留当前无关配置。
确认后逐模块写入并复核
保留未涉及的字段。删除、模板覆盖、重大风险策略或大范围素材移动需要独立确认。
我确认这份计划。请按模块逐项配置，每次保留未涉及的现有字段；
删除、模板覆盖、重大风险策略和素材大范围移动必须先单独确认。
完成后重新读取受影响模块并做一致性检查。
到微信入口做真实测试
只有在目标服务号或微信客服真实发消息并收到回复，才算完成了入口验收。页面保存不等于对话效果已验证。
Extend Carefully
需要时再接入这些运营能力
配置技能应用
在【智能体配置 → 技能应用】中给智能体配置真实存在的应用或链接素材。运行时只能推荐已配置的卡片，不应编造 URL 或商品字段。
创建 VIP / XApp 商品
商品、VIP、资源对象、发布与授权属于运营和商业配置，不是 xcharagent_design 的职责。商品草稿也不等于已上架。
首次关注与再次关注问候
在服务号总控台【消息自动化 → 事件消息】中，分别为 subscribe 与 resubscribe 建立模板和规则；先确认模板，再启用自动化。
自定义音色
基础音色可在【智能体配置 → 基础信息】选择。当前自定义克隆音色由平台超级管理员配置，普通租户不能在普通表单自行训练。
Test & Improve
让真实问题驱动小步迭代
每轮只提交真实问题和期望修正，让宿主定位应修改的模块；不要用一段大提示词覆盖全部配置。
测试维度至少检查异常时优先检查
身份与知识“你是谁”、核心业务、价格、流程是否准确。基础信息、知识库、FAQ。
服务边界不确定、退款、投诉和高风险问题能否承认边界或转人工。服务规则、特殊事件、失败兜底。
服务动作推荐商品或技能应用是否真实、节制且符合语境。技能应用、商品与消息策略。
多模态语音、图片等消息形态是否符合角色和额度策略。基础信息、素材与消息流程。
下一步：把服务做成可交付的 XApp
需要表单、测评、记录、课程或付费交付时，继续创建一个能调用智能体的 XApp。