From 206aabc06c82ac76ca8623ba0c50f36bb871c0b4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=9D=8E=E9=9F=B5?= Date: Tue, 20 Oct 2026 18:46:02 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E6=8C=89=20V2.1=20=E6=9B=B4=E6=96=B0?= =?UTF-8?q?=E4=B8=AD=E5=BF=83=20Skill=E3=80=81=E6=B5=81=E7=A8=8B=E5=9B=BE?= =?UTF-8?q?=E4=B8=8E=E9=A1=B9=E7=9B=AE=E8=AE=B0=E5=BD=95=E6=A8=A1=E6=9D=BF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .dingtalk/README.md | 19 +- AGENTS.md | 10 +- README.md | 22 ++- doc/Codex多角色项目推进总流程图.html | 166 +++++++++++++++--- ep-hub/SKILL.md | 12 +- ep-hub/assets/templates/任务记录.md | 5 +- ep-hub/assets/templates/工时与周期评估.md | 35 ++++ ep-hub/assets/templates/成果索引.md | 3 +- ep-hub/assets/templates/结项资料归档.md | 32 ++++ ep-hub/assets/templates/阶段成果汇报.md | 33 ++++ ep-hub/assets/templates/阶段记录.md | 22 ++- ep-hub/assets/templates/项目概览.md | 6 + ep-hub/assets/templates/项目计划.xlsx | Bin 0 -> 5487 bytes ep-hub/assets/templates/项目进度.md | 6 + .../references/artifacts-and-confirmation.md | 16 +- .../references/dingtalk-progress-reporting.md | 42 ++++- ep-hub/references/dingtalk-script-usage.md | 19 +- ep-hub/references/document-templates.md | 2 + ep-hub/references/exceptions-and-decisions.md | 18 ++ ep-hub/references/hub-workflow.md | 21 ++- ep-hub/references/project-lifecycle.md | 23 ++- ep-hub/references/project-planning.md | 36 ++++ ep-hub/references/project-records.md | 18 +- ep-hub/references/stage-reporting.md | 35 ++++ scripts/dingtalk_notify.py | 2 +- scripts/test_dingtalk_notify.py | 72 +++++++- 26 files changed, 592 insertions(+), 83 deletions(-) create mode 100644 ep-hub/assets/templates/工时与周期评估.md create mode 100644 ep-hub/assets/templates/结项资料归档.md create mode 100644 ep-hub/assets/templates/阶段成果汇报.md create mode 100644 ep-hub/assets/templates/项目计划.xlsx create mode 100644 ep-hub/references/project-planning.md create mode 100644 ep-hub/references/stage-reporting.md diff --git a/.dingtalk/README.md b/.dingtalk/README.md index 2ffef54..a75b50b 100644 --- a/.dingtalk/README.md +++ b/.dingtalk/README.md @@ -53,14 +53,16 @@ python scripts/dingtalk_notify.py progress milestone --stage "阶段八：复盘 - 结项资料整理：由中心真人负责人组织四类结项成果，Hub 协助整理工作稿。 - 资料补充：由产品负责人、业务负责人补充现有线下成果及确认记录，不重做验收。 - 旧事项停止：由 Hub 停止此前的验收准备催办。 -- 结项确认：四类成果及遗留承接安排具备后，由 Hub 请 @{示例业务负责人} 确认结项。 +- Bug 事实确认：由 Hub 请 @{示例中心负责人} 先确认全部 Bug 的事实、对象、版本和实际处理或承接，已有有效确认直接引用。 +- Bug 处理确认：中心确认事实后，由 Hub 请 @{示例产品负责人} 再次确认并在职责内决定处理；双方无异议后登记最终安排。 +- 结项确认：四类成果、遗留承接及 Bug 双方确认具备后，由 Hub 请 @{示例业务负责人} 确认结项。 - 关闭决定：业务确认结项后，由 Hub 请 @{示例中心负责人} 决定是否关闭；结项必需项完成后锁定四类成果。 - 本轮工作范围：不新增应用修复、设备测试或发布验证。 **遗留** - 原测试不通过的结果如实保留，不因进入结项阶段改为通过。 -- 已接受延期的问题如实保留，后续沿用 Bug 系统中的记录和已有处理安排继续跟进。" --at "示例业务负责人" --at "示例中心负责人" +- 已接受延期的问题如实保留，后续沿用 Bug 系统中的记录和已有处理安排继续跟进。" --at "示例业务负责人" --at "示例中心负责人" --at "示例产品负责人" python scripts/dingtalk_notify.py progress blocked --stage "阶段三：方案设计" "**已确认的进展** - 本轮无新增已确认进展。 @@ -85,6 +87,19 @@ python scripts/dingtalk_notify.py message --title "阶段三：方案设计｜ 事件含义见 [通知规则](../ep-hub/references/dingtalk-progress-reporting.md)，详细调用与结果见 [脚本用法](../ep-hub/references/dingtalk-script-usage.md)。 +## 阶段交接和关闭通知 + +中心真人已批准推进或条件授权实际满足后，将上一阶段总结与下一阶段已确认安排合为一条 `milestone`。阶段内已授权的关键进展、阻塞、失败通知保留，同轮合并。等待决定时先在中心会话汇报，不宣称已进入下一阶段。 + +项目实际关闭后，用 `complete` 发送一次结项总结，保留未修复 Bug、失败测试和已确认承接；后续整理资料不重复发送。完整示例见 [通知规则](../ep-hub/references/dingtalk-progress-reporting.md)。较长正文可保存为 UTF-8 文件，先离线预览： + +```text +python scripts/dingtalk_notify.py progress milestone --stage "实际当前阶段" --file "阶段交接正文.md" --at "已确认完整姓名" --dry-run +python scripts/dingtalk_notify.py progress complete --stage "阶段八：复盘结项" --file "结项总结正文.md" --at "已确认完整姓名" --dry-run +``` + +正文文件和姓名须替换为实际值，正文无真人提醒时省略 `--at`。通知范围已授权且本次满足触发条件后，真实调用去掉 `--dry-run`；用户要求先审核时先取得本次发送确认。脚本仅渲染和发送，推进授权、Bug 确认和是否已发由中心查原记录判断。正文及真实结果回写阶段过程记录，不新增队列或外层重试。 + ## 检查与失败处理 - `python scripts/dingtalk_notify.py check --at "完整姓名"`：只检查固定账号登录和可选姓名，不发消息，不证明实际 @ 提醒成功。不是每条通知的必做步骤。 diff --git a/AGENTS.md b/AGENTS.md index da35e4f..3507278 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -5,7 +5,7 @@ 本文件适用于整个仓库，更具体的子目录说明在其范围内生效，当前任务中的明确用户要求优先。本仓库维护中心业务 Skill、流程文档、记录模板和钉钉通知封装，没有应用构建步骤。 1. 先读 [ep-hub/SKILL.md](ep-hub/SKILL.md)，仅按本次任务路由读取相关 reference。 -2. 当前设计来源为 [V2.0 总流程图](doc/Codex多角色项目推进总流程图.html)，运行规则已整理到中心 Skill；不要求目标项目具备流程 HTML。流程文档固定路径更新，历史由 Git 保留，不另建日期或版本副本。 +2. 当前设计来源为 [V2.1 总流程图](doc/Codex多角色项目推进总流程图.html)，运行规则已整理到中心 Skill；不要求目标项目具备流程 HTML。流程文档固定路径更新，历史由 Git 保留，不另建日期或版本副本。 3. 先后检查 Git 状态与差异，保护用户已有改动和未跟踪资料。不要删除用户保留的旧源文件来制造干净工作区。 4. 当前工具 schema、运行时契约、成员登记和已确认项目基线与通用 Skill 有冲突时，说明具体差异；不自行猜测能力、改写已确认基线或绕过运行时权限。 @@ -15,10 +15,10 @@ - 一个项目使用一个持续的中心会话；默认角色为项目Hub、业务、产品、技术负责人、嵌入式应用层、嵌入式底层、硬件、测试。新增角色按已确认职责和 Etunel 实际管理能力配置，不伪造已创建结果。 - 每项任务只有一名主责真人，按交付结果或内聚任务包管理。真人自行设计内部工作流程、直接协作并决定是否使用 Agent；成员 Agent 之间仍经中心中继。 -- 中心组织交付和结果确认，处理依赖、跨角色冲突、信息交接及留档，不替专业真人做结论。阶段推进由中心真人决定，不能代替业务授权、产品资源排期确认及外部验收。 -- 原计划、当前有效计划和实际完成时间分别保存；实际完成只取任务提交后对应真人明确确认完成的时间。工具完成、排队、送达、已读或 Agent 检查不能替代。 +- 中心组织交付和结果确认，处理依赖、跨角色冲突、信息交接及留档，不替专业真人做结论。阶段推进由中心真人决定，已有条件授权实际满足后按原范围执行并留依据，不能代替业务授权、产品资源排期确认及外部验收。 +- 项目沿用唯一计划主表，新项目默认 Excel 八列模板；Markdown 进度保留摘要和入口。原计划、当前有效计划和实际完成时间分别保存；实际完成只取任务提交后对应真人明确确认完成的时间。工具完成、排队、送达、已读或 Agent 检查不能替代。 - 一项任务保留一份原记录，跨阶段引用。项目层持续显示未完成事项、原计划和当前计划时间、影响及必须完成的阶段；改期、退回、重开保留历史。 -- 正式成果只保存真人完成并确认的最终版和确认；草稿、旧版、历史确认与推进决定进入过程记录。链接成果只登记地址，不要求重复下载、摘要或截图。 +- 正式成果保存真人完成并确认的全部有效资料或完整外部入口及确认；草稿、旧版、历史确认与推进决定进入过程记录。链接成果不强制重复下载、摘要或截图；明确授权本地复制时保留来源和路径映射，复制日期不覆盖业务日期。 - 中文职责名称统一为“业务”，机器字段仅在实际接口需要时保留。面向人不索取或编造成员、会话和任务技术编号。 修改阶段、成果、确认、时间或通知规则时，同步核对 [八阶段规则](ep-hub/references/project-lifecycle.md)、[留档规则](ep-hub/references/project-records.md)、相关模板和通知示例。详细要求下沉到 reference，不重复复制整套规则，也不重新引入成员内部工作流程。 @@ -29,7 +29,7 @@ - 只有中心／主 Agent 使用 [通知规则](ep-hub/references/dingtalk-progress-reporting.md) 和 [脚本用法](ep-hub/references/dingtalk-script-usage.md)。通知是辅助可见性和行动提醒，不是角色任务通道、审批、真人确认、推进依据或事实源。 - 只用 `scripts/dingtalk_notify.py` 的 `progress`／`message` 或等价平台入口；事件只有 start、milestone、blocked、complete、failed。progress 使用实际当前阶段，正文按已确认进展、待办、遗留分条，真实姓名按约定原位 @。 -- 先维护事实记录再通知，不为通知重新分配已有责任、期限或新建清单，不省掉已明确的停止事项和范围限制。 +- 阶段结果主动汇报到中心会话；已批准或条件授权实际满足的阶段交接合为一条群总结，实际关闭后发一次结项总结，正文及实际结果留在过程记录。先维护事实记录再通知，不为通知重新分配已有责任、期限或新建清单，不省掉已明确的停止事项和范围限制。 - 不绕过封装调用 OpenAPI 或其他入口，不增加外层重试／通知队列。仅明确 DNS 失败最多 3 次、间隔 10 秒，未知结果不重发。 - 首次账号、组织、群及通知范围由真人确认，配置用真实查询值；换账号或群重新确认。初始化和部署见 [.dingtalk/README.md](.dingtalk/README.md)。只保存开关、账号、群和项目名，本地配置不提交、不在普通回复或群中输出内部标识。 - 不读取、输出或提交 DWS 登录凭据、Client Secret、DING_SEC、App Token；不静默将旧机器人授权变成个人代发。保留 AI 标识，发送不代表真人批准。 diff --git a/README.md b/README.md index 64c5b2a..48d26a7 100644 --- a/README.md +++ b/README.md @@ -1,22 +1,22 @@ # EP 项目中心 Skill -本仓库提供基于 **V2.0 八阶段流程**的项目中心 Skill。中心负责流程把控、交付任务、信息与文件交接、过程记录；各角色真人负责人自行设计内部工作流程，并决定是否使用 Agent。 +本仓库提供基于 **V2.1 八阶段流程**的项目中心 Skill。中心负责流程把控、交付任务、信息与文件交接、过程记录；各角色真人负责人自行设计内部工作流程，并决定是否使用 Agent。 ## 使用入口 - [中心 Skill：ep-hub](ep-hub/SKILL.md)：中心业务规则与按需阅读入口。 - **已安装的 etunel-use**：Etunel 配置、角色契约、会话绑定与通信操作；不包含本仓库的阶段、成果和留档规则。 -- [当前总流程图](doc/Codex多角色项目推进总流程图.html)：固定路径维护 V2.0，历史通过 Git 追溯。 +- [当前总流程图](doc/Codex多角色项目推进总流程图.html)：固定路径维护 V2.1，历史通过 Git 追溯。 - [记录与留档](ep-hub/references/project-records.md)：项目、阶段、任务和成果记录的分工与模板。 - [钉钉消息模板](ep-hub/references/dingtalk-progress-reporting.md)：当前阶段标题、已确认的进展、待办事项、遗留及真人 @。 -本次已将仓库业务规则按 V2.0 和经确认的记录方案重写。旧的全角色 Skill 与独立 Hook 源目录已移除，旧内容仍可从 Git 历史查阅。仓库源文件更新不代表已发布、已安装、已修改 Etunel 配置或已迁移在途项目。 +本次按 V2.1 及已确认的实施口径更新阶段汇报、工时与排期、成果确认、Bug 双方确认和关闭后登记规则。旧的全角色 Skill 与独立 Hook 源目录已移除，旧内容仍可从 Git 历史查阅。仓库源文件更新不代表已发布、已安装、已修改 Etunel 配置或已迁移在途项目。 ## 中心与角色怎样协作 一个项目使用一个持续的中心会话。任务按可独立确认的交付结果或同一负责人的内聚任务包管理，明确输入、范围、结果、期限和完成条件。真人可以直接协作，接收和提交可在线下完成；成员 Agent 之间的信息仍由中心中继。 -中心 Agent 汇总事实和待决定事项，角色真人对专业成果负责，中心真人对阶段推进负责。单项任务确认完成后可解锁依赖就绪的后续任务；跨阶段推进需要中心真人决定。业务授权、产品资源排期确认和外部验收仍按各自权限办理。 +中心 Agent 汇总事实和待决定事项，角色真人对专业成果负责，中心真人对阶段推进负责。单项任务确认完成后可解锁依赖就绪的后续任务；跨阶段推进需要中心真人决定；已有条件授权实际满足后按原范围执行并记录依据，原授权日期与实际切换日期分别保存。业务授权、产品资源排期确认和外部验收仍按各自权限办理。 | 阶段 | 主要成果 | | --- | --- | @@ -29,7 +29,7 @@ | 7. 内部／外部验收 | 内部验收记录、适用的平台／客户验收结果、共用遗留问题清单 | | 8. 复盘结项 | 《结项资料归档》、《变更记录》、《结项报告》、《流程闭环总结》 | -完整内容与必要确认见 [八阶段与结果要求](ep-hub/references/project-lifecycle.md)。阶段六不要求缺陷清单或零缺陷清单；测试不通过时保留原结论，项目、产品真人共同核实后的放行决定单独记录。阶段八由中心真人组织，业务确认结项，中心真人决定关闭。 +完整内容与必要确认见 [八阶段与结果要求](ep-hub/references/project-lifecycle.md)。阶段六不要求缺陷清单或零缺陷清单；测试不通过时保留原结论，项目、产品真人共同核实后的放行决定单独记录。阶段八由中心真人组织，全部 Bug 处理或承接先由中心确认、再由产品确认，业务确认结项，中心真人决定关闭。关闭后同步记录、锁定有效成果并停止重复催办；未修复 Bug 和失败测试如实保留。 ## 记录方式 @@ -37,6 +37,7 @@ | 记录 | 用途 | | --- | --- | +| 唯一计划主表 | 完整工作项、当前有效计划和实际执行；已有项目沿用，新项目默认使用 Excel 八列模板 | | 项目概览 | 目标、范围、基线、真人分工和资料入口 | | 项目进度 | 当前阶段、整体进度、当前待处理和跨阶段未完成事项、影响及必须完成的阶段 | | 阶段记录 | 每个任务的成果、完成与确认情况；正式成果和过程分栏 | @@ -45,7 +46,9 @@ 每项任务保留三类时间：**原计划完成时间、当前计划完成时间、实际完成时间**。实际完成时间是任务提交后经对应真人明确确认完成的时间，提交时间另记。改期保留旧值、原因和真人决定；跨阶段沿用原记录，项目层持续跟进。 -每个阶段使用 `阶段记录.md`、`正式成果/`、`过程记录/`。正式区只放真人完成并确认的最终版及确认；草稿、旧版和历史确认保留在过程区。外部成果只记录地址，不要求下载、复制或截图。 +每个阶段使用 `阶段记录.md`、`正式成果/`、`过程记录/`。正式区只放真人完成并确认的最终版及确认；草稿、旧版和历史确认保留在过程区。外部成果登记完整真实入口、用途、版本及确认，不强制下载、复制或截图。项目明确授权本地复制时，保存已取得且确认有效的资料、来源与路径映射，操作日期不改变原提交及确认日期。 + +排期评估和计划更新见 [项目计划规则](ep-hub/references/project-planning.md)。中心主动在持续会话汇报阶段结果，不能仅更新本地文件；详见 [阶段汇报](ep-hub/references/stage-reporting.md)。 模板可从 [记录与留档](ep-hub/references/project-records.md) 按需打开。Markdown 用明确标题、短摘要、分条字段和关键历史，未知信息如实标明。 @@ -53,7 +56,7 @@ 1. 将仓库中的完整 `ep-hub/` 作为中心 Skill 安装到目标环境的 Skill 目录，保留 `references/`、`assets/` 和 `agents/`；具体安装位置遵循目标环境配置。 2. 配置与通信使用目标环境已安装的 `etunel-use`。修改 Etunel 中心或成员契约时，按其管理操作和职责 Hook 指南办理；中心自身配置与成员配置是不同操作。 -3. 检查目标项目实际启用的旧 Skill、职责契约与 Hook。迁移须明确目标与范围，保留项目既有任务、时间、旧成果和确认记录；不能仅因仓库升级就宣称在途项目采用 V2.0。 +3. 检查目标项目实际启用的旧 Skill、职责契约与 Hook。迁移须明确目标与范围，保留项目既有任务、时间、旧成果和确认记录；不能仅因仓库升级就宣称在途项目采用 V2.1。 4. 在迁移已获确认后，按目标环境的安装与配置机制停用冲突的旧角色流程约束。成员内部流程由各角色真人维护，新中心 Skill 不分发统一的内部操作提示词。 5. 需要钉钉时，将仓库 `scripts/` 中的共用 Python 文件和所需平台入口部署到目标项目 `scripts/`；中心 Skill 安装不会自动部署脚本。按 [钉钉配置说明](.dingtalk/README.md) 确认个人账号、项目群和通知范围。 @@ -61,6 +64,7 @@ 通知是中心向项目群提供进度与行动提醒的辅助能力。先维护事实记录，再依授权发送。消息标题来自项目当前阶段，正文固定为 **已确认的进展／待办事项／遗留**，逐项写清谁做什么，沿用原有责任、时间、范围和停止事项。 +- 已获批准或条件授权实际满足的阶段交接合为一条“上一阶段总结＋下一阶段安排”；等待决定先在中心会话汇报。阶段内关键进展、阻塞和失败仍按已授权范围通知，同轮合并；实际关闭后发一次结项总结，正文及实际发送结果进入阶段过程记录。 - 用 `scripts/dingtalk_notify.py` 的 `progress`／`message` 或同等平台入口；`progress` 必须提供 `--stage`。 - 真人提醒在正文使用 `@{完整姓名}`，同时用 `--at` 列出姓名；脚本唯一匹配后原位生成提及。 - `--dry-run` 完全离线，只展示内容，不证明账号、群或 @ 有效。 @@ -72,7 +76,7 @@ ## 版本与升级 -当前发布版本为 `v2.0.0`，流程基线为 **V2.0**。版本统一采用 `vX.Y.Z`：前两位跟随 HTML 中已确认的流程版本，第三位是该流程下的发布迭代。V2.0 对应 `v2.0.Z`，首次正式发布从 `v2.0.0` 开始；日常修改不自动创建标签。 +已发布版本为 `v2.0.0`，对应 **V2.0** 流程；本轮源码更新基线为 `v2.1.0`，对应 **V2.1**，尚未创建发布标签。版本统一采用 `vX.Y.Z`：前两位跟随 HTML 中已确认的流程版本，第三位是该流程下的发布迭代。V2.1 对应 `v2.1.Z`，该流程首次正式发布从 `v2.1.0` 开始；日常修改不自动创建标签。 - 流程版本不变，Skill、脚本、配置或文档变更只递增第三位；不按功能规模或兼容性自行改前两位，也不为凑发布号修改流程图。 - 流程正式更新到新的 X.Y，前两位同步，第三位从 0 开始。全仓库一个发布序列，组件不另编号；第三位更新也可能需要迁移。 @@ -98,6 +102,6 @@ git status --short ## 设计与参考资料 -- [V2.0 总流程图](doc/Codex多角色项目推进总流程图.html) +- [V2.1 总流程图](doc/Codex多角色项目推进总流程图.html) - [历史文档模板参考](doc/文档模板参考/README.md)：学习笔记与来源索引，原件未打包入仓库。 - 流程文档固定路径更新，历史使用 `git log --all -- doc/` 查询，不另建版本或日期副本。 diff --git a/doc/Codex多角色项目推进总流程图.html b/doc/Codex多角色项目推进总流程图.html index bd8260f..a9581e4 100644 --- a/doc/Codex多角色项目推进总流程图.html +++ b/doc/Codex多角色项目推进总流程图.html @@ -5,7 +5,7 @@ - Codex 多角色项目推进总流程图｜V2.0 + Codex 多角色项目推进总流程图｜V2.1