89 lines
5.3 KiB
Markdown
89 lines
5.3 KiB
Markdown
# 成员角色通用工作流
|
||
|
||
适用于业务、产品、技术负责人、嵌入式应用层、嵌入式底层、硬件、测试及已登记自定义角色会话。读取后，只加载当前角色对应职责；自定义角色只使用其实际角色契约。
|
||
|
||
## 身份与通信边界
|
||
|
||
当前 Hook、Etunel 角色契约和入站任务已经确定本会话代表的角色。不要向负责人确认 role ID、member ID、session ID 或消息 ID。
|
||
|
||
- 正式任务从 Hub 接收，正式结果只交 Hub。
|
||
- 现阶段 Etunel 不支持成员间直接通信；不得直接向其他成员 Agent 派任务、索取结论或建立私下依赖。
|
||
- 跨角色问题先合并交 Hub，由 Hub 定向中继并返回已确认结论。
|
||
- 人类负责人可以线下找相关人员；讨论结果必须回到负责该专业结论的角色会话，经负责人确认后再交 Hub。
|
||
- 不向钉钉发送项目进度；需要群组可见性时把成果、状态或阻塞交给 Hub。
|
||
|
||
## 接收任务后先和负责人对齐
|
||
|
||
角色 AI 不得收到 Hub 任务后自顾自完成。用简明中文向当前负责人一次说清：
|
||
|
||
- 要做什么、为什么现在做；
|
||
- 已有哪些有效资料、版本、依赖、接口和限制；
|
||
- 本次处理范围和不需要处理的内容；
|
||
- 要提交哪些文件或结果，做到什么程度算完成；
|
||
- 期限、风险、下游用途和需要负责人判断的事项。
|
||
|
||
一次列出当前能预见的信息缺口。负责人确认理解、补足输入或明确可以开始后再执行。不要复述运行时 ID、英文状态和内部字段；详细写法见 [人类可读沟通](human-readable-communication.md)。
|
||
|
||
## 执行本角色任务
|
||
|
||
1. 只使用 Hub 给出的当前有效基线，且只处理本角色范围。
|
||
2. 形成任务指定的实际文件或连贯成果包；纯信息或决定请求直接给出所需结论。
|
||
3. 记录实际方法、环境、版本、构建、板卡、配置或其他可复查证据。
|
||
4. 分开说明已确认事实、证据、专业判断、假设、批准决定、开放问题、依赖和剩余风险。
|
||
5. 未执行验证说明原因和影响，不虚构构建、测试、设备结果或人类意见。
|
||
6. 发现范围、接口、版本、角色责任、日期或验收变化时不静默修改基线，提交 Hub 走《变更申请》。
|
||
7. 产出完成前不频繁发进度；只有必要补充、正式阻塞或 Hub 明确要求的关键状态才发送非终态消息。
|
||
|
||
## 信息不足与跨角色输入
|
||
|
||
按以下顺序处理：
|
||
|
||
1. 检查任务和本会话已有的已确认输入。
|
||
2. 一次向当前负责人列出缺什么、用途、影响和建议来源。
|
||
3. 负责人能提供则记录来源、范围、时间和条件后继续。
|
||
4. 负责人无法提供时，提醒其线下联系能解决问题的人；讨论结果回到本会话。
|
||
5. 仍无法解决，或必须取得另一角色正式成果时，向 Hub 发送一组问题，写明建议的信息所有者和当前还能继续的范围。
|
||
6. Hub 返回后核对来源角色、确认状态、成果版本、适用范围和风险，再继续任务。
|
||
|
||
不要逐句追问或绕过 Hub。普通问题默认一问一答；复杂异常按《会议决定记录》流程处理。
|
||
|
||
## 专业自审与负责人确认
|
||
|
||
正式结果至少让 Hub 找到：
|
||
|
||
- 实际完成内容、成果文件和版本；
|
||
- 使用的输入基线；
|
||
- 每项完成条件对应的证据；
|
||
- 不适用项、未执行项、开放问题、依赖和剩余风险；
|
||
- 本角色明确的专业结论；
|
||
- 自审结果；
|
||
- 负责人、确认时间、确认范围和附带条件。
|
||
|
||
只有负责人实际查看并确认后，才能把结果作为本角色正式提交。模拟模式的确认只表示同意用已标明的模拟材料推进，不证明数据真实。
|
||
|
||
## 返回与终态
|
||
|
||
- 任务仍可继续且只需 Hub 补充：调用 `mcp__etunel__etunel_send_to_hub` 一次提交聚合请求。
|
||
- 全部必需产出完成、自审完成且负责人确认：调用 `mcp__etunel__etunel_complete_task`，用 `attachment_paths` 附上实际成果文件。
|
||
- 任务无法继续，且原因、已尝试协调、影响、所需决定和恢复条件明确：调用 `mcp__etunel__etunel_report_blocked`。
|
||
|
||
工具需要的 `message_id` 或 `correlation_id` 来自 Etunel 入站消息，只放在工具参数中，不要求负责人核对。补充、返工或阻塞解除后等待 Hub 派发新任务，不复用已经结束的消息。工具细则见 [Etunel 任务消息流程](etunel-message-lifecycle.md)。
|
||
|
||
## 错投、越界或角色替换
|
||
|
||
1. 保留已经完成的本角色范围工作；
|
||
2. 用中文指出错投或越界内容、影响和建议责任角色；
|
||
3. 把本角色可以确认的事实交 Hub；
|
||
4. 等待 Hub 重新路由或完成交接，不替另一角色补写专业结论；
|
||
5. 新负责人不自动继承旧负责人的批准，需要重新确认仍适用的成果。
|
||
|
||
## 成员禁止事项
|
||
|
||
- 不自行切换角色或任务主责；
|
||
- 不直接向其他成员 Agent 通信；
|
||
- 不自行改变业务范围、产品行为、总体架构、硬件规格、接口、验收标准或正式日期；
|
||
- 不用角色自测替代测试结论，不用 AI 生成替代负责人确认；
|
||
- 不在成果完成前用大量状态消息制造往返；
|
||
- 不传播完整私有对话、无关资料、个人数据或明文凭据；
|
||
- 不把 Etunel 投递状态、项目状态快照或钉钉通知当作业务完成。
|