Refine project role collaboration guidance

etunel-role-collaboration/SKILL.md

@@ -1,44 +1,44 @@
 ---
 name: etunel-role-collaboration
-description: 在 Etunel 多 Agent 项目中识别项目Hub、业务、产品、技术负责人、嵌入式应用层、嵌入式底层、硬件、测试或已登记的自定义角色，并按 Hub 唯一跨角色中介、依赖就绪任务波次、正式成果、人类负责人确认、成员与状态基线和 Etunel 消息流程推进项目。用于进入 Etunel 项目任务、确认职责边界、派发或完成任务、处理阻塞返工变更、阶段交接以及 Hub 钉钉进度汇报；不用于设计 Etunel 队列、投递、重试或去重机制。
+description: 在 Etunel 多 Agent 项目中识别项目Hub、业务、产品、技术负责人、嵌入式应用层、嵌入式底层、硬件、测试或已登记的自定义角色，并按 Hub 唯一跨角色中介、依赖就绪任务波次、中文正式成果、真人负责人确认、阶段留档和 Etunel 实际消息工具推进项目。用于派发或完成任务、处理阻塞返工变更、阶段交接、项目文件归档以及 Hub 钉钉进度汇报；不用于设计 Etunel 队列、投递、重试或去重机制。
 ---
 
 # Etunel 多角色项目协作
 
-一个 WORK_ID 使用一个持续的项目Hub会话贯穿生命周期。默认角色为项目Hub、业务、产品、技术负责人、嵌入式应用层、嵌入式底层、硬件和测试；已完成契约并由 Hub 真人负责人在 Etunel 中手动添加的自定义角色也可参与。
+一个项目使用一个持续的项目Hub会话贯穿生命周期。默认角色为项目Hub、业务、产品、技术负责人、嵌入式应用层、嵌入式底层、硬件和测试；已完成职责契约并由 Hub 真人负责人在 Etunel 中手动添加的自定义角色也可参与。
 
-## 先确认身份与任务
+## 先确认当前任务
 
 从当前 Hook、Etunel 角色契约和入站任务确认：
 
-- semantic role、实际 role ID、role member ID、session ID 和 human owner；
-- WORK_ID、SUBTASK_ID、项目模式、流程基线、阶段、任务波次和本任务范围；
-- 唯一主责角色与主责成员、协作角色、上游依赖和要求完成时间；
-- 要求产出的文件或连贯成果包、最低内容、证据、完成条件和下游用途。
+- 当前角色、项目名称、项目模式、流程基线和所处阶段；
+- 任务目标、唯一主责角色、协作角色、上游依赖和完成时间；
+- 已有资料、要求产出的文件或成果包、最低内容、证据、完成条件和下游用途。
 
-不要根据文件夹名、历史消息或记忆猜身份。成员、会话、职责或任务归属不清时，先报告边界问题，不自行换角色。
+Etunel 负责当前角色和会话绑定。不要向负责人询问或复述 role ID、member ID、session ID、消息 ID 等运行时字段，也不要在任务正文中制造不存在的 ID。Hub 需要识别角色时调用 `mcp__etunel__etunel_list_roles`，用 `role` 路由、用 `display_name` 面向人显示。
 
 ## 共享硬约束
 
-1. 项目Hub是成员 Agent 之间唯一的跨角色中介。现阶段 Etunel 不支持成员间直接通信；成员只交 Hub，Hub 再定向路由，且不替角色改写或作出专业结论。
+1. 项目Hub是成员 Agent 之间唯一的跨角色中介。成员只把任务结果、问题或阻塞交 Hub，由 Hub 定向路由；成员之间不直接通信。
 2. 正常阶段顺序为：业务需求、产品定义、方案设计、项目规划、软硬件实现、测试验证、业务验收、发布结项。阶段按有效流程基线和依赖推进。
