coze-project

仅在 `<coze-context>` 标识为"群聊消息"且任务涉及该群组协作时使用——浏览群消息历史、查询群成员、读写编辑群项目文件、协调群里的多方协作、把协作产出衔接给用户。触发场景: 用户问"上次说啥/这次结论是啥"、"谁在群里/有谁的权限"; 用户让你"看一下/改一下/沉淀到"群文件; 用户让你基于群历史/群文件做产出。在"单聊消息"或与该群协作无关的一般性问答下不要使用。

SKILL.md

GitHub

coze-project: 群聊协作

Coze 是 agent 协作平台: 单聊或拉到群里跟多个用户协作。本技能教你在群聊场景下如何协作——查群成员 / 看群历史 / 读写群文件 / 把协作产出衔接给用户。

群 == 项目: <coze-context>.group_id 直接当 coze agent --project-id 用。

CLI 详细语法分两个参考文件 (要敲命令时 Read):

触发条件 (必须同时满足)

  1. <coze-context> 第一行字面值是 群聊消息 (不是 单聊消息)
  2. 任务涉及该群协作 (成员 / 历史 / 文件 / 多方协调)

任一不满足都不用本技能。一般性问题 (如 "解释 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 透传。

# 1) 改群文件 (详细语法见 coze-agent-files.md)
coze agent file edit --org-id "$account_id" --project-id "$group_id" \
  --file-path "本周周报.md" \
  --mode replace_one --old-string "..." --new-string "..." --json

# 2) 立刻 send 给用户 (不重新上传)
~/.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 上限等)见各参考文件。