| name | coze-project |
| description | 仅在 `<coze-context>` 标识为"群聊消息"且任务涉及该群组协作时使用——浏览群消息历史、查询群成员、读写编辑群项目文件、协调群里的多方协作、把协作产出衔接给用户。触发场景: 用户问"上次说啥/这次结论是啥"、"谁在群里/有谁的权限"; 用户让你"看一下/改一下/沉淀到"群文件; 用户让你基于群历史/群文件做产出。在"单聊消息"或与该群协作无关的一般性问答下不要使用。 |
coze-project: 群聊协作
Coze 是 agent 协作平台: 单聊或拉到群里跟多个用户协作。本技能教你在群聊场景下如何协作——查群成员 / 看群历史 / 读写群文件 / 把协作产出衔接给用户。
群 == 项目: <coze-context>.group_id 直接当 coze agent --project-id 用。
CLI 详细语法分两个参考文件 (要敲命令时 Read):
触发条件 (必须同时满足)
<coze-context> 第一行字面值是 群聊消息 (不是 单聊消息)- 任务涉及该群协作 (成员 / 历史 / 文件 / 多方协调)
任一不满足都不用本技能。一般性问题 (如 "解释 Go 泛型") 即使在群里也直接答, 不要无谓调用 coze agent。
从 <coze-context> 提取参数
群聊上下文块形如:
<coze-context>
群聊消息
account_id: 7639...001
agent_id: 7639...571
session_id: 7639...999
group_id: 7639...888
</coze-context>
| 字段 | 用途 |
|---|
group_id | → coze agent --project-id |
account_id | → coze agent --org-id |
agent_id / session_id | 给 coze-send 衔接用, 不传给 coze agent |
拿不到 group_id → 停下来, 本技能不适用。不要编, 不要问用户, 缺失就是不匹配信号。
在群里协作的原则
群聊不是 1v1, 你面向多个用户 + 共享群文件。在群里协作有几个根本不同于单聊的姿势, 不熟会出洋相:
事实优先于猜测
- 用户说"上次说啥"、"我们之前讨论的"、"那个方案"→ 主动
message list 查, 不要靠想象
- 群消息 + 群文件 = 项目的长期记忆, 比你自己对话记忆更可信
- 不确定时先
message list --asc-mode --need-reference 拉一段看清, 再回答; 凭印象答群里历史是大忌
沉淀优先于回话
- chat 消息会被刷走, 群文件不会——决策 / 结论 / 行动项 / 草稿要
file edit 沉淀到群文件
- 用户问完答完就过, 但群文件是项目长期资产, 别人后面还会翻
- 信号: "记一下" / "沉淀" / "加到 todo" / "更新 README" / "整理到文档" → 一定
file edit, 不能只在 chat 里回
共享意识 — 群文件是大家的
- 破坏性改动 / 大范围改动前先审计 (
info + member list + file list), 把当前状态向用户对齐
- 改用
file edit replace_one 而不是 file write 整覆盖, 避免抹掉别人添加的内容
- 改完必须接 coze-send
--group-file 通知用户, 让对方明确看到你改了什么 (见下"协作产出"节)
多用户分辨
- 同一群里不同用户的请求可能冲突, 不要把 A 的诉求执行到 B 的命题上
- 权限 / 角色相关先
member list 看实际角色, 不要假设谁是 owner
- 引用前文带发言人 ("X 之前提过 ..."), 不要把别人的发言归到当前提问者头上
- 当前提问者和"上次说要做这件事的人"可能不是同一人, 回复时指代要清楚
协作场景速查 (意图 → 命令 + 参考文件)
| 用户意图 | 命令 | 详细语法 |
|---|
| 谁在群里 / 有谁权限 | coze agent member list | query |
| 群历史 / 上次说啥 | coze agent message list | query |
| 项目元数据 | coze agent info | query |
| 列群文件 / 看目录 | coze agent file list | files |
| 读群文件 | coze agent file read | files |
| 改群文件 (改一段) | coze agent file edit | files |
| 改群文件 (整覆盖) | coze agent file write | files |
| 把产出展示给用户 | coze-send --group-file | (见下"协作产出"节) |
所有 coze agent 命令都必须带 --json + --org-id "$account_id" + --project-id "$group_id"; 输出信封 / 错误码 / jq 模板等机制见参考文件。
协作产出 → 让用户看到
核心衔接点: 你 coze agent file write/edit 改完群文件后, 用户在聊天界面不会被自动通知——必须用 coze-send 群文件模式 (--group-file) 把产出"递"过去。文件已在云端, 走 --group-file 跳过上传, 直接 path 透传。
coze agent file edit --org-id "$account_id" --project-id "$group_id" \
--file-path "本周周报.md" \
--mode replace_one --old-string "..." --new-string "..." --json
~/.coze/bridge/bin/coze-bridge send file "本周周报.md" \
--agent-id "$agent_id" --session-id "$session_id" \
--group-file --mime text/markdown \
--name "本周周报.md" --caption "已按你的要求更新"
跨技能参数对应: <coze-context>.agent_id → --agent-id; <coze-context>.session_id → --session-id; file edit 用的 --file-path → coze-send 的位置参数。详见 coze-send 技能。
常见工作流
- 先读后编辑 (改群文件安全默认):
file list 确认 → file read 找唯一锚点 → file edit --mode replace_one → 衔接 coze-send --group-file. 详见 files.
- 审计群信息 (用户问"群里啥情况"):
info + member list + file list --depth 3 → 汇报给用户. 破坏性操作前必走. 详见 query / files.
- 追溯讨论结论 (用户问"上次说啥"):
message list --asc-mode --need-reference, --size 10 翻页累积 (硬上限), 摘要关键节点. 详见 query.
不要做的事 (协作层面)
- ❌ 单聊消息不要用本技能 — 没 group_id,
coze agent 会失败
- ❌ 不要向用户要 / 编造 group_id — 必须从
<coze-context> 抄
- ❌ 改完群文件不要就完事 — 必须接 coze-send
--group-file 收尾, 否则用户看不到
- ❌ 不要在不审计的情况下做破坏性操作 — 先 info + member + file list
CLI 层面的"不要做的事"（--json 必带、信封 .code 校验、file write 误用、message list 上限等）见各参考文件。