-3. 同一阶段中，依赖已满足的任务可组成任务波次；一个工具调用只有一个接收方，同一角色的多项工作可以内聚成任务包或连续派发多个 SUBTASK_ID。
-4. 每个 SUBTASK_ID 只有一个主责角色、一个主责成员和一个可独立判定的结果。协作角色不等于共同主责。
-5. Hub 给足当前任务需要的已登记信息，但不默认广播完整计划、全部资料或私有对话。缺口应聚合后经 Hub 定向补齐。
-6. 正式执行任务必须要求具体产出文件或连贯成果包，且派发要求与预期产出一致。纯信息查询、确认或决定请求不虚构文件。
-7. 角色 AI 收到任务后先与本角色 human owner 对齐，形成成果后完成专业自审并取得负责人确认，才可正式返回。
-8. Hub 只校验身份、结构、版本、证据、确认状态、跨角色冲突、依赖和门禁，不替专业角色判断内容是否充分。
-9. 项目模式、任务结果、成果生命周期、成果适用性、阶段门禁、测试结论、业务验收和消息通知是不同状态层；不适用项统一只写 NA，也不混用状态。
-10. 正式项目只在已有成果覆盖且取得必要确认时受控跳转。明确的流程模拟可记录 BYPASSED_WITH_RISK 和 SIMULATION_ONLY，并只能以 SIMULATION_COMPLETED 结束。
-11. Etunel 运行时负责队列、投递、重试、去重、会话授权和文件传输；本 Skill 不另造这些软件机制。
-12. 当前 Hook、工具 schema、项目角色契约、成员登记和已确认流程基线高于本 Skill 的通用说明；不存在的工具、角色或参数不得伪造。
+3. 依赖已满足的任务可以组成任务波次。一个 Etunel 调用只面向一个接收角色；同一角色的紧密相关工作可以组成一个任务包。
+4. 每项任务只有一个主责角色和一个可独立判断的结果。Etunel 的角色绑定决定实际接收会话，不另造“主责成员 ID”。
+5. Hub 必须给足执行所需的背景、有效输入、边界、产出和完成条件，但不默认广播完整计划、全部资料或私有对话。
+6. 正式执行任务必须形成指定文件或连贯成果包，任务要求与实际产出一致。纯信息查询、确认或决定不虚构空文件。
+7. 成员收到任务后先用简明中文与当前负责人对齐；形成成果后完成专业自审并取得负责人确认，再通过 Etunel 正式返回。
+8. 面向负责人、角色或钉钉的内容使用自然、简洁的中文。机器字段和枚举只留在工具参数或机器记录中，不把内部术语和 ID 倾倒给人。
+9. Hub 只校验角色、结构、版本、证据、确认状态、跨角色冲突、依赖和门禁，不替专业角色补写内容或作出专业结论。
+10. Hub 按阶段保存角色提交的文件，维护项目进度、阶段记录和成果索引。必要成果未保存且不可访问时，不宣布正式阶段交接完成。
+11. 流程可按 Hub 负责人明确决定跳转、回退或暂缓；Hub 必须记录缺失成果、原因、影响、风险和补齐安排，且不得把未满足门禁写成已通过。正式交付仍需补齐适用成果与必要确认；模拟流程不能冒充真实交付。
+12. Etunel 运行时负责队列、投递、重试、去重、会话授权和文件传输；本 Skill 不重复设计这些软件机制。
+13. 当前 Hook、工具 schema、角色契约、`etunel_list_roles` 返回和已确认流程基线高于本 Skill 的通用说明；不存在的工具、角色、字段或文件不得伪造。
 
 ## 渐进式路由
 
 只读取当前工作需要的引用：
 
 - Hub：先读 [Hub 工作流](references/hub-workflow.md)。
-- 创建项目、选择成员、配置自定义角色、成员交接、维护状态或发送状态快照：读 [成员与项目状态](references/project-status-and-membership.md)。
+- 创建项目、读取角色、添加或替换角色、维护项目状态：读 [角色与项目状态](references/project-status-and-membership.md)。
 - 选择阶段、正式成果、任务波次或交接：读 [项目生命周期](references/project-lifecycle.md)。
 - 成员：先读 [成员通用工作流](references/member-workflow.md)，再只读当前角色文件：
   - [业务](references/roles/business.md)
