EP-Hub-Skill/etunel-role-collaboration/references/human-readable-communication.md

人类可读沟通

编写给当前负责人、其他角色负责人或项目群组的任务、问题、结果和状态消息时读取。目标是让接收人一次看懂“发生了什么、需要做什么、下一步是什么”。

语言边界

• 使用简体中文和常用词；一句话能说清的内容不换成流程术语。
• 正式成果、过程记录、标题、正文和结论使用中文名称。
• SDK、BOM、PCB、固件版本等确有必要的行业术语可以保留，但不要中英文重复堆叠。
• role、message_id、correlation_id 和状态枚举只用于工具或机器记录。除非排障、重名或精确引用确有必要，不向负责人展示。
• 需要表达机器状态时先说中文含义，例如“当前被阻塞”“等待补充”“已经确认”；不要只发状态码。

负责人称呼

Hub 调用 mcp__etunel__etunel_list_roles 后，按目标 role 找到对应记录：

• role 用于 Etunel 路由；
• display_name 用作消息中的角色或负责人称呼；
• relationship 只作为 Etunel 返回的关系事实，不自行解释出不存在的成员身份。

review 只是可能出现的角色示例，不得硬编码。成员会话不能调用 Hub 专用的角色列表工具，也无需知道负责人 ID；直接把当前用户称为“你”或“负责人”。

一次说清任务

正式任务通常写清：

1. 这次要完成什么；
2. 已经提供哪些有效资料和版本；
3. 哪些内容属于本次范围，哪些不需要处理；
4. 要交付哪些文件或结果，做到什么程度算完成；
5. 期限、下游用途和需要负责人确认的事项；
6. 信息不足或遇到阻塞时如何返回。

这些内容可以用短段落或 Markdown 列表自然组织，不要求固定模板。不要在开头堆项目 ID、任务 ID、角色 ID、会话 ID、英文状态和内部字段。

提问、结果和阻塞

缺信息时一次说明：缺什么、为什么需要、缺失会影响什么、建议向谁获取、现在还能继续什么。不要逐句追问。

返回结果时先说结论，再列成果文件、关键验证、仍未解决的问题和下一步。专业细节放在成果文件中，不把大段日志粘到聊天正文。

报告阻塞时说明：当前问题、已经尝试了什么、影响范围、需要谁采取什么动作、恢复条件。机器标识由 Etunel 工具关联，不要求负责人手工抄写。

面向 Hub 与钉钉

成员交给 Hub 的消息也应简明，但可以附成果路径、版本和证据引用供校验。Hub 转发时忠实保留专业结论，不把内部机器字段一并转给下游。

钉钉消息可以使用 Markdown 标题、段落和列表。保持中文、简短、可公开，只写已验证进展、问题、影响和下一步；详细规则见 钉钉项目进度汇报。