Refine project role collaboration guidance

AGENTS.md

@@ -19,7 +19,7 @@
 
 1. 先读根 Skill：[etunel-role-collaboration/SKILL.md](etunel-role-collaboration/SKILL.md)。
 2. 只按其中的条件路由读取本次修改涉及的 reference，不要一次加载所有角色和测试细则。
-3. 涉及流程设计时，以 `doc/20260828/` 中 V0.13 总流程图和 Hub 系统提示词为当前设计基线；`doc/20260827/` 中 V0.4 仅用于历史对照。
+3. 涉及流程设计时，以 `doc/20260902/` 中 V0.14 总流程图为当前设计基线；`doc/20260828/` 中 V0.13 Hub 系统提示词只作补充和历史追溯，V0.13、V0.4 总流程图均为历史对照。
 4. 运行时 Hook、Etunel 工具 schema、项目角色契约、成员登记及已确认的项目流程基线，高于 Skill 的通用说明。发现冲突时说明冲突，不要自行猜测或发明能力。
 5. 保留用户已有改动；修改前后检查 Git 状态与差异。
 
@@ -29,9 +29,10 @@
 
 - 默认八个角色是项目Hub、业务、产品、技术负责人、嵌入式应用层、嵌入式底层、硬件和测试。
 - 项目Hub是成员 Agent 之间唯一的跨角色中介。现阶段不支持成员角色直接通信；所有跨角色信息必须交给 Hub 定向中继。
-- 一个 WORK_ID 使用一个持续的 Hub 会话贯穿项目生命周期；不同阶段与不同角色会话交接，不为每个阶段另建 Hub。
-- 每个 SUBTASK_ID 只有一个主责角色和一个主责成员。依赖已满足的多项任务可以形成任务波次；同一角色的内聚工作可以一次组成任务包。
+- 一个项目使用一个持续的 Hub 会话贯穿生命周期；不同阶段与不同角色会话交接，不为每个阶段另建 Hub。
+- 每项任务只有一个主责角色。依赖已满足的多项任务可以形成任务波次；同一角色的内聚工作可以一次组成任务包。
 - Hub 派发内容必须足以执行，并与要求的成果文件或成果包一致。成员先与本角色真人负责人对齐、自审并确认，再向 Hub 返回正式结果。
+- Hub 使用 `mcp__etunel__etunel_list_roles` 返回的 `role` 路由任务，以 `display_name` 面向人显示；不得向负责人索取或制造成员、会话和任务编号。
 - Hub 校验身份、结构、版本、证据、确认、依赖和门禁，不代替专业角色完成内容或作出专业结论。
 - 新自定义角色必须先形成职责契约，再由 Hub 真人负责人在 Etunel 中手动添加并绑定；AI 不得宣称已自动创建角色。
 - Etunel 运行时拥有队列、投递、重试、去重、会话授权和文件传输机制。本仓库只约束角色流程，不重复设计这些软件逻辑。
@@ -52,16 +53,24 @@
 
 修改共享流程、角色边界、阶段、正式成果或跨角色信息流时，必须同步检查根 Skill、相关公共 reference、受影响角色 reference 和对应 Hook。角色细节优先下沉到角色文件；测试专项优先下沉到测试二级 reference。不要靠复制整段规则维持一致性。
 
+实际项目的运行资料不预先创建在本仓库中。Hub 应按 [项目文件与进度留档](etunel-role-collaboration/references/project-files-and-progress.md) 在使用此 Skill 的目标项目里建立阶段目录、保存正式成果并维护进度和成果索引。
+
 ## 钉钉参考集成边界
 
 钉钉内容存在于本仓库，是为了给 Hub 提供“如何调用钉钉发送项目通知”的参考和演示能力，不是本项目的核心职责系统：
 
 - 只有 Hub／主 Agent 可以调用通知；成员 Agent 只向 Hub 返回成果、状态或阻塞。
 - 通知是项目群的单向辅助可见性与异常提醒，不是角色间通信、任务派发、审批、人类确认、项目门禁或项目事实源。
-- Agent 只能使用 `scripts/dingtalk-progress`，事件类型限定为 `start`、`milestone`、`blocked`、`complete` 或 `failed`；不得绕过脚本直接调用 OpenAPI 或 `dws api`。例如：
+- Agent 只能使用 `scripts/dingtalk-progress`，事件类型限定为 `start`、`milestone`、`blocked`、`complete` 或 `failed`；不得绕过脚本直接调用 OpenAPI 或 `dws api`。可验证里程碑先完成项目留档，再发送简短中文 Markdown。例如：
 
   ```sh
-  ./scripts/dingtalk-progress milestone "阶段成果已确认，下一步由 Hub 安排后续任务"
+  ./scripts/dingtalk-progress milestone "**已完成**
+
+  - 阶段成果已确认并归档
+
+  **下一步**
+
+  - Hub 安排后续任务"
   ```
 - 事件语义与消息格式以 [dingtalk-progress-reporting.md](etunel-role-collaboration/references/dingtalk-progress-reporting.md) 为准；安装与本机配置参考 [.dingtalk/README.md](.dingtalk/README.md)。
 - `scripts/dingtalk-progress` 是当前用于跑通通知链路的演示封装，不得据此反推或改变 Etunel 主流程。
@@ -70,12 +79,12 @@
 
 ## 编辑约定
 
-- 使用中文编写项目说明和职责约束；保留已定义的英文状态、成果名和运行时字段。
+- 使用中文编写项目说明、职责约束、成果名称和面向负责人的消息；机器枚举与运行时字段只在工具确实要求时保留。
 - Markdown 使用相对链接；每个新增链接都应能从仓库中解析。
 - 保持渐进式披露：入口说明“何时读什么”，详细内容放在对应 reference，不在多个文件重复整套流程。
 - Hook 只保留角色定位、关键边界、工具提醒和每轮控制点，避免塞入大段流程正文。
 - 不伪造 Etunel 工具名、参数、角色、成员、会话、状态或尚不存在的文件。
-- 不把模拟流程结果描述为真实发布、客户验收或生产就绪；不适用项统一使用 `NA`。
+- 不把模拟流程结果描述为真实发布、客户验收或生产就绪；不适用项对人统一写“不适用”，只在机器字段要求时使用对应枚举。
 - 文本文件保持 LF；不要提交日志、缓存、临时文件、机器专属配置或凭据。
 
 ## Quick Commands