听写助手对话记录 42¶
记录编号：DLG-42 日期：2026-08-06 智能体：听写（DT） 参与方：用户、DT 沟通渠道：AI 助手对话 主题：Git 相关信息系统化维护至项目管理文档（PJM）
一、用户需求¶
将所有 Git 相关的信息（仓库、分支、提交规范、版本范围、发布目录、公开同步）从分散位置（AGENTS.md、project_memory、scripts 目录说明、零散操作记录）集中维护到项目管理文档（PJM），形成 Git 操作的单一权威依据，避免团队成员多处查找导致信息不一致。
二、工作过程记录¶
步骤 1：盘点 Git 信息分散位置¶
梳理 Git 信息在项目中的分散分布情况，确认来源与对应 PJM 收纳点：
| 原始位置 | 信息内容 | PJM 收纳点 |
|---|---|---|
| PJM §4.3（原 3 行） | 托管服务、分支、提交规范简述 | §4.3.1~4.3.3 扩展 |
| project_memory.md | 轻量 Git Flow 分支策略、commit 格式、RACI 英文缩写 | §4.3.2 + §4.3.3 |
| AGENTS.md §特定行为（用户手编辑） | 文档汇总/汇报输出目录为 发布/ |
§4.3.5 发布目录机制 |
| DLG-40 / DLG-41 | 发布/ 目录创建、转移 8 份成品、审计闭环 |
§4.3.5 |
| scripts/README.md + sync 脚本 | hk2026-docs 公开仓、同步脚本原理与用法 | §4.3.6 公开文档同步 |
| .gitignore（根目录） | 具体排除项（归档、临时、旧版本、ref 除外） | §4.3.4 版本控制范围 |
| project_memory 归档教训 | 归档目录须排除、ref 不归档 | §4.3.4 + §4.4.6 呼应 |
| 实际操作（commit 示例） | 多段 commit message 用法 | §4.3.3 附加要求 |
步骤 2：设计 PJM §4.3 扩展结构¶
将原 3 行简述扩展为 6 个层级化小节，覆盖全生命周期：
- §4.3.1 仓库清单：双仓模型（私有主仓 + 公开文档镜像仓），含地址、可见性、定位、维护人
- §4.3.2 分支策略：轻量 Git Flow（main/dev/feature）、合并规则、Mermaid 工作流示意图（ASCII 代码块内嵌）
- §4.3.3 提交规范：5 类 type + 适用场景 + 示例，附加多段 message 与 WLG 双向追溯要求
- §4.3.4 版本控制范围：13 行纳入/排除对照表，含
docs/、ref/、发布/、scripts/、临时文件、虚拟环境等 - §4.3.5 发布目录机制：文档发布 vs 代码发布对照表、AI 特定行为输出目标（
发布/）、目录管理规则 - §4.3.6 公开文档同步：同步范围、自动脚本参数表、执行步骤代码块、公开仓规则（只读、结构一致、根 README 导航）
步骤 3：执行 PJM 文档更新¶
- PJM 头部：版本 V1.6 → V1.7，最近更新 2026-08-05 → 2026-08-06，关联文档新增 WLG
- §4.3：原 3 行 → 6 个三级小节，正文扩展约 140 行
- §六修订记录：新增 V1.7 行，详细说明本次扩展的 6 项核心内容
步骤 4：验证文档间一致性¶
- PJM §4.3.5 发布目录机制 ↔ AGENTS.md §特定行为：双处均指向
发布/，一致 ✓ - PJM §4.3.4 归档排除 ↔ §4.4.6 归档策略 ↔ .gitignore：三处规则一致 ✓
- PJM §4.3.6 脚本路径 ↔ 实际文件位置：
scripts/sync-docs-repo.ps1与sync-docs-helper.py✓ - PJM §4.3.2 分支策略 ↔ 实际 git 分支：
main稳定 +dev活跃 ✓
三、结论与产出¶
本次对话产出物清单¶
| 序号 | 产出物 | 位置 | 状态 |
|---|---|---|---|
| 1 | PJM §4.3 系统化扩展 | 项目管理.md（V1.6→V1.7） | ✅ 已完成 |
| 2 | WLG README 更新 | WLG README（V4.6→V4.7） | ✅ 已完成 |
| 3 | DLG-42 本记录 | 20260806_听写助手对话记录42_Git信息维护至PJM.md | ✅ 已创建 |
关键决策¶
- 单一权威来源原则：Git 相关操作规则以 PJM §4.3 为准；AGENTS.md 仅保留 AI 协作所需的特定行为条款，不再重复维护分支策略、提交规范等 Git 团队规则
- 双仓模型固化：私有主仓（hk2026）+ 公开文档镜像仓（hk2026-docs）的双仓模型正式写项目制度，后续团队统一遵循
- 提交与日志双向追溯：正式确立提交规范须与 WLG 工作日志互相对应，避免版本变更来源不明
- 发布目录与 PMG 同步：
发布/目录作为文档汇总/汇报输出的唯一目标位置，分别在 PJM（制度层）与 AGENTS.md（AI 行为层）双处绑定
结构变化对比¶
| 维度 | 变更前（PJM V1.6） | 变更后（PJM V1.7） |
|---|---|---|
| §4.3 行数 | 3 行简述 | 约 140 行详细 |
| 覆盖要点数 | 3（托管/分支/提交） | 6 + 详细子项 |
| 仓库说明 | 未提及双仓模型 | 明确私有主仓 + 公开镜像仓双仓 |
| .gitignore 说明 | 仅 §4.4 提及归档排除 | 13 项纳入/排除对照表（含排除） |
| 公开访问机制 | 未涉及 | 独立 §4.3.6 系统说明同步流程 |
| 发布目录定位 | 未涉及 | §4.3.5 与代码发布对照表 |
四、待办事项¶
| 序号 | 待办 | 负责人 | 截止时间 | 状态 |
|---|---|---|---|---|
| 1 | 本次 PJM V1.7、DLG-42、WLG V4.7 提交推送 Git | DT | 即时 | 待执行 |
| 2 | 执行一次公开同步（scripts/sync-docs-repo.ps1），将 PJM V1.7 更新推到 hk2026-docs 公开仓 |
DT | 即时 | 待执行 |
| 3 | 后续新增 Git 规则（如保护分支、Tag 规范、Code Review）继续追加到 PJM §4.3 | TL / DT | 持续 | 待执行 |
五、备注¶
- 本次改动明确界定了 PJM 与 AGENTS.md 在 Git 规则上的分工：PJM 管团队 Git 制度、AGENTS.md 管 AI 协作行为输出目录，后续两处各有侧重
- 公开文档镜像仓同步脚本目前为手动执行；如团队同步频率提高，可后续升级为 Gitee Webhook 自动触发
修订记录¶
| 版本 | 日期 | 修订人 | 修订内容 |
|---|---|---|---|
| V1.0 | 2026-08-06 | DT | 创建：记录将 Git 相关信息系统化维护至 PJM 项目管理文档（V1.6→V1.7，§4.3 扩展 6 小节） |
本记录由听写根据对话全过程整理。