Files
EP-Hub-Skill/ep-hub/references/project-records.md
T

9.5 KiB

记录与留档

用于建立资料目录、更新任务、阶段与项目进度。记录写在实际目标项目,仓库只提供规则与模板。先沿用已有资料结构;新项目可使用以下结构,阶段目录按实际工作需要建立,不预造任务或空成果。

项目资料/
├── 00-项目管理/
│   ├── 项目概览.md
│   ├── 项目进度.md
│   └── 成果索引.md
├── 01-业务需求/
├── 02-产品定义/
├── 03-方案设计/
├── 04-项目规划/
├── 05-嵌入式软硬件实现/
├── 06-测试验证/
├── 07-内部外部验收/
└── 08-复盘结项/

每个启用阶段包含:

阶段目录/
├── 阶段记录.md
├── 正式成果/
└── 过程记录/
    ├── 任务记录/       # 每项任务或任务包一份 Markdown,使用明确的任务名称
    └── 历史资料/       # 按实际需要保存草稿、旧版和历史确认

阶段决定记在阶段记录的过程栏目,任务决定记在原任务;范围较大时可引用已有变更记录。无需为一次确认另建审批文件。角色子目录仅在资料量确有需要时使用。

各层分别记录什么

项目概览

记录稳定信息:项目目标与范围、有效流程基线、中心及相关真人分工、资料入口、适用验收范围和已确认的通信方式。人员变化保留交接事实,不把固定示例姓名或 Etunel 技术编号当成必填表。

使用 项目概览模板。

项目只有一份持续维护的计划主表。已有项目沿用已确认载体,新项目默认采用 Excel 八列计划模板,实际主表在概览和进度中登记入口;评估、改期和实际执行的维护按 项目计划规则。

项目进度

作为项目当前情况的统一入口,每次相关事实变化后同步维护;计划主表保留完整工作项和实际执行,Markdown 只显示摘要和入口:

  • 当前阶段与整体进度:已完成、当前、后续阶段,关键成果与下一步。阶段完成依据真人决定;有跳转时如实标记,不将经过阶段等同于完成。
  • 当前待处理事项:逐项写事项、所属阶段、负责人、当前情况、下一步与需要谁决定。
  • 时间:原计划完成时间、当前有效计划完成时间;实际完成后记录真人确认完成时间。已约定起始时间也保留。
  • 未完成及影响:未完成内容、原因、影响的成果/任务/后续阶段/对外节点,必须完成的阶段,必要真人决定及来源。
  • 原记录入口:链接所属阶段的任务记录;事项详情以该记录为准,项目层维护必要摘要,不复制所有历史。

所有当前需处理事项都列出,逾期事项重点显示。跨阶段未完成事项持续可见;对 Bug 等已有系统引用原条目,不重复分配已明确责任、期限或另造缺陷清单。尚未约定期限或完成阶段时写“待确认”并列为需决定事项,不擅自指定。

完成或获得无需继续跟进的明确处置后,从当前事项移到“已完成或已处置”简要历史入口;仍有承接或跟进动作时继续显示。取消、豁免不写已交付,结项承接不自动移除未完成事项。

整体进度默认用阶段和关键成果说明。只有项目已有真人确认的计算规则才用百分比,保留依据;不按阶段序号除以八估算。

使用 项目进度模板。

阶段记录

顶部列阶段状态、管理开始/完成日期、决定依据和一句话进展。开始取中心真人实际启用日期,完成取明确结束/进入下一阶段决定日期,第八阶段取关闭日期;进行中完成日期留空。已有条件授权时分别记录原授权、条件实际满足及实际切换日期,管理交接日期取实际切换日期。工程实际日期另记,不用管理日期计算工程延期或人时。正文固定分为两类:

  1. 正式成果及确认记录:每项最终成果单列名称、版本、位置或链接;对应真人确认逐项列确认人、时间、对象和版本、结论、范围与条件。历史确认留在过程区。
  2. 过程记录:逐项汇总本阶段每个任务的负责人、应交/已交成果、完成情况、确认情况、原计划/当前计划/实际完成时间、缺口、影响、下一步及原任务入口。这里也列跨阶段引用、待确认成果、阶段决定、延期和历史资料入口。

