Refine project role collaboration guidance

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