@@ -51,6 +51,8 @@ description: 在 Etunel 多 Agent 项目中识别项目Hub、业务、产品、
 - 准备派发、回复、跨角色中继、完成或报告阻塞：读 [Etunel 任务消息流程](references/etunel-message-lifecycle.md)。
 - 定义或校验成果、状态、版本、证据、额外产出或豁免：读 [成果与完成判定](references/artifacts-and-evidence.md)。
 - 缺信息、错投、阻塞、会议决定、返工、变更、流程跳转或模拟：读 [异常与协调](references/exceptions-and-coordination.md)。
+- 编写给负责人、角色或群组的任务、提问、结果和状态消息：读 [人类可读沟通](references/human-readable-communication.md)。
+- 创建项目资料目录、保存成员清单、归档成果、更新进度或阶段记录：读 [项目文件与进度留档](references/project-files-and-progress.md)。
 - 仅当当前会话是 Hub 且发生钉钉汇报事件：读 [钉钉项目进度汇报](references/dingtalk-progress-reporting.md)。
 - 测试角色仅在任务类型匹配时，按 [测试职责](references/roles/testing.md) 中的二级链接读取更深细则。
 
@@ -58,19 +60,20 @@ description: 在 Etunel 多 Agent 项目中识别项目Hub、业务、产品、
 
 ## 每项任务的控制循环
 
-1. 确认身份、成员映射、有效流程与成果基线、任务目标、主责边界和 human owner。
-2. 向负责人复述任务；一次核对输入、输出、证据、版本、期限、完成条件和下游用途。
-3. 信息足够后执行本角色工作；缺少跨角色输入时，先走负责人路径，再向 Hub 提交聚合请求。
-4. 形成产出文件或成果包，完成专业自审并取得负责人确认。
-5. 通过当前 Hook 和 Etunel schema 对应的工具返回结果、补充请求或正式阻塞。
-6. Hub 校验并登记；合格则更新成果、状态、依赖和下一波次，不合格则精确补齐或按异常流程路由。
+1. 从运行时确认当前角色、项目、阶段、目标、输入、产出和负责人，不向人核对内部 ID。
+2. 用简明中文一次说明要做什么、已有资料、还缺什么、会产出什么以及需要负责人确认什么。
+3. 信息足够后执行本角色工作；缺少跨角色输入时先问当前负责人，再向 Hub 提交一组聚合问题。
+4. 形成指定文件或成果包，完成专业自审并取得负责人确认。
+5. 使用当前 Etunel schema 对应的工具返回成果、补充请求或具体阻塞。
+6. Hub 校验并按阶段留档；合格则更新成果索引、项目进度、依赖和下一波次，不合格则只说明具体缺口。
 
 ## 提交前检查
 
-- 身份、成员、会话、WORK_ID、SUBTASK_ID 和流程基线是否来自运行时？
-- 是否只有一个主责角色和主责成员，且未越过其他角色专业或批准边界？
-- 输入是否足够，输出文件、证据、期限和完成条件是否与任务要求一致？
+- 是否只确认了人需要知道的任务信息，没有要求负责人核对运行时 ID？
+- 是否只有一个主责角色，且未越过其他角色的专业或批准边界？
+- 输入是否足够，产出文件、证据、期限和完成条件是否与任务一致？
 - 自审、版本、负责人确认、开放项和风险是否明确？
-- 状态层是否正确，NA、DEFERRED、WAIVED 和模拟状态是否被混用？
-- 是否把并行任务波次误当成无依赖广播，或把消息排队、通知接受误当成业务完成？
+- 人类可读内容是否使用简洁中文，机器字段是否留在工具或机器记录中？
+- 必要成果是否已由 Hub 放入正确阶段目录并更新进度和成果索引？
+- 是否把任务波次误当成无依赖广播，或把排队、通知接受误当成业务完成？
 - 是否只使用当前 schema 中与本次意图匹配的 Etunel 工具？