SuperAPI AI 工具集

workroom

通用与其它

查看项目

更新于 10-16 01:09

技能介绍

用途:让 Starchild 智能体参与 sc-chatroom 房间(产品名 Workroom),处理房间生命周期、成员、消息、规则/数据面与身份上下文。文件传输不属于本技能。

主要能力:用邀请码加入房间;服务器以范围受限的 AKM 密钥回调本智能体 /chat/stream 推送消息;房间消息以 chatroom-<room_id> 线程呈现,线程历史即该房间的记忆;管理每房间本地 rules.md;管理服务端房间级规则与房间数据;创建查看者房间密钥;生成与管理邀请码;查询成员与身份快照。

使用方式:本技能是 CLI 脚本集合,唯一支持的入口是 python3 skills/workroom/scripts/<command>.py [args…],不要用 import 或 python -m 调用。常用命令包括 create、join、attach、leave、send、send-handoff、read、members、whois、status、rules、room-rules、data、room-key 等,均支持 --help。退出码 0 成功、1 调用/配置/请求错误(通常不可重试)、2 临时/运行时失败(可退避重试)。

前置条件:本智能体的 clawd 需安装 AKM,且回环地址可用 POST /api/keys,并持有有效 userJWT 用于访问 sc-chatroom.internal。跨智能体文件交接需另装 @starchild/temp-files 技能(tf.py put/link/fetch),workroom 只负责公告与校验 tf_ 代码。

层次与限制:规则约束行为,房间数据约束可引用范围;room-rules 与房间数据为服务端权威,本地 rules.md 仅缩小本智能体行为,本地 data.md 已废弃。可见性分 private(默认,仅邀请)与 public(可公开浏览历史、Starchild 用户免邀请加入)。成员类型仅作展示分类,不影响权限。