← 返回 Skills 市场
nonvnet-ux

Human-Agent Collaboration Protocol

作者 nonvnet-ux · GitHub ↗ · v1.1.0 · MIT-0
cross-platform ⚠ suspicious
77
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install human-collab-protocol
功能描述
人机协作协议执行器。以用户为主体,主动发起与一人或多人的沟通时触发。 触发词示例:我要组织个会、我约了XXX、我要和XXX沟通、我要去见XXX、我明天要见XXX。 会后触发:刚开完XXX的会、发来妙记链接。
使用说明 (SKILL.md)

人机协作协议 Skill v1.3

核心理念:Context Over Control 核心原则:先追问,再生成。Context Card是让所有参与者信息对称的共享文档,必须发给参会者。


触发条件

以用户为主体,主动发起与一人或多人的沟通,包括:

  • 正式会议
  • 一对一沟通
  • 见客户/合作方/同事
  • 任何"我要和XXX谈XXX"的场景

执行流程

场景A:会前

第一步:追问四个问题(必做,不可跳过)

用自然对话方式问:

  1. 这次沟通结束后,你希望对方做什么具体的事?或者拍什么板?
  2. 当前最大的风险或卡点是什么?
  3. 对方对这件事了解多少?需要补充哪些背景?
  4. 有哪些话题这次先不展开?

等用户回答后,才进入第二步。


第二步:生成 Context Card

Context Card是发给所有参与者的共享文档,目的是让每个人带着相同的背景进会议室。

生成后发给用户确认,确认后:

  1. 调用 feishu_create_doc 写入飞书,返回链接
  2. 提示用户将链接转发给参会者

格式(纯文本):

【事项名】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:

  • [字段] → [新内容]

🔔 下次协作触发条件:

  • [什么情况下需要再协作]

如妙记内容不清晰,主动追问关键决定的负责人和截止时间。

第三步:确认后自动执行

收到用户确认后:

  1. 调用 feishu_task_task 创建飞书任务,指派负责人,设置截止日期
  2. 调用 feishu_update_doc 更新对应 Context Card
  3. 将 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
安全使用建议
This skill appears to be what it says (meeting prep and follow-up), but it instructs the agent to call Feishu APIs (create/fetch/update docs and create tasks) and to save outputs to agent memory while declaring no required credentials or config. Before installing or enabling it, confirm: 1) whether your agent platform already provides a secure Feishu connector (and what permissions it will grant — read/update docs, create tasks), 2) who supplies the Feishu credentials and whether they remain private, and 3) whether you’re comfortable meeting content being stored in agent memory/YYYY-MM-DD.md. If the platform does not provide a built-in Feishu integration, ask the skill author to explicitly declare required env vars/permissions (e.g., FEISHU_APP_ID/APP_SECRET or workspace token) and to explain how auth is obtained and scoped. If you cannot verify these, treat the skill as risky because it may attempt to access external documents and persist sensitive meeting data without explicit credential handling.
功能分析
Type: OpenClaw Skill Name: human-collab-protocol Version: 1.1.0 The skill implements a structured human-collaboration protocol designed to manage meeting preparation and follow-ups using Feishu (Lark) integration. It utilizes standard tools like 'feishu_create_doc', 'feishu_fetch_doc', and 'feishu_task_task' to automate document and task management, while maintaining a 'Context Over Control' philosophy that requires explicit user confirmation before performing write operations. No evidence of data exfiltration, malicious execution, or prompt injection was found in SKILL.md or _meta.json.
能力评估
Purpose & Capability
Name/description (human-agent collaboration for meetings) align with the SKILL.md workflow (pre-meeting questions, Context Card, post-meeting Output and task creation). The high-level capability is coherent with the content.
Instruction Scope
Runtime instructions direct the agent to call feishu_create_doc, feishu_fetch_doc, feishu_task_task, and feishu_update_doc and to save Output to memory/YYYY-MM-DD.md. These actions are within meeting workflow scope, but they involve fetching/updating external documents and persistent storage without describing how auth/permissions are obtained or what exact endpoints are used.
Install Mechanism
Instruction-only skill with no install spec and no code files — low install risk. Nothing will be written to disk by an installer.
Credentials
The instructions clearly require access to Feishu APIs (read/write docs, create tasks) and to persist outputs in agent memory, yet the skill declares no required environment variables, credentials, or config paths. Missing declaration of Feishu credentials/permissions is a proportionality mismatch and a practical blocker (or a stealth requirement).
Persistence & Privilege
always is false and the skill does not request elevated platform privileges. It does direct writing to memory/YYYY-MM-DD.md (agent memory/persistent storage) and to external Feishu docs/tasks after user confirmation; this is reasonable for its purpose but should be explicitly disclosed.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install human-collab-protocol
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /human-collab-protocol 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.1.0
v1.1: Context Card定位修正——是发给所有参与者的共享文档,用于信息对称,不是内部文档。输出两部分:Context Card(发给参与者)+ 协作Prompt(用户自用)。
v1.0.0
Context Over Control: 会前追问生成Context Card+协作Prompt,会后生成Output+创建飞书任务。适用于任何以用户为主体发起的人与人沟通场景。
元数据
Slug human-collab-protocol
版本 1.1.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 2
常见问题

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。

💬 留言讨论