每个任务都要覆盖成果、完成和确认三方面,不能只给过程文件链接。阶段已结束仍有未完成事项时,继续更新该阶段任务摘要并在项目层跟进;不因跨阶段复制任务。

阶段结束的正式小结只含最终成果与确认,未决项和后续安排放过程栏目。中心聊天汇报及群交接总结、发送实际结果也留在过程栏目,避免同一交接重复发送。使用 阶段记录模板,主动汇报见 阶段汇报。

任务记录

每项独立结果或同一负责人的内聚任务包一份 Markdown;首次创建后沿用稳定文件位置,退回、改期、跨阶段继续维护原记录。

  • 前部维护现状:任务目标、主责真人、阶段、输入版本与位置、范围、应交结果、完成条件、依赖、三类时间、成果、确认、影响和下一步。
  • 后部追加历史:实际接收、提交、退回、补充、确认、改期、变更、重开、取消等影响交付的事件。每次写时间、人物、内容、依据和影响,不抄录聊天全文或角色内部操作。
  • 状态按事实填写:待接收、进行中、部分完成、待确认、已完成;退回补充、暂缓、已取消等如实说明。逾期和阻塞另列原因,不用它们掩盖已经完成的部分。
  • 时间口径:原计划保留首次确认值;当前计划保留最新经确认值,没有改期就与原计划相同;实际完成只取提交后真人明确确认完成的时间。提交、成果确认、补录和重开各自保留。详见 成果与确认。

延期时写明超过原计划与当前计划的情况,保留每次改期的旧值、新值、原因与真人决定。任务获得部分成果确认不等于整项完成;完成条件有多项确认时核对全部适用确认。

使用 任务记录模板。

需要工时或周期评估时在原任务嵌入 评估栏目。涉及 Bug 处理或承接时沿原问题/共用记录保存 双方确认字段,不复制成另一份缺陷台账。

成果索引

按阶段列当前有效的最终成果名称、版本、位置及确认入口。确认详情只在对应阶段正式栏目维护,索引链接过去。任务状态、延期、草稿和旧版不混入当前成果索引。

使用 成果索引模板。逐项登记全部有效成果和配套资料,或可逐项定位内容的有效包索引。原本在外部系统的成果登记真实完整地址、用途和版本,不强制复制;明确授权本地复制时按 成果与确认 保留原交接和路径映射,索引改为正式位置。复制或补地址日期不改变原提交、采用、确认和完成时间。

结项使用 结项资料归档栏目,属于既有四类结项成果之一。沿用项目确认的格式;目录或确认记录不代表全部原件已归档。

更新顺序与避免重复

  1. 在原任务中记录新事实与来源,更新现状,追加必要历史。
  2. 若涉及正式版本变化,按 成果与确认 保留旧版及旧确认,再登记新最终版。
  3. 更新所属阶段的逐任务摘要;涉及后续阶段时只添加原任务引用。
  4. 同步项目进度的当前事项、影响与时间;有计划主表时据实更新执行情况并保留来源和历史;正式成果变化时更新成果索引。
  5. 主动向中心真人汇报需要确认或决定的阶段结果;取得必要推进决定或既有条件授权实际满足并留档后再推进。需要通知时从这些记录生成摘要,正文及真实发送结果记入过程记录。

若更新中断,继续前核对原记录、阶段和项目摘要是否一致,以真实事实和确认依据为准补齐,不凭较新的文件时间覆盖业务结论。中心不新增一套任务数据库、通知队列或同步服务。

排版约定

  • 一级标题写项目/阶段/任务名称,紧接一句当前情况;二级标题划分现状、要求、成果确认、影响和历史。
  • 每个事项单列,字段用子条目;短标签加粗,栏目之间留空行。比较固定字段时可用短表格,避免塞入多段说明形成宽表。
  • 时间写明确日期,需要时注明时刻和时区;只有日期的确认不补造时分秒。未知、尚未确认、不适用、无分别使用。
  • 链接使用可读名称,关联真实路径。生成文件时核对相对链接,不保留模板指引为项目事实,不创建虚假文件链接。
  • 模板提供版式与字段,生成时替换填写说明,按真实内容展开条目;不为填满模板创造任务、确认、负责人或成果。