diff --git a/AGENTS.md b/AGENTS.md index 030c8a3..d52fa11 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -19,7 +19,7 @@ 1. 先读根 Skill:[etunel-role-collaboration/SKILL.md](etunel-role-collaboration/SKILL.md)。 2. 只按其中的条件路由读取本次修改涉及的 reference,不要一次加载所有角色和测试细则。 -3. 涉及流程设计时,以 `doc/20260902/` 中 V0.14 总流程图为当前设计基线;`doc/20260828/` 中 V0.13 Hub 系统提示词只作补充和历史追溯,V0.13、V0.4 总流程图均为历史对照。 +3. 涉及流程设计时,以 [V0.15 总流程图](doc/20260904/Codex多角色项目推进总流程图-V0.15.html) 为当前设计基线(2026-09-07 生效);V0.14 及更早总流程图、V0.13 Hub 系统提示词只作补充和历史追溯。 4. 运行时 Hook、Etunel 工具 schema、项目角色契约、成员登记及已确认的项目流程基线,高于 Skill 的通用说明。发现冲突时说明冲突,不要自行猜测或发明能力。 5. 保留用户已有改动;修改前后检查 Git 状态与差异。 @@ -28,12 +28,15 @@ ## 必须保持的协作边界 - 默认八个角色是项目Hub、业务、产品、技术负责人、嵌入式应用层、嵌入式底层、硬件和测试。 -- 项目Hub是成员 Agent 之间唯一的跨角色中介。现阶段不支持成员角色直接通信;所有跨角色信息必须交给 Hub 定向中继。 +- 项目Hub是成员 Agent 之间唯一的跨角色中介。现阶段不支持成员角色直接通信;所有成员 Agent 跨角色消息必须交给 Hub 定向中继。阶段 7 测试报告和实际提供的提测佐证由测试负责人直交产品负责人,Hub 仅登记资料索引、测试确认和产品收讫确认,不收转大文件;这不改变 Agent 通信拓扑。 - 一个项目使用一个持续的 Hub 会话贯穿生命周期;不同阶段与不同角色会话交接,不为每个阶段另建 Hub。 - 每项任务只有一个主责角色。依赖已满足的多项任务可以形成任务波次;同一角色的内聚工作可以一次组成任务包。 - Hub 派发内容必须足以执行,并与要求的成果文件或成果包一致。成员先与本角色真人负责人对齐、自审并确认,再向 Hub 返回正式结果。 - Hub 使用 `mcp__etunel__etunel_list_roles` 返回的 `role` 路由任务,以 `display_name` 面向人显示;不得向负责人索取或制造成员、会话和任务编号。 - Hub 校验身份、结构、版本、证据、确认、依赖和门禁,不代替专业角色完成内容或作出专业结论。 +- 授权范围内的资源与排期由产品确认;预算、采购或对外承诺由业务批准。缺陷责任人由相关负责人共同商议,Hub 登记并派发。 +- 阶段 7 平台与客户验收都通过才放行;平台由产品出具报告或结论,客户验收需要业务确认。阶段 8 只收集资料、复盘结项,不新增冒烟或其他测试。 +- 所有成果豁免均须项目负责人(项目Hub对应真人负责人)批准或拒绝,Hub AI 只校验、登记与执行;不再单列下游征询、意见回传和业务高影响确认环节。 - 新自定义角色必须先形成职责契约,再由 Hub 真人负责人在 Etunel 中手动添加并绑定;AI 不得宣称已自动创建角色。 - Etunel 运行时拥有队列、投递、重试、去重、会话授权和文件传输机制。本仓库只约束角色流程,不重复设计这些软件逻辑。 - 中文职责名称统一写“业务”;仅在运行时标识、文件名或技术映射中使用 `business`。 diff --git a/README.md b/README.md index 699cb06..d266a1a 100644 --- a/README.md +++ b/README.md @@ -8,13 +8,13 @@ 1. [主 Skill](etunel-role-collaboration/SKILL.md) 是角色 AI 的统一入口,只保留共享硬约束和条件路由;详细职责按当前任务逐层读取。 2. [Hook 上下文](etunel-role-hook-contexts/) 是给 Etunel 单独配置的精简提醒,不属于 Skill 的渐进式发现树,也不应替代完整职责文件。 -3. `doc/20260902/` 中 V0.14 总流程图是当前设计基线;V0.13 Hub 系统提示词只作补充和历史追溯。Skill 已把适用规则整理成稳定约束,运行时不依赖这些版本文件存在。 +3. [V0.15 总流程图](doc/20260904/Codex多角色项目推进总流程图-V0.15.html) 是当前设计基线,2026-09-07 生效;V0.14 及更早总流程图、V0.13 Hub 系统提示词只作补充和历史追溯。Skill 已把适用规则整理成稳定约束,运行时不依赖这些版本文件存在。 仓库没有应用安装、编译或发布流程。主要工作是维护角色约束、流程文档、Hook 上下文以及 Hub 通知参考集成。 ## 协作模型 -一个项目使用一个持续的 Hub 会话贯穿整个生命周期。成员之间现阶段不能直接通信,所有跨角色问题、补充信息、成果和返工都由 Hub 定向中继。 +一个项目使用一个持续的 Hub 会话贯穿整个生命周期。成员 Agent 之间现阶段不能直接通信,跨角色问题、补充信息、成果登记和返工都由 Hub 定向中继。阶段 7 的测试报告和实际提供的提测佐证由测试负责人直接交产品负责人,Hub 只登记资料索引、测试确认和产品收讫确认,不收转大文件。 ```mermaid flowchart LR @@ -40,15 +40,15 @@ flowchart LR hub -. "公开进度与异常摘要" .-> ding["钉钉群
辅助通知"] ``` -图中的成员节点均表示“角色 AI 与对应真人负责人”。箭头只连接 Hub:成员不能绕过 Hub 相互发消息。钉钉只有 Hub 发出的单向虚线,不参与任务交付或状态判定。 +图中的成员节点均表示“角色 AI 与对应真人负责人”。箭头表示 Agent 消息,只连接 Hub;阶段 7 人类负责人直交文件不改变这个拓扑。钉钉只有 Hub 发出的单向虚线,不参与任务交付或状态判定。 默认角色共八个: | 角色 | 主要定位 | | --- | --- | | 项目Hub | 建立项目、维护状态、规划任务波次、校验交付结构、协调阻塞并完成跨角色中继 | -| 业务 | 形成商业需求、客户与授权信息、业务验收及发布结项输入 | -| 产品 | 把业务需求转化为产品定义、范围、交互和验收标准 | +| 业务 | 形成业务需求、客户与授权信息,批准预算/采购/对外承诺,确认客户验收 | +| 产品 | 形成产品定义与验收标准,确认授权范围内资源与排期,组织平台及客户验收 | | 技术负责人 | 负责总体技术方案、接口与跨技术域设计协调 | | 嵌入式应用层 | 负责应用层软件设计、实现、联调和对应成果 | | 嵌入式底层 | 负责驱动、BSP、底层接口与对应实现成果 | @@ -57,7 +57,7 @@ flowchart LR 自定义角色不是自动生效的。它必须先形成职责契约,再由 Hub 真人负责人在 Etunel 中手动添加。Hub 从 Etunel 实际角色清单读取 `role`、`display_name` 和 `relationship`,不让负责人手工确认不存在的成员或会话编号。 -正常生命周期为:业务需求 → 产品定义 → 方案设计 → 项目规划 → 软硬件实现 → 测试验证 → 业务验收 → 发布结项。项目可以按已确认基线进行受控跳转、回退或暂缓;模拟项目应显式记录模拟状态,不能冒充真实交付。 +正常生命周期为:业务需求 → 产品定义 → 方案设计 → 项目规划 → 软硬件实现 → 测试验证 → 业务验收(平台+客户)→ 发布结项(资料收集、复盘与结项)。平台验收在前、客户验收在后,条件具备可并行;平台由产品出具报告或结论,客户验收需业务确认,二者均通过才能放行。阶段 8 不新增冒烟或其他测试。项目可以按已确认基线进行受控跳转、回退或暂缓;模拟项目应显式记录模拟状态,不能冒充真实交付。 ## 仓库结构 @@ -149,7 +149,7 @@ Hook 文件需保持短小,并与完整 Skill 职责一致。它们由 Etunel ## 修改项目的推荐流程 1. 阅读 [AGENTS.md](AGENTS.md) 和本次变更涉及的最小文件集合。 -2. 若变更来自流程设计,先核对当前 [V0.14 总流程图](doc/20260902/Codex多角色项目推进总流程图-V0.14.html)。[V0.13 Hub 系统提示词](doc/20260828/Codex多角色项目推进-项目Hub系统提示词-V0.13.txt) 只作补充和历史追溯;V0.13、V0.4 总流程图只用于版本比较。 +2. 若变更来自流程设计,先核对当前 [V0.15 总流程图](doc/20260904/Codex多角色项目推进总流程图-V0.15.html)。[V0.13 Hub 系统提示词](doc/20260828/Codex多角色项目推进-项目Hub系统提示词-V0.13.txt) 只作补充和历史追溯;V0.14 及更早总流程图只用于版本比较。 3. 把共享规则放在公共 reference,把角色专属规则放在对应角色文件,把低频测试细节放在测试二级 reference。 4. 只有必须让所有角色立即知道的规则才进入根 `SKILL.md`;同时保持条件路由可发现。 5. 同步检查受影响的 Hook 文件,并验证链接、结构和 Shell 语法。 @@ -181,7 +181,8 @@ bash -n scripts/dingtalk-progress ## 设计资料 -- [当前多角色推进总流程图 V0.14](doc/20260902/Codex多角色项目推进总流程图-V0.14.html) +- [当前多角色推进总流程图 V0.15](doc/20260904/Codex多角色项目推进总流程图-V0.15.html) +- [历史总流程图 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) diff --git a/doc/20260904/Codex多角色项目推进总流程图-V0.15.html b/doc/20260904/Codex多角色项目推进总流程图-V0.15.html index 075f570..01e6bfc 100644 --- a/doc/20260904/Codex多角色项目推进总流程图-V0.15.html +++ b/doc/20260904/Codex多角色项目推进总流程图-V0.15.html @@ -5,7 +5,7 @@ - Codex 多角色项目推进总流程图与信息流图谱|V0.15 REVIEW + Codex 多角色项目推进总流程图与信息流图谱|V0.15 CURRENT