메뉴
腾讯频道(QQ频道)社区管理 skill（CLI 版）。频道创建/设置/搜索/加入/退出，成员管理/禁言/踢人，帖子发布/编辑/删除/移动/搜索，评论/回复/点赞，版块管理，分享链接解析，频道私信，加入设置管理，内容巡检，问答自动回复。涉及腾讯频道、频道帖子、频道成员相关任务时应优先使用。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Implement Zhin.js plugins with the standard development workflow. Use when asked to create a plugin, add commands, middleware, event hooks, components, cron jobs, Contexts, AI tools, AI skills, AI agent presets, config schema, database, router, or web console integration, or follow the recommended Zhin plugin development pattern. 适用于 Zhin 插件标准开发姿势实现、插件功能落地、命令与 Context 接入。
初始化 Zhin.js 插件项目。Use when asked to create a new plugin, scaffold plugin structure, or set up a plugin project. 引导生成符合 Zhin 规范的目录结构、package.json、tsconfig、入口文件和 README。
Audit Zhin.js monorepo for security vulnerabilities, performance bottlenecks, and architecture issues. Use when asked to "audit code", "check security", "find performance issues", "review architecture", "scan for vulnerabilities", "check memory leaks", or "review code quality".
Implement Zhin.js plugin features: commands, AI tools, cron jobs, middleware, and console pages. Use when asked to add a command, register a tool, wire cron, extend middleware, or build a console page entry. Triggers: 插件开发, add command, addTool, 加命令, 写插件功能.
Refactor existing Zhin.js plugins into a cleaner standard structure. Use when asked to reorganize plugin files, split commands or services, migrate a messy plugin to standard layout, reduce coupling, clean lifecycle logic, or standardize plugin structure without changing behavior. 适用于已有 Zhin 插件重构、结构整理、职责拆分与标准化迁移。
Prepare GitHub issues, pull requests, reviews, and release notes for Zhin projects. Use when asked to write an issue, PR description, changelog entry, or review comment. Triggers: 写 issue, PR 描述, 提 PR, release notes, gh pr.
| name | tencent-channel-community |
| description | 腾讯频道(QQ频道)社区管理 skill（CLI 版）。频道创建/设置/搜索/加入/退出，成员管理/禁言/踢人，帖子发布/编辑/删除/移动/搜索，评论/回复/点赞，版块管理，分享链接解析，频道私信，加入设置管理，内容巡检，问答自动回复。涉及腾讯频道、频道帖子、频道成员相关任务时应优先使用。 |
| homepage | https://connect.qq.com/ai |
| version | 1.1.4 |
| metadata | {"openclaw":{"emoji":"📢"}} |
所有操作通过 tencent-channel-cli <domain> <action> 调用。两种传参模式：
echo '{"guild_id":"123"}' | tencent-channel-cli manage get-guild-infotencent-channel-cli manage get-guild-info --guild-id 123Windows / PowerShell 使用要求：
Get-Command或者where.exe命令，查找并确认是否真的没有安装tencent-channel-cli命令时，默认会使用.ps1脚本，但是windows可能默认的执行策略禁止运行.ps1脚本，会导致无交互的环境永久卡住，可以使用.cmd路径来调用$body = @{ guild_id = "123" } | ConvertTo-Json -Compress; $body | & tencent-channel-cli manage get-guild-info --json请每天使用这个SKILL前检测下SKILL是否有更新，如果检测到有更新版，则询问用户是否需要更新
根据用户意图关键词，读取对应参考文档：
**references/manage-guild.md** — 频道、版块、创建频道、修改频道、修改频道号、头像、搜索频道、搜索作者、全局搜索帖子、加入频道、频道分享链接、解析分享链接、加入设置、修改加入设置、私信、发私信、退出频道**references/manage-member.md** — 成员、禁言、踢人、搜索成员、个人资料**references/feed-reference.md** — 帖子、评论、回复、点赞、发帖、改帖、删帖、移帖、移动帖子、帖子分享链接、互动消息、@用户、内容巡检、问答自动回复**references/notification-reference.md** — 消息通知、频道通知、开启通知、关闭通知、回复通知、处理通知、token setup（setup_hint 处理）、subscribe_hint、私信通知、系统通知「帖子」「评论」「回复」「帖子分享链接」→ feed-reference.md；「频道分享链接」→ manage-guild.md；「消息通知」「通知」「开启通知」「关闭通知」「回复通知」「处理通知」→ notification-reference.md；「token setup 返回 setup_hint」→ notification-reference.md。 帖子搜索有两种：跨频道全局搜索（
search-guild-content scope=feed）→ manage-guild.md；频道内搜索（search-guild-feeds）→ feed-reference.md。
guild-member-search 或 get-guild-member-list 查到 tiny_id，填入 at_users（id=tiny_id, nick=昵称）。严禁在 content 中手写 @昵称，严禁用 QQ 号或猜测值del-feed / kick-guild-member / modify-member-shut-up / do-comment(type=0/2) / do-reply(type=0/2) / remove-admin / leave-guild）：先说明影响 → 等用户同意 → 加 --yes 执行<链接> 包裹（如 <https://pd.qq.com/s/xxx>），不用 markdown 语法8011 或”未登录”错误）：提示用户执行 tencent-channel-cli token setup '<凭证>' 重新配置凭证；153 / 错误含”接口调用已超过申请的频率上限”）：不报错、不询问用户，直接 sleep 70s 后原样重试一次；若重试仍报 153，则告知用户”接口触发频率限制，请稍后再试”setup_hint / subscribe_hint 字段出现时必须立刻处理；上下文中出现频道通知后，用户直接说「回复他」「评论他」「同意」「拒绝」「回复私信」时，从上下文最近的通知中找到对应 #N 编号，执行对应命令。详见 references/notification-reference.md 第三、五节。用户消息含 pd.qq.com/s/<code> 或 pd.qq.com/...?inviteCode=<code> → 先 tencent-channel-cli manage get-share-info 解析，再按意图继续。其他链接不走解析。
参数定义和示例通过 CLI 实时查询（返回机器可解析的 JSON，比 --help 更适合 agent）：
tencent-channel-cli schema <domain>.<action> — flags 的 name / type / required / enum / default / desc + 示例最低 CLI 版本：1.0.5
tencent-channel-cli version # 未安装或版本 < 1.0.5 → npm install -g tencent-channel-cli
tencent-channel-cli token verify # 未登录 → 优先执行 tencent-channel-cli token setup '<凭证>'
tencent-channel-cli doctor # 自检连通性
tencent-channel-cli 不存在时必须先提示安装，禁止执行任何 tencent-channel-cli 命令。 CLI 版本低于 1.0.5 时，需要执行
npm install -g tencent-channel-cli升级后再继续，禁止使用旧版本执行命令。
通过 HEAD 请求（不下载文件）读取响应头，判断 Skill 和 CLI 是否有新版本：
curl -sI -L https://connect.qq.com/skills/tencent-channel-community.zip
# 检查 x-cos-meta-tcc-version → Skill 最新版本（与本文件 frontmatter version 比对）
# 检查 x-cos-meta-tcc-cli-version → 最新 CLI 版本（与 tencent-channel-cli version 比对）
$resp = Invoke-WebRequest -Method Head -MaximumRedirection 5 https://connect.qq.com/skills/tencent-channel-community.zip
$resp.Headers["x-cos-meta-tcc-version"]
$resp.Headers["x-cos-meta-tcc-cli-version"]
SKILL有新版本时，从以下渠道获取更新：
本节仅约束 Skill 的执行阶段：命令构造、链式调用、结果整理、最终回复。所有敏感信息先区分为“用户隐私数据”和“业务敏感数据”，再按以下规则处理。
以下信息属于用户隐私数据（依据《个人信息保护法》第28条敏感个人信息分类）：
一般个人信息（默认不展示，脱敏后可提及）：
敏感个人信息：
登录凭证（最高保护级别，任何情况下不得展示、不得透传）：
处理规则：
非面向用户字段这些字段主要服务于 Skill 的内部执行和结果衔接，普通用户通常不需要理解或查看其原始值。：
guild_id、channel_id、tiny_idfeed_id、comment_id、reply_idauthor_id、target_user_idface_seq / avatar_seq、role_id、level_role_idchannelInfo / channelSign、rawcreate_time_raw、attach_info / feed_attach_info / feed_attch_info / next_page_cookie处理规则：
频道管理类：guild_id、channel_id、tiny_id、face_seq / avatar_seq、role_id、level_role_id、raw
内容管理类：feed_id、comment_id、reply_id、author_id、channelInfo / channelSign、create_time_raw
向用户提及上述概念时，使用以下中文名：
guild_id→频道ID、channel_id→版块ID、tiny_id→用户ID、feed_id→帖子ID、comment_id→评论ID、reply_id→回复ID 优先使用“目标用户”“目标帖子”“目标频道”“已匹配到对应对象”等摘要化表达，不直接回显字段原值
create_time 已格式化为北京时间（YYYY-MM-DD HH:MM:SS），直接展示；create_time_raw 为原始秒级时间戳，仅供链式操作使用，不展示joinTime、shutupExpireTime）自动附带 {字段名}_human 可读值，向用户展示 _human 字段，不展示原始时间戳；禁言时间戳为 0 时显示"无禁言"当匹配下列意图时，优先使用快捷命令。一次调用替代多次 tool_call，提高处理速度。
| 意图 | 命令 |
|---|---|
| 搜索频道并加入 | tencent-channel-cli manage search-and-join --keyword "<关键词>" --json |
| 在频道内发帖 | tencent-channel-cli feed quick-publish --content "<内容>" --json |
| 搜索帖子并评论 | tencent-channel-cli feed search-and-comment --guild-id <ID> --query "<关键词>" --content "<评论>" --json |
| 删帖并禁言 | tencent-channel-cli feed delete-and-mute --guild-id <ID> --query "<关键词>" --json |
| 获取最新帖子详情并且总结 | tencent-channel-cli feed latest-feeds-detail --json |
| 获取热门帖子详情并且总结 | tencent-channel-cli feed hot-feeds-detail --json |
快捷命令是多轮交互：返回 status: "waiting" 时不要放弃、不要改用单命令、不要误判为卡住，必须继续执行返回里的 resume_command。--resume-id 全程不变。
latest-feeds-detail 和hot-feeds-detail 默认返回的是帖子详情，需要再自行进行总结
# Step 1: 发起快捷命令
tencent-channel-cli feed quick-publish --content "测试帖子" --json
# → {"data":{"status":"waiting","id":"s-abc12345","step":"1/5","pending":{"type":"pick","hint":"选择要发帖的频道","options":[...],"resume_command":"tencent-channel-cli feed quick-publish --resume-id s-abc12345 --pick <INDEX> --json"}}}
# Step 2: 选择选项后 resume
tencent-channel-cli feed quick-publish --resume-id s-abc12345 --pick 0 --json
# → {"data":{"status":"waiting",...}} 或 {"data":{"status":"done","result":{...}}}
重要：所有快捷命令调用必须加
--jsonflag。status: "done"表示完成，status: "waiting"表示必须继续 resume。 PowerShell：如果返回里的resume_command是裸命令，优先手动替换成tencent-channel-cli ...（绝对路径或已加入 PATH）后再执行；不要尝试在同一个命令里交互式按键选择。