Human-Agent Collaboration Protocol
/install human-collab-protocol
人机协作协议 Skill v1.3
核心理念:Context Over Control 核心原则:先追问,再生成。Context Card是让所有参与者信息对称的共享文档,必须发给参会者。
触发条件
以用户为主体,主动发起与一人或多人的沟通,包括:
- 正式会议
- 一对一沟通
- 见客户/合作方/同事
- 任何"我要和XXX谈XXX"的场景
执行流程
场景A:会前
第一步:追问四个问题(必做,不可跳过)
用自然对话方式问:
- 这次沟通结束后,你希望对方做什么具体的事?或者拍什么板?
- 当前最大的风险或卡点是什么?
- 对方对这件事了解多少?需要补充哪些背景?
- 有哪些话题这次先不展开?
等用户回答后,才进入第二步。
第二步:生成 Context Card
Context Card是发给所有参与者的共享文档,目的是让每个人带着相同的背景进会议室。
生成后发给用户确认,确认后:
- 调用 feishu_create_doc 写入飞书,返回链接
- 提示用户将链接转发给参会者
格式(纯文本):
【事项名】Context Card 更新时间:YYYY-MM-DD
为什么要做这件事(价值和意义): 一句话现状: 当前核心进展: 当前卡点: 已确认的: 还不确定的: 这次沟通要解决的问题: 相关文档:(如有)
第三步:生成 协作Prompt(用户自用)
Context Card确认后,单独生成协作Prompt供用户参考,明确分工和目标。
格式(纯文本):
协作Prompt(用户自用,不需要发给对方)
议题: 参与者及职责:
- 用户:
- XXX:
这次要回答的问题:(一个具体可决策的问题) 当前风险/卡点: 这次不讨论:
⚠️ 开会请开启录音豆,会后把妙记链接发给我,我生成Output和任务。
场景B:会后
用户发来妙记链接或说"刚开完XXX的会"时触发。
第一步:读取妙记内容
调用 feishu_fetch_doc 获取妙记文档内容。
第二步:生成 Output 草稿
纯文本输出:
协作Output 日期:YYYY-MM-DD 主题:XXX
✅ 决定了:
- [内容] → 负责人:XXX,截止:XX月XX日
❓ 还没决定:
- [问题] → 谁去找答案:XXX,截止:XX月XX日
📋 需要更新的 Context Card:
- [字段] → [新内容]
🔔 下次协作触发条件:
- [什么情况下需要再协作]
如妙记内容不清晰,主动追问关键决定的负责人和截止时间。
第三步:确认后自动执行
收到用户确认后:
- 调用 feishu_task_task 创建飞书任务,指派负责人,设置截止日期
- 调用 feishu_update_doc 更新对应 Context Card
- 将 Output 记录到当日 memory/YYYY-MM-DD.md
输出规范
- 所有输出一律纯文本,不用代码块(```)包裹
- 两部分明确分开:
- 第一部分:Context Card(发给所有参与者)
- 第二部分:协作Prompt(用户自用)
- 中间用分隔线隔开,并标注哪部分发给对方、哪部分自用
- Context Card简洁清晰,对方能在2分钟内读完
人机边界
| 决策类型 | 谁来做 |
|---|---|
| 追问、提取、摘要、任务创建 | Agent自动执行 |
| Context Card内容确认 | 用户确认后才写入飞书并转发 |
| Output内容确认 | 用户确认后才创建任务 |
| 最终拍板(资源/人事) | 用户独占 |
关联文档
- 人机协作协议 v1.0:https://www.feishu.cn/docx/JSFIdBEVeoo6mYxdlCNcmnxHnxb
- 落地操作手册 v1.0:https://www.feishu.cn/docx/VG9qdaLwroC2kMx027Sc6X12nrb
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install human-collab-protocol - 安装完成后,直接呼叫该 Skill 的名称或使用
/human-collab-protocol触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Human-Agent Collaboration Protocol 是什么?
人机协作协议执行器。以用户为主体,主动发起与一人或多人的沟通时触发。 触发词示例:我要组织个会、我约了XXX、我要和XXX沟通、我要去见XXX、我明天要见XXX。 会后触发:刚开完XXX的会、发来妙记链接。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 77 次。
如何安装 Human-Agent Collaboration Protocol?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install human-collab-protocol」即可一键安装,无需额外配置。
Human-Agent Collaboration Protocol 是免费的吗?
是的,Human-Agent Collaboration Protocol 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Human-Agent Collaboration Protocol 支持哪些平台?
Human-Agent Collaboration Protocol 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Human-Agent Collaboration Protocol?
由 nonvnet-ux(@nonvnet-ux)开发并维护,当前版本 v1.1.0。