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