听写助手对话记录：文档结构重构与规范修正¶
记录编号：DLG-20260804-07 日期：2026-08-04 智能体：听写（文档编写助手） 参与方：项目发起人（用户）、听写 沟通渠道：AI 助手对话 主题：agents.md 缩减为 AI 协作指南、创建 PJM、修正 README.md 使用规范、需求文档分层拆分
一、用户需求¶
用户提出三项结构调整需求：
- agents.md 内容缩减：符合 AI 行业惯例（AGENTS.md 风格），描述人机协作关系，指向新的项目管理文档。
- 需求文档拆分：需求分析目录下 README.md 改为目录索引，主内容按三层结构拆分到独立文件。
- 检查其他目录：所有子目录的 README.md 均应是目录索引而非主文档内容。
二、工作过程记录¶
步骤 1：审查所有子目录 README.md 使用情况¶
审查发现所有业务子目录存在同样问题：
| 目录 | 问题 |
|---|---|
| 需求分析/ | README.md 承载主文档内容 |
| 报价服务/ | README.md 承载主文档内容 |
| 客户项目跟踪服务/ | README.md 承载主文档内容 |
| 技术文档/ | README.md 承载主文档内容 |
| 工作日志/ | ✅ 正确使用（目录索引） |
步骤 2：创建项目管理制度文档（PJM - DOC-A05）¶
创建 docs/项目管理.md，从原 agents.md 迁移全部项目管理制度内容： - 项目概述、平台服务架构、品牌视觉规范 - 管理制度（目标/任务/进度/风险/变更/质量/决策/汇报） - 团队角色与权责（RACI） - 协作机制、关键约束
步骤 3：重构 agents.md 为 AI 协作指南（V5.0）¶
按 AGENTS.md/CLAUDE.md 行业惯例重写，聚焦 AI 协作：
| 板块 | 内容 |
|---|---|
| 项目身份 | 项目名称、运营主体、品牌、阶段 |
| 人机协作模型 | 人类/AI 角色与决策权限 |
| AI 行为规则 | 必须遵守的规则 + 禁止行为 |
| 文档导航 | 核心文档、服务文档、参考资料 |
| 目录结构 | 最新目录树 |
| 快速上手 | 新增 AI 协作者阅读顺序 |
步骤 4：修正需求分析目录（README.md 改为索引）¶
将原 README.md 内容拆分为三份独立文档：
| 新文档 | 编号 | 内容 |
|---|---|---|
| 战略级需求.md | RQD-S | 市场机会、业务模式、竞争壁垒、战略目标 |
| 业务级需求.md | RQD-B | QSV 需求、CPT 需求、跨服务需求 |
| 执行级需求.md | RQD-O | 阶段规划、干系方需求、功能组需求 |
新 README.md 改为目录索引（含文档列表、三层结构说明、阅读指引）。
步骤 5：修正其他子目录¶
| 目录 | 新内容文件 | 新 README.md |
|---|---|---|
| 报价服务/ | 报价服务设计.md | 目录索引 + 服务概述 |
| 客户项目跟踪服务/ | 客户项目跟踪服务设计.md | 目录索引 + 服务概述 |
| 技术文档/ | 技术规划.md | 目录索引 + 目录说明 |
步骤 6：更新术语表文档索引¶
更新 GLY §7 文档索引，反映新结构： - 新增 PJM（项目管理制度） - 新增 RQD-S/B/O（需求分析子文档） - 新增 QSV-D、CPT-D、TND-P（服务设计子文档） - 标注目录型文档与内容型文档的区别
步骤 7：更新所有交叉引用¶
更新以下文档的路径引用： - 术语表.md - 各服务 README.md - 工作日志 README.md
三、结论与产出¶
本次对话产出物清单¶
| 序号 | 产出物 | 位置 | 状态 |
|---|---|---|---|
| 1 | agents.md V5.0（AI 协作指南） | agents.md | 已完成 |
| 2 | 项目管理制度 PJM（DOC-A05） | docs/项目管理.md | 已完成 |
| 3 | 需求分析/README.md V3.0（目录索引） | docs/需求分析/README.md | 已完成 |
| 4 | 战略级需求 RQD-S | docs/需求分析/战略级需求.md | 已完成 |
| 5 | 业务级需求 RQD-B | docs/需求分析/业务级需求.md | 已完成 |
| 6 | 执行级需求 RQD-O | docs/需求分析/执行级需求.md | 已完成 |
| 7 | 报价服务/README.md V3.0（目录索引） | docs/报价服务/README.md | 已完成 |
| 8 | 报价服务设计 QSV-D | docs/报价服务/报价服务设计.md | 已完成 |
| 9 | 客户项目跟踪服务/README.md V3.0（目录索引） | docs/客户项目跟踪服务/README.md | 已完成 |
| 10 | 客户项目跟踪服务设计 CPT-D | docs/客户项目跟踪服务/客户项目跟踪服务设计.md | 已完成 |
| 11 | 技术文档/README.md V3.0（目录索引） | docs/技术文档/README.md | 已完成 |
| 12 | 技术规划 TND-P | docs/技术文档/技术规划.md | 已完成 |
| 13 | 术语表 V4.0（文档索引更新） | docs/术语表.md | 已完成 |
关键决策与说明¶
- PMG 重新定位：从"项目管理制度"改为"人机协作指南"，聚焦 AI 协作规则与项目导航，制度内容迁移至 PJM。
- PJM 创建：项目管理制度独立为 PJM（DOC-A05），与 PMG（DOC-A01）形成"协作指南 + 管理制度"双轨结构。
- README.md 规范确立：所有子目录 README.md 必须为目录索引，主内容放到独立命名的文件中。
- 需求分析分层拆分：三层结构各自独立为文档（RQD-S/B/O），便于独立维护和版本管理。
- 文档类型标注：目录型文档标注"（目录）"，内容型文档标注具体类型（如"报价服务设计"）。
当前文档体系（V5.0）¶
hk2026/
├── agents.md PMG：AI 人机协作指南（精简）
├── docs/
│ ├── 项目管理.md PJM：项目管理制度（完整）
│ ├── 需求分析/
│ │ ├── README.md 目录索引
│ │ ├── 战略级需求.md RQD-S
│ │ ├── 业务级需求.md RQD-B
│ │ └── 执行级需求.md RQD-O
│ ├── 术语表.md GLY
│ ├── 报价服务/
│ │ ├── README.md 目录索引
│ │ ├── 报价服务设计.md QSV-D
│ │ └── 报价模型设计.md QMD
│ ├── 客户项目跟踪服务/
│ │ ├── README.md 目录索引
│ │ └── 客户项目跟踪服务设计.md CPT-D
│ ├── 技术文档/
│ │ ├── README.md 目录索引
│ │ └── 技术规划.md TND-P
│ └── 工作日志/
│ └── README.md 日志索引
└── ref/
四、修订记录¶
| 版本 | 日期 | 修订人 | 修订内容 |
|---|---|---|---|
| V1.0 | 2026-08-04 | DT | 创建 |
本记录由听写根据对话全过程整理。