跳转至

DLG-67 听云工作手册 V1.2 + 文档自主权原则 + 公开同步导航调整

日期：2026-08-11 参与人：曾总（SPO）、听写助手（DT） 主题：听云工作手册新增三项核心职责、确立文档自主权原则、公开文档同步导航结构调整 关联文档：WCL V1.2、DIP1-IMP V2.1、PJM V2.7

一、听云工作手册 V1.2 新增三项核心工作职责

用户指令：在听云工作手册（DOC-OPS-01）中增加三项核心工作职责： 1. 编写维护人类管理员和听云共同理解的凭证清单，全面接管配置工作 2. 编写维护管理员操作手册 3. 编写维护客服服务工作手册

交付内容

WCL-听云工作手册.md V1.1 → V1.2：

  1. §1.2 核心职责新增 3 项：
  2. 凭据管理：编写维护凭证清单（分类/存储/权限/轮换/状态），作为配置工作唯一依据
  3. 配置管理：依据凭证清单全面接管四类配置工作（接口配置/网页操作/数据库修改/文件配置），实现人类干预最小化

  4. 标准化文档：编写维护管理员操作手册 + 客服服务工作手册

  5. §1.3 决策权限拆分两层：

  6. 常规配置变更 ✅ WCL 自主执行（依据凭证清单和操作手册）

  7. 关键配置变更 ⚠️ 需 TL 确认（JWT 密钥/数据库连接/第三方主账号等）

  8. §二 工作目录新增 3 个目录：

  9. admin-manual/（管理员操作手册，可公开）
  10. service-manual/（客服服务工作手册，可公开）
  11. private/credentials/（凭证清单，私有）

二、文档自主权原则确立

用户反馈：骨架文件应由听云自主编写，听云会根据工作需要（即听云工作手册中的职责）调整文件结构。听码同理。PJM 对应调整。

核心理念

人类只在职责层面定义边界，AI 协作者（听云/听码）自主决定其工作目录下的文档结构——实现人类干预最小化、人类技术栈知识要求最小化。

交付内容

  1. WCL-听云工作手册.md V1.2 调整：
  2. §1.2 三项新职责均明确"听云自主决定其文档结构与文件组织"
  3. §二 工作目录结构删除预设的具体文件清单，仅保留目录级别划分

  4. 新增"文档自主权原则"核心说明：人类仅在 ①目录级公开/私有归属变更 ②凭据明文不写入文档 ③手册内容正确性评审 三个层面介入

  5. DIP1-IMP V2.0 → V2.1：

  6. §一 角色定义新增"文档自主权"维度行

  7. §二 "DIP1 文档目录"行更新表述

  8. PJM V2.6 → V2.7：

  9. §3.4.2 RACI 表后新增"文档自主权原则"说明段
  10. §3.5.1 职责边界表新增"文档自主权"维度行
  11. §3.5.2 RACI 表新增"工作目录文档结构自主决策"行（WDE/WCL=R 自主决策，TL=A 内容评审）
  12. §3.5.2 RACI 表后新增"文档自主权原则"说明段

三、公开文档同步导航结构调整

用户指令： 1. 听云和 DIP1 应列到一级分类中 2. 听码和听云的文档（排除 private 部分）纳入公开范围 3. 后续听云/听码文档结构调整通过"公开文档同步"指令一并处理

交付内容

url_map.py NAV_STRUCTURE 调整： - DIP1 从"技术文档 TND"子分类提升为一级分类"DIP1 子项目 DIP1（听码 WDE）" - 听云"生产运维 OPS（听云 WCL）"已为一级分类（V2.6 已完成） - build-site.py 已正确处理 ops/（排除 private/worklog）和 dip1/docs/

操作约定（本次确立）

后续当用户发出"公开文档同步"指令时，DT 应： 1. 检查 ops/ 和 dip1/docs/ 下是否有新增/删除/重命名的文档 2. 如有变化，更新 scripts/url_map.py 中的 MANUAL_MAP（slug 映射）和 NAV_STRUCTURE（导航结构） 3. 执行 git 同步（§4.3.6）+ MkDocs 站点部署（§4.3.7）

四、变更文件清单

文件 版本变更 变更内容
ops/WCL-听云工作手册.md V1.1 → V1.2 新增凭据管理/配置管理/标准化文档三项职责 + 文档自主权原则
dip1/docs/DIP1-IMP-Code-Agent实施指南.md V2.0 → V2.1 新增文档自主权维度
docs/项目管理.md V2.6 → V2.7 新增文档自主权原则（§3.4.2 + §3.5.1 + §3.5.2）
scripts/url_map.py — DIP1 提升为一级分类
docs/工作日志/对话记录/20260811_听写助手对话记录67_*.md 新建 本工作日志

五、后续待办

  • 听云自主创建 ops/admin-manual/、ops/service-manual/、ops/private/credentials/ 目录下的文档（听云根据职责需要自主决定文件结构）
  • 执行公开文档同步（git 同步 + MkDocs 站点部署）
  • 更新 ops/README.md 目录索引 Mermaid 图（由听云自主维护）

本日志记录听云工作手册 V1.2 + 文档自主权原则 + 公开同步导航调整的完整变更过程。