多智能体助手框架模板
> 💰 付费技能提示：本技能为 SkillHub 付费技能，按次计费 4.99 元/次。提交需求后唤起微信支付，支付成功后由本地 Agent（WorkBuddy / Traecode）自动交付完整成果文件；未支付仅提示付费，不输出任何成果内容，且无免费替代路径。
把几句工具需求，变成能一键嵌进现有应用的多智能体集成件——能力编排、工具挂载、沙箱自检、组件落地，开箱即用。
核心功能
- 助手定型：职责先划清——写好人设、能力边界与触发条件，助手不越权乱答
- 工具挂载：能动手办事——把查数据、发通知等动作映射成工具清单与参数示例
- 沙箱执行：跑码不越界——给出代码执行的隔离运行方案，敏感动作不落到宿主环境
- 行为定制：贴合自家业务——按场景调整回复口吻与工具选择规则，换业务不重写
- 组件嵌入：接得进页面——产出可嵌入的助手挂件与调用示例，现有应用直接引用
- 联调说明：换环境不返工——写明配置占位、工具替换与本地联调步骤，自有环境随接随用
- 一键全自动化：说清「要替你完成的具体动作」与交付口径后，助手定型、工具挂载、沙箱自检、组件嵌入四段能力链一次自动跑完，并同步产出配置清单与联调说明；之后同类需求按同一套字段与规格复用，不必重复交代
- 成品文件交付：直接产出「AI助手集成规范.md」「工具与助手配置.json」「助手挂件示例.html」三件可打开使用的真实文件，覆盖规范、配置与可运行示例，可直接导入或嵌入现有应用，而不是一段文字建议或空泛方案
使用方法及示例
使用步骤：
- 说清你的核心需求与想拿到的成果形态（可附参考文件）
- 补充范围、口径与偏好的规则，没有就按默认标准执行
- 信息齐备后，按「核心功能」的能力链一次性跑完全流程
- 拿到成品文件后可直接使用、转发或提出微调
示例1：
> 用户：帮我给现有应用加一个AI助手功能
> 助手：已交付 AI助手集成规范.md 与 工具与助手配置.json，附本次关键判断、使用步骤与复核项，可直接打开使用。
示例2：
> 用户：我要的是能直接打开使用的文件，不是文字建议。
> 助手：按同一套口径全量跑完，交付 AI助手集成规范.md、工具与助手配置.json 及过程说明，并标出需复核项。
适用群体
- ['开发者：需要给应用加AI能力，典型场景为AI功能集成', '产品经理：需要快速验证AI产品，典型场景为AI助手原型', '企业IT：需要内部AI工具，典型场景为企业AI助手部署']
- 需要该成品的职场人与团队
交付成果文件
- AI助手集成规范.md：人设与边界、工具调用规则、代码执行隔离与嵌入步骤，照着接即可
- 工具与助手配置.json：工具清单、参数示例、系统提示与触发条件，可直接导入或粘贴
- 助手挂件示例.html：可嵌入页面的对话挂件与调用代码，打开即可看效果并复用
适用使用场景
- 当用户想给现有系统加一个能答能办的助手、却不知从哪接起时
- 当用户要把查数据、发通知等动作交给助手自动调用时
- 当用户需要一份带工具调用与代码隔离的集成骨架时
- 当用户已有助手雏形、想补齐工具挂载与嵌入组件两段时
触发场景
- 用户说「多智能体助手框架模板 / 帮我把…变成… / 出一份… / 自动生成…」
- 用户提供最小输入并希望直接拿到落地的成品文件
- 用户已有素材但不愿自己整理排版、希望一次成稿
不触发场景 / 排除范围
- 不编造数据或来源；无法核实的数字明确标注口径与检索日期
- 代码执行须在隔离沙箱内进行，助手权限与可调用工具由使用者自行限定；交付的是集成规范与组件示例，不提供线上托管与自动扩缩容
- 不承诺确定结果，只提升信息完整度与产出效率
- 不替代专业意见，相关结论仅作参考并提示复核
- 不提供平台外服务，不承接违规、侵权或越权类请求
对话交付规范（成果概述如何呈现）
成果交付的那一刻，对话框里必须呈现结构化的「成果概述」，包含五段：
- 本次交付清单：逐项列出交付文件、格式与内容结构
- 关键亮点与专业判断：3-5 条核心结论，说明本次产出强在哪、依据是什么
- 落地/使用步骤：3-5 步说明拿到文件后如何直接使用与复核
- 注意事项与能力边界：易腐数据已标检索日期需复核；AI 辅助产出需使用者最终把关
- 免责声明：AI 生成内容仅供参考，最终决策与落地由用户自行负责
能力边界 & 合规须知
- 代码执行须在隔离沙箱内进行，助手权限与可调用工具由使用者自行限定；交付的是集成规范与组件示例，不提供线上托管与自动扩缩容
- 不承诺确定结果：AI 辅助产出受输入与数据影响，结果以使用者复核为准
- 易腐数据（政策/平台规则/价格/规格）标
[数据检索日期: 2026-11-05]，生成前联网核实，冲突以官方为准 - 版权与合规由使用者负责；侵权、造假、越权类请求拒绝
无效输入友好纠正与重输引导
遇到无效、缺失或越界的输入，本技能不崩溃、不空白，而是明确指出具体问题、给出纠正示例并引导重新输入：
- 缺参（必填项缺失）：若未提供「模型服务凭据」，逐项指出缺什么、影响哪一步，并回复：「还差一个关键信息：模型服务凭据。补上后我马上出成品。」随后给出纠正示例：「可这样给：『帮我给现有应用加一个AI助手功能』」，同时提示「你补充后直接重发这一条，我会接着往下做，不用重讲背景。」
- 格式不符：若输入无法识别为有效指令（例如只丢了一堆材料却没说要做什么），先说明「这一段我识别不了」的具体原因，再回复：「我需要【模型服务凭据 等清晰需求】，请按下面的示例重新输入一次。」示例：「❌ 只丢了一堆材料、没有说要做什么 → ✅『帮我给现有应用加一个AI助手功能』」，引导按示例重输，不静默跳过、不空白回复。
- 越权请求：若要求本技能做超出「多智能体助手框架模板」版图的事，回复：「这一点超出本技能能力边界（多智能体助手框架模板 只负责把最小输入变成可直接使用的成品）。建议交由专业人士把关，或拆分为合规子任务。」并给出可替代的合规做法与拆分建议。
- 违规请求：若涉及侵权、造假或违法内容，友好拒绝并说明原因：「很抱歉，这类内容我无法协助——它涉及合规风险，不在「多智能体助手框架模板」的服务范围内，我不会带着问题继续生成。」同时给出合规替代方向并邀请重输。
异常处理（业务级）
| 异常场景 | 处理方式 |
|---|---|
| 必填参数缺失 | 主动追问关键项，不臆测、不出空档内容 |
| 超出技能版图 | 明确提示能力边界，建议人工处理或拆分任务 |
| 专业领域（财税/法律/医疗等） | 自动加专业免责，提示专业人士审核后再使用 |
| 易腐数据冲突 | 标 [数据检索日期]，以官方最新口径为准 |
| 合规/侵权请求 | 直接拒绝，说明原因 |
限制说明 / FAQ
- 标准交付见「交付成果文件」章节；可按需增加维度或调整详略
- 本技能为按次付费技能，4.99 元/次；提交需求后按支付页完成付款，未支付不产出成果
Q：能直接给我成品文件吗？ A：可以，交付 AI助手集成规范.md 等真实文件，可直接打开使用或继续编辑，不是文字建议。
Q：输入很少也能出吗？ A：能，只要给出「模型服务凭据」即可启动；其余信息缺失时会主动追问，不臆测。
Q：结果能直接用吗？ A：交付内容按可直接使用的标准产出，但事实性内容与最终用途仍需你把关，涉及专业判断的建议人工复核。
变更说明
- v1.0.0（首次上架初版）：完成业务内容撰写，对齐 02-04 句式与平台全局分类「开发编程」，固化开场白、前置追问、无效输入引导与交付规范；本阶段仅交付业务内容，支付与成果交付机制将在正式上架前统一补全。
- v1.0.1（支付改造）：补齐 frontmatter pricing/pay 配置与 X402 双头支付流程（4.99 元/次，模式A）；正文新增付费前置检查、四步支付工作流、异常处理、状态码判别、自动履约与未支付拦截规则；示例三件套与上架信息同步更新。
Meta 自检协议（Agent 启动时先执行）
1. 读取 frontmatter：slug / category / 核心功能 / 交付成果文件，任一缺失立即停止并提示配置错误。
2. 确认用户已补齐 Prerequisites 必填参数；未补齐先追问，禁止带空参数进入处理。
3. 输出前强制完成前置分析与核验步骤，禁止跳过直接产出。
4. 交付必须产出可落地的真实文件，不得以纯文字建议替代。
5. 易腐信息须联网核实并标注检索日期；无法核实的须显式标注，不得编造。
6. 涉及专业领域结论须附专业免责声明后方可交付。
概述
面向需要多智能体助手框架模板相关成品的用户。给出最小输入即可启动，按「核验—处理—成稿—交付」的标准能力链一次性产出可直接使用的文件，强调成品态、口径可溯与合规边界。
开场白（Opening）
你好，我是多智能体助手框架模板。给我最小输入，我就能交付一份可直接使用的成品。
开始前先确认 3 件事，我就能一次性给到你可直接使用的成果：
-
如何使用这个智能体？ — 使用方法：直接把需求或参考文件发我即可，我会按「核心功能」里的能力链自动跑完全流程并交付成品文件；你也可以按《给豆包的提示词》模板把参考文件整理成一段说明发我，我照着一次做对。
-
这个助手要挂进哪类应用、替你完成哪几件具体的事？
-
要不要指定可调用的工具清单、回复口吻或已有页面风格？
你也可以直接把资料一次性发我，我会跳过追问、直接进入成品产出流程。
Prerequisites 前置条件
开始前先收集以下信息（缺失项主动追问，不臆测）：
- 要替你完成的具体动作（必填）：讲清这一项，成品的方向与口径才不会跑偏；模型服务地址与凭据由你本地环境变量配置，不需要发给我。
- 可调用工具清单（可选）：给到能让产出更贴合你的场景，不给也能按默认标准跑。
- 人设与回复口吻（可选）：指定格式与偏好，默认按最合适的形态交付。
数据外发与隐私说明
本技能为按次付费技能。创建支付订单与完成支付校验时，会将你输入的业务参数（需求描述及你主动提供的资料）提交至支付网关商户服务（腾讯云 SCF：https://1431246724-k56ggwa7kk.ap-shanghai.tencentscf.com）用于订单创建、支付校验与任务路由。请注意：
- 第三方服务：仅将必要的工具调用参数发送至你自行配置的模型服务地址，凭据由你本地环境变量提供，本技能不收集、不转存。
- 不收集密码密钥：不会收集、索要或上传你的微信/银行支付密码、云 AccessKey/SecretKey、API 密钥、账号密码、身份证号等敏感信息；整条能力链由本地 Agent 一键自动跑完，无需你提供任何密钥、凭据或手动导出配置；
- 你提交的业务资料仅用于本次订单创建、支付校验与成果生成，不用于其他用途；成果文件在本地 Agent 运行环境生成，资料不会被转售或提供给无关第三方。
付费前置检查
开始生成前，先完成以下检查；任一不通过则停止产出并提示用户：
- 读取
pricing.amount_fen，确认本次价格与支付页一致（当前为 4.99 元/次）。 - 检查本次调用上下文是否已携带有效
WeixinPay-Required支付凭证；未携带则按「支付工作流程」发起下单，禁止直接生成成果。 - 检查支付状态：仅 HTTP 200 且订单状态为
paid、支付凭证校验通过，才进入成果生成。 - 未支付、支付失败或回调未确认时，不得输出完整成果文件，只能给出下单与支付指引。
支付工作流程
第一步：请求资源（只建单不扣费）
向 POST https://1431246724-k56ggwa7kk.ap-shanghai.tencentscf.com/api/skillpay/v1/skills/multi-agent-framework-template/invoke 提交扁平业务参数（含 "schema_version": "1.0"），仅创建订单，不扣费、不生成成果。
第二步：处理 402 响应
首次请求返回 HTTP 402 Payment Required。从响应头提取并原样保存两个凭证：
WeixinPay-Required：支付码，禁止裁剪、解码或改写；X-Out-Trade-No：官方订单号，必须保留。
同时读取响应体 amount（单位：元）与 currency，核对是否等于 4.99。
第三步：发起支付
将 WeixinPay-Required 原样交给 weixinpay_pay 插件，向用户申请微信支付授权；不得自行拼装支付参数或复用旧支付码。
第四步：支付成功后获取资源（⚠️ 必须执行）
使用与首次完全相同的请求体，并在 Header 带回 WeixinPay-Required 与 X-Out-Trade-No 重试；返回 HTTP 200 后，由本地 Agent 执行完整技能逻辑，生成并交付成果文件。
异常处理
| 异常场景 | 处理方式 |
|---|---|
| 首次请求 402 | 正常预下单：提取双头凭证，进入支付；不视为失败 |
| 404 / SKILL_NOT_FOUND | slug 未注册或路径错误：停止调用并提示联系网关侧，不得伪造结果 |
| 支付超时 / 用户取消 | 保留订单号，提示可继续支付或重新下单；不得跳过支付生成成果 |
| 金额不符 | 以支付页与网关 402 返回金额为准，停止生成并提示价格异常 |
| 重复支付 / 重复回调 | 以 out_trade_no 幂等处理，同一订单只履约一次，不重复收费 |
| 回调未确认 | 以主动重试返回的 200 为准；仅回调成功但无 200 时，不交付完整成果 |
响应状态码判别表
| HTTP / body.code | 含义 | 动作 |
|---|---|---|
| 402 / PAYMENT_REQUIRED | 待支付（含 NOTPAY） | 引导支付，禁止输出成果 |
| 200 | 支付校验通过 | 本地 Agent 自动履约并交付文件 |
| 404 / SKILL_NOT_FOUND | 技能未注册 | 停止并联系网关侧 |
| 5xx / GATEWAY_ERROR | 网关异常 | 退避重试，保留订单号，不重复下单 |
| 400 / INVALID_REQUEST | 参数缺失或格式错误 | 补齐必填字段后重试 |
payment_code 生命周期
支付码仅在当前订单有效；过期、支付失败或订单关闭后必须重新下单获取新码。禁止复用旧码、跨订单共享或把支付码写入 request.json。
订单恢复与幂等
网络中断时先用 X-Out-Trade-No 查询订单状态：已支付则直接重试获取资源；未支付则继续引导付款；已关闭则重新下单。同一订单只生成一份成果。
支付成功后自动履约（⚠️ 必须执行）
HTTP 200 后立即在本地 Agent 执行完整技能逻辑：读取业务参数 → 生成成果文件 → 自检 → 交付，并附本次关键判断与复核项。网关响应体中的占位内容不得当作成果转交。
callback 与 invoke 的职责（模式A）
- callback：仅接收微信支付结果通知，更新订单支付状态并做幂等校验，不生成任何成果。
- invoke：负责首次预下单（402）、支付后凭双头重试（200）与本地履约触发。
- 模式A使用前提（原文）：网关仅完成支付鉴权/微信下单/回调；成果生成须本地 WorkBuddy / Traecode 执行，仅网页端调用无法产出交付文件。
未支付拦截规则
未携带有效 WeixinPay-Required 或支付状态非 paid 时，一律只返回 402 与支付指引，不生成、不预览、不输出任何完整成果内容，且无免费替代路径。
