Refine project role collaboration guidance

README.md

@@ -8,17 +8,17 @@
 
 1. [主 Skill](etunel-role-collaboration/SKILL.md) 是角色 AI 的统一入口，只保留共享硬约束和条件路由；详细职责按当前任务逐层读取。
 2. [Hook 上下文](etunel-role-hook-contexts/) 是给 Etunel 单独配置的精简提醒，不属于 Skill 的渐进式发现树，也不应替代完整职责文件。
-3. `doc/20260828/` 中 V0.13 总流程图和 Hub 系统提示词是当前设计基线；Skill 已把适用规则整理成稳定约束，运行时不依赖这些版本文件存在。
+3. `doc/20260902/` 中 V0.14 总流程图是当前设计基线；V0.13 Hub 系统提示词只作补充和历史追溯。Skill 已把适用规则整理成稳定约束，运行时不依赖这些版本文件存在。
 
 仓库没有应用安装、编译或发布流程。主要工作是维护角色约束、流程文档、Hook 上下文以及 Hub 通知参考集成。
 
 ## 协作模型
 
-一个 `WORK_ID` 使用一个持续的 Hub 会话贯穿整个项目生命周期。成员之间现阶段不能直接通信，所有跨角色问题、补充信息、成果和返工都由 Hub 定向中继。
+一个项目使用一个持续的 Hub 会话贯穿整个生命周期。成员之间现阶段不能直接通信，所有跨角色问题、补充信息、成果和返工都由 Hub 定向中继。
 
 ```mermaid
 flowchart LR
-    subgraph project["一个 WORK_ID / 一个持续的 Hub 会话"]
+    subgraph project["一个项目 / 一个持续的 Hub 会话"]
         hub["项目 Hub<br/>Hub AI + Hub 负责人"]
         business["业务<br/>角色 AI + 负责人"]
         product["产品<br/>角色 AI + 负责人"]
@@ -55,7 +55,7 @@ flowchart LR
 | 硬件 | 负责硬件方案、设计交付、样机与测试配合 |
 | 测试 | 独立制定测试策略、执行验证、管理缺陷并给出质量结论 |
 
-自定义角色不是自动生效的。它必须先形成职责契约，再由 Hub 真人负责人在 Etunel 中手动添加并完成成员、会话和负责人绑定。
+自定义角色不是自动生效的。它必须先形成职责契约，再由 Hub 真人负责人在 Etunel 中手动添加。Hub 从 Etunel 实际角色清单读取 `role`、`display_name` 和 `relationship`，不让负责人手工确认不存在的成员或会话编号。
 
 正常生命周期为：业务需求 → 产品定义 → 方案设计 → 项目规划 → 软硬件实现 → 测试验证 → 业务验收 → 发布结项。项目可以按已确认基线进行受控跳转、回退或暂缓；模拟项目应显式记录模拟状态，不能冒充真实交付。
 
@@ -76,6 +76,8 @@ EP-Hub-Skill/
 │       ├── etunel-message-lifecycle.md
 │       ├── artifacts-and-evidence.md
 │       ├── exceptions-and-coordination.md
+│       ├── human-readable-communication.md
+│       ├── project-files-and-progress.md
 │       ├── dingtalk-progress-reporting.md
 │       ├── roles/                    # 七个成员角色职责
 │       └── testing/                  # 测试任务按需读取的二级细则
@@ -86,20 +88,39 @@ EP-Hub-Skill/
 └── scripts/dingtalk-progress         # Hub 钉钉通知的当前演示封装
 ```
 
+Skill 被用于实际项目时，Hub 在目标项目中维护统一的 `项目资料/`，而不是把项目成果写回本约束仓库：
+
+```text
+项目资料/
+├── 00-项目管理/        # 项目概览、项目进度、成果索引、项目成员清单
+├── 01-业务需求/
+├── 02-产品定义/
+├── 03-方案设计/
+├── 04-项目规划/
+├── 05-软硬件实现/
+├── 06-测试验证/
+├── 07-业务验收/
+└── 08-发布结项/
+```
+
+每个实际使用的阶段按需建立 `阶段记录.md`、`正式成果/<角色名>/` 和 `过程记录/`。Hub 不覆盖正式历史，也不把完整聊天记录当作项目档案。
+
 ## 如何使用职责 Skill
 
 Etunel 为角色会话配置本 Skill 后，角色 AI 应按以下顺序工作：
 
-1. 从当前 Hook、Etunel 角色契约和入站任务确认自己的角色、成员、会话、真人负责人、`WORK_ID` 与 `SUBTASK_ID`，不能根据目录或历史记忆猜身份。
+1. 从当前 Hook、Etunel 角色契约和入站任务确认自己的职责。Hub 通过 `mcp__etunel__etunel_list_roles` 读取实际角色；成员不向负责人追问成员、会话或任务编号。
 2. 读取 [SKILL.md](etunel-role-collaboration/SKILL.md) 的共享约束。
 3. 只打开本次任务所需的引用：
    - Hub 先读 [Hub 工作流](etunel-role-collaboration/references/hub-workflow.md)；
    - 成员先读 [成员通用工作流](etunel-role-collaboration/references/member-workflow.md)，再读自己的一个[角色职责文件](etunel-role-collaboration/references/roles/)；
    - 涉及派发、中继或返回时读 [Etunel 任务消息流程](etunel-role-collaboration/references/etunel-message-lifecycle.md)；
    - 涉及成果、证据、状态或豁免时读 [成果与完成判定](etunel-role-collaboration/references/artifacts-and-evidence.md)；
