喧喧应用集成：官方 Agent Skills 使用说明

做过喧喧与内部系统对接的同事，往往要在后台、接口文档和调试工具之间反复切换。我们在 GitHub 维护的开源仓库 limu-xuanim/skills ，是为了让大家在常用编程助手里，用更短的路径完成「查数据、发通知、写示例代码」这些事。

当前技能处于 实验阶段 ，会持续更新。用于正式环境前，请做好评审与测试；涉及发消息、推通知等操作，务必先在测试环境验证。

如何使用

1. 准备环境

在喧喧后台完成 应用集成 ，记下 应用代号 、 应用密匙 。

2. 安装到编程助手

本机已安装 Node 时，在终端执行（具体以仓库 README 为准）：

npx skills add limu-xuanim/skills

只需要与喧喧 API 相关的部分时，可执行：

npx skills add limu-xuanim/skills --skill xuanim-api

3. 在对话里说明要做什么

安装完成后，在已支持本技能的助手中， 建议在同一条消息里 写清三件事，再写你要办的业务，避免助手缺参数去猜：

应用代号 ：后台「应用集成」里显示的代号（即接口里的 code ），原样粘贴，注意区分大小写。
应用密匙 ：同一页里的密匙（即接口里的 key ），原样粘贴，不要加引号或多余空格。
服务地址：能访问到喧喧服务端接口的完整 URL，需带协议（http:// 或 https:// ），一般形如 https://你的喧喧域名 或内网 http://IP:端口 ，以你环境实际为准。

应用代号：（填后台里的代号）
应用密匙：（填后台里的密匙）
服务地址：（填完整 URL，含 http/https）
请帮我：获取当前喧喧里全部讨论组列表。

写法上可以用 固定标签 ，方便助手解析，例如把下面整段复制到对话里，再把占位内容换成你自己的（以上为示意，请勿照抄示例值）

同一轮对话里若还要查成员、发消息等， 后续每条任务 也建议重复带上这三项（或写一句「应用代号、密匙、x.php 地址同上一轮」），以免新开话题后助手拿不到配置。涉及发消息、推通知时，请在同一消息里写清 讨论组名称或 gid 、 消息正文 等执行所需信息。

任务举例（均须配上文三段配置信息）：

请始终使用你自己环境中的真实配置；勿使用他人文章或示例里的占位密钥。密匙属于敏感信息，请勿发到不可信的公共渠道；对外截图、录屏前务必打码。

注意：当前与AI对话演示仅基于文章发布日期的skill版本，不代表后续skills更新后的行为表现。

更多示例话术见仓库 README，可按业务场景改写成自己的说法。

对接效率
不必从长文档里逐段定位再手写一遍：说明「要什么数据、发给谁、写什么内容」，助手可以按官方约定给出可执行的调用方式或示例代码，减少来回翻页和复制粘贴。

协作与交付
团队里多人对接喧喧时，大家面对的是同一套官方整理的能力说明，口径更容易对齐；新人接手时，也可以先通过对话生成示例，再在项目里落地改造。

常见集成场景
在正确使用的前提下，可以覆盖日常集成里最常用的几类能力：讨论组与成员信息查询、通知中心推送、讨论组内发消息，以及按你的技术栈生成调用示例，便于接入 OA、工单、监控等周边系统。

使用边界
助手输出仍需人工核对后再执行；生产变更请以喧喧二次开发手册与应用集成 API 文档及当前服务端实际行为为准。若接口返回异常，请结合官方文档与后台配置逐项排查。