+   - 涉及对负责人发消息时读 [人类可读沟通](etunel-role-collaboration/references/human-readable-communication.md)；
+   - 涉及阶段成果、进度或复盘资料时读 [项目文件与进度留档](etunel-role-collaboration/references/project-files-and-progress.md)；
    - 涉及缺信息、阻塞、返工、变更或流程跳转时读 [异常与协调](etunel-role-collaboration/references/exceptions-and-coordination.md)。
 4. 成员先和自己的真人负责人对齐任务与输入，形成明确成果、自审并取得负责人确认后，再交给 Hub。
-5. Hub 校验任务结果并更新项目状态，只把下游需要的信息定向交给下一角色，不广播无关计划或私有对话。
+5. Hub 校验任务结果，按阶段整理实际文件并更新项目进度和成果索引，只把下游需要的信息定向交给下一角色，不广播无关计划或私有对话。
 
 不要为了“全面了解”一次加载全部引用。测试专项文件也只有在任务类型匹配时才继续深入读取。
 
@@ -116,10 +137,10 @@ Hook 文件需保持短小，并与完整 Skill 职责一致。它们由 Etunel
 只有 Hub／主 Agent 可以使用下面的封装入口：
 
 ```sh
-./scripts/dingtalk-progress <start|milestone|blocked|complete|failed> "<简短、人类可读的摘要和下一步>"
+./scripts/dingtalk-progress <start|milestone|blocked|complete|failed> "<简短中文 Markdown 摘要>"
 ```
 
-五类事件分别表示项目正式开始、可验证里程碑、真实阻塞、整体完成和最终失败。成员角色不得发送钉钉消息，只把结果交给 Hub。通知正文只写可公开的已验证结论、下一步或阻塞原因，不发送密钥、个人数据、大段日志和未经证实的推断。
+五类事件分别表示项目正式开始、可验证里程碑、真实阻塞、整体完成和最终失败。可验证里程碑由 Hub 先完成成果和进度留档，再发送钉钉消息。成员角色不得发送钉钉消息，只把结果交给 Hub。通知正文可使用多行 Markdown，只写可公开的已验证结论、下一步或阻塞原因，不发送密钥、个人数据、大段日志和未经证实的推断。
 
 更详细的 Hub 事件语义、有限重试和结果判定见 [钉钉项目进度汇报](etunel-role-collaboration/references/dingtalk-progress-reporting.md)；当前演示接入与本地配置见 [.dingtalk/README.md](.dingtalk/README.md)。`.agents/skills/dingtalk-*` 是钉钉官方多 Skill 的项目内参考副本，不应被当作 Etunel 核心 Skill，也不应被成员用来绕过 Hub。
 
@@ -128,7 +149,7 @@ Hook 文件需保持短小，并与完整 Skill 职责一致。它们由 Etunel
 ## 修改项目的推荐流程
 
 1. 阅读 [AGENTS.md](AGENTS.md) 和本次变更涉及的最小文件集合。
-2. 若变更来自流程设计，先核对当前 [V0.13 总流程图](doc/20260828/Codex多角色项目推进总流程图-V0.13.html) 与 [V0.13 Hub 系统提示词](doc/20260828/Codex多角色项目推进-项目Hub系统提示词-V0.13.txt)。[V0.4 总流程图](doc/20260827/Codex多角色项目推进总流程图-V0.4.html) 只用于版本比较。
+2. 若变更来自流程设计，先核对当前 [V0.14 总流程图](doc/20260902/Codex多角色项目推进总流程图-V0.14.html)。[V0.13 Hub 系统提示词](doc/20260828/Codex多角色项目推进-项目Hub系统提示词-V0.13.txt) 只作补充和历史追溯；V0.13、V0.4 总流程图只用于版本比较。
 3. 把共享规则放在公共 reference，把角色专属规则放在对应角色文件，把低频测试细节放在测试二级 reference。
 4. 只有必须让所有角色立即知道的规则才进入根 `SKILL.md`；同时保持条件路由可发现。
 5. 同步检查受影响的 Hook 文件，并验证链接、结构和 Shell 语法。
@@ -160,8 +181,9 @@ bash -n scripts/dingtalk-progress
 
 ## 设计资料
 
-- [当前多角色推进总流程图 V0.13](doc/20260828/Codex多角色项目推进总流程图-V0.13.html)
-- [当前项目Hub系统提示词 V0.13](doc/20260828/Codex多角色项目推进-项目Hub系统提示词-V0.13.txt)
+- [当前多角色推进总流程图 V0.14](doc/20260902/Codex多角色项目推进总流程图-V0.14.html)
+- [补充与历史追溯：项目Hub系统提示词 V0.13](doc/20260828/Codex多角色项目推进-项目Hub系统提示词-V0.13.txt)
+- [历史总流程图 V0.13](doc/20260828/Codex多角色项目推进总流程图-V0.13.html)
 - [历史总流程图 V0.4](doc/20260827/Codex多角色项目推进总流程图-V0.4.html)
 - [核心 Skill](etunel-role-collaboration/SKILL.md)
 - [Hub 工作流](etunel-role-collaboration/references/hub-workflow.md)