AGENTS.md — 人机协作指南¶
文档编号:DOC-A01 / PMG 版本:V8.0 最后更新:2026-08-20
项目身份¶
- 项目:香港配送+安装互联网平台 (HKDIP)
- 运营主体:织布鸟智居科技有限公司 (WLYT)
- 品牌:织布鸟 WEAVELY
- 阶段:筹备期前期
人机协作模型¶
本项目采用人机协同工作模式,AI 智能体作为团队成员的"数字同事":
| 角色 | 职责 | 决策权限 |
|---|---|---|
| 人类 | 业务决策、方向把控、最终审批 | 最高决策权 |
| AI(听写 DT) | 负责其他全面:Gitee、文档发布、项目管理、设计、用户测试(兼文档撰写、信息检索、方案起草) | 辅助建议权 |
| AI(听码 WDE) | 只做编码:依据听写提供的设计文档,只对本地代码进行操作(工作目录 dip1/,目前是 dip1) |
辅助建议权 |
| AI(听云 OCM) | 只做生产环境部署、第三方集成、客服等(工作目录 ocm/,原 ops/→ocm/) |
辅助建议权 |
V8.0 三 AI 新分工要点(替代 V7.x 的 DT/CA/RA 划分): - 听写 DT = 团队协作主轴:除编码与生产运维外的所有事务,含 Gitee 仓库管理、文档发布、项目管理制度、设计稿、用户测试组织 - 听码 WDE = 纯编码执行:只对本地代码做操作,不接触生产环境、不接触 Gitee 远程仓库 - 听云 OCM = 纯生产运维:生产环境部署/回滚、第三方服务集成、客服工单处理;目录简称从
ops/改为ocm/
协作原则: 1. 辅助不替代:AI 产出为草案,人类做最终决策 2. 可追溯:AI 参与的工作记入对应日志(DTL/OCL/WDL,详见§日志体系) 3. 边界清晰:AI 不得擅自变更核心业务内容;三 AI 职责隔离,互不越权 4. 保密优先:AI 不得外泄客户/师傅/商业机密
AI 行为规则¶
必须遵守¶
- 路径:一律使用相对路径,禁止绝对路径
- 术语:使用 GLY 中定义的英文缩写(SPO/BO/QSV 等)
- 记录:每完成一个任务立即写对应日志(DTL/OCL/WDL,详见§日志体系),不得用协作记录代替日志
- 标注:不确定的信息须标注,不编造
- 精简:删除文件须确认,变更须说明原因
- 流程图:统一使用 Mermaid 语法,禁止 ASCII 字符画
禁止行为¶
- 不得将敏感信息发送至外部服务
- 不得擅自修改报价参数、合作条款
- 不得忽略用户明确指令(如"禁止 1 字符缩写")
- 不得在未确认的情况下执行破坏性操作
特定行为¶
- 文档汇总输出:将指定范围的若干文档,直接顺序汇总成为单一的pdf文档,不进行任何修改。各文档以"篇"的形式进行分隔,mermaid转换为图片,并且与代码合并输出。默认输出目录是:
发布/。 - 文档汇报输出:根据指定范围的输出要求(例如:项目整体进展情况),总结提炼,形成单一ppt文档(html格式),尽量详尽,突出重点,避免重复内容。默认输出目录是:
发布/。 - git同步:将主仓库当前变更提交并推送至 Gitee hk2026 私有主仓 main 分支(团队协作源代码与文档备份唯一通道)。详见 PJM §4.3.2~4.3.5。⚠ 仅在用户明确指令时执行,不得自动触发。
- 文档公开发布:在 git 同步完成(hk2026 私有主仓)的基础上,额外构建 MkDocs Material 站点并通过 wrangler / deploy-site.ps1 直接部署到 Cloudflare Pages(生产域名
https://hk2026.pages.dev,Cloudflare Pages Project 名 =hk2026),链路为 hk2026 私有主仓 → MkDocs 构建 → Cloudflare Pages 直传部署,不再经过 Gitee hk2026-docs 公开镜像仓(该仓已废除,见§双轨交付机制)。详见 PJM §4.3.7。⚠ 仅在用户明确指令时执行,不得自动触发。
双轨交付机制(V8.0 新增)¶
本节定义团队代码与文档交付的唯一权威路径,所有 AI 与人类成员须遵循。
仓库现状¶
| 仓库/系统 | 状态 | 定位 |
|---|---|---|
| Gitee hk2026(私有主仓) | ✅ 继续使用,但定位收窄 | 只作为团队协作的源代码仓库(含 dip1/ 代码 + ocm/ 运维 + docs/ 文档源);AI特定行为第3条「git同步」仅推送本仓 main 分支 |
| 🔴 已废除 / 不再使用 | 历史 Gitee 公开只读镜像仓彻底关停,所有与该仓有关的 Git clone / push / sync / checkout 操作全部永久取消;Cloudflare Pages 文档公开发布不再依赖该仓,改为从 hk2026 私有主仓直接构建部署(见下 Cloudflare Pages 行与 AI 特定行为第 4 条) | |
| Cloudflare Pages(Project = hk2026) | ✅ 继续使用(链路重构) | 对外公开发布 MkDocs 文档站点唯一通道;链路从「Gitee hk2026-docs → Cloudflare Pages」重构为 hk2026 私有主仓(本地构建 → wrangler/deploy-site.ps1 直传)→ Cloudflare Pages;生产域名 https://hk2026.pages.dev;脚本:scripts/build-site.py + scripts/deploy-site.ps1(ProjectName 参数从 hk2026-docs 改为 hk2026) |
双轨交付路径¶
听写 push hk2026 备份 + 听云从听写 scp/rsync 接收代码包,不依赖 Gitee 公开仓。文档公开发布则从 hk2026 私有主仓本地 MkDocs 构建后直接部署 Cloudflare Pages,不再经过 Gitee hk2026-docs:
听码(dip1/ 本地代码)
│
├──→ 听写打包代码包
│ │
│ ├──→ push 到 Gitee hk2026(备份用,作为团队协作源代码仓库)
│ │
│ ├──→ scp/rsync 推送代码包到听云本地暂存区
│ │ │
│ │ └──→ 听云部署到阿里云生产环境
│ │
│ └──→ (AI特定行为#4:文档公开发布)本地 MkDocs 构建站点
│ │
│ └──→ wrangler / deploy-site.ps1 直传 Cloudflare Pages
│ │
│ └──→ 生产域名 https://hk2026.pages.dev(Project = hk2026,不再经过 Gitee hk2026-docs)
│
└──→ 听云与听写、听码的协作:只发生在本地和阿里云,不与 Gitee 有任何关系
边界约束¶
- Gitee hk2026-docs:🔴 已废除(2026-08-22 用户指令)。仅废除「Gitee 平台上的这个公开 Git 仓」——即所有与该仓有关的 Git clone / push / sync / checkout / scripts/sync-docs-repo.ps1 操作全部永久取消,仓库地址与历史同步脚本物理保留仅作归档。文档公开发布(MkDocs + Cloudflare Pages)流程不受影响但链路重构:改为 AI 特定行为第 4 条「hk2026 私有主仓 → MkDocs 构建 → Cloudflare Pages 直传部署(Project = hk2026,生产域名 https://hk2026.pages.dev)」,scripts/deploy-site.ps1 / build-site.py / mkdocs.yml 继续使用、参数按新项目名调整。(见 PJM §4.3.1 V3.3 / §4.3.6 / §4.3.7)
- Gitee hk2026:仅作为团队协作的源代码仓库使用,承担代码备份与协作追溯职责,不承担生产部署职责
- 听云与 Gitee 无关:听云从听写处通过 scp/rsync 接收代码包,部署至阿里云;听云不直接克隆或推送 Gitee 仓库
- 听码与 Gitee 无关:听码只对本地代码进行操作,不执行 git push / git pull 远程操作(与 PJM §3.4.2 RACI 表「DIP1 Code Agent 不持有 git push 权限」一致)
日志体系(V8.0 新增)¶
三 AI 各有专属日志目录与编号格式,强制要求每完成一个任务立即写日志,不得用协作记录(微信/对话/邮件)代替日志。
| 日志类型 | 全称 | 目录 | 编号格式 | 维护人 |
|---|---|---|---|---|
| DTL | 听写任务日志(Dictation Task Log) | docs/工作日志/dtl/ |
L-YYYYMMDD-NN |
听写 DT |
| OCL | 听云运维日志(OCM Cloud Log) | ocm/worklog/ocl/ |
L-YYYYMMDD-NN |
听云 OCM |
| WDL | 听码开发日志(WDE Dev Log) | dip1/docs/worklog/wdl/ |
L-YYYYMMDD-NN |
听码 WDE |
历史日志归档¶
- 历史 DLG(docs/工作日志/对话记录/):保留为历史归档,不删除,亦不再新增条目
- 历史 OWLG(原 ops/worklog/,已随 ops/→ocm/ 重命名迁移):保留为历史归档,不删除
- 历史 DWLG(dip1/docs/worklog/):保留为历史归档,不删除
- 新任务一律使用 DTL/OCL/WDL 三套编号,旧编号体系冻结
强制要求¶
- 即时性:每完成一个任务立即写日志,不得延后补写
- 独立性:日志不得用协作记录(微信/对话/邮件/PR 评论)代替;协作记录可引用,但日志须独立成文
- 可追溯:日志须记录任务起止时间、输入产物、输出产物、阻塞与决策点,与对应 commit/PR 双向可引用
- 分层归属:DTL 由听写维护,OCL 由听云维护,WDL 由听码维护;跨 AI 协作任务各自从本方视角写日志
文档导航¶
核心文档(必读)¶
| 优先级 | 文档 | 简称 | 版本 | 编号 | 说明 |
|---|---|---|---|---|---|
| 1 | 项目管理制度 | PJM | V3.1 | DOC-A05 | 目标管理、RACI 权责(含现任人员+三AI新分工)、变更管理、git tag 快照、业务设计完整性核查专章(V3.1) |
| 1.5 | 业务架构说明 | BAS | V1.0 | DOC-A07 | V8.0 阶段二新增:业务领域全景、5 服务限界上下文总图、协作边界与契约、领域事件总线、DDD 实施规范、演进稳定性基线 |
| 2 | 需求分析·战略级 | RQD-S | V1.1 | DOC-A02-S | 市场机会、业务模式、阶段规划、口碑壁垒 |
| 3 | 需求分析·业务级 | RQD-B | V1.3 | DOC-A02-B | 服务需求、跨服务需求、口碑营销策略、OPS 运营需求 |
| 4 | 需求分析·执行级 | RQD-O | V1.4 | DOC-A02-O | 阶段里程碑、干系方×功能组矩阵(含人员对应)、MVP 范围、四角服务架构 |
| 5 | 术语表 | GLY | V4.3 | DOC-A03 | 术语与英文缩写定义(含报价/本地化/文档编号/运营术语) |
| 6 | 工作日志 | WLG | V3.8 | DOC-A04 | 沟通记录索引(AI对话/微信/线下) |
服务与技术文档¶
| 服务 | 主文档 | 简称 | 版本 | 编号 | 说明 |
|---|---|---|---|---|---|
| QSV 报价服务 | 报价服务设计 | QSV-D | V1.0 | DOC-P31-D | 服务边界、职责原则、对接方案 |
| 报价模型设计 | QMD | V2.0 | DOC-P32 | 8 大类参数、32 项因子、封顶价机制 | |
| CPT 客户跟踪服务 | 客户项目跟踪服务设计 | CPT-D | V2.3 | DOC-P41-D | 8 阶段生命周期、8 类跟踪池、7 类采集物、异常分支、L6 作业规范子流程 |
| 现场工作登记表 | CPT-F | V1.0 | DOC-P41-F | 8 阶段电子表单、183 字段、7 类采集物、分 5 类干系方 | |
| MDS 主数据服务 | 主数据服务设计 | MDS-D | V1.1 | DOC-P51-D | 服务边界、四库关系、与各业务服务对接方案、数据闭环 |
| 安装服务特征库设计 | SCL | V1.0 | DOC-P51-S | 8 大品类目录、32 细分类目、产品参数映射、费率基准、技能要求 | |
| 楼宇特征库设计 | BPL | V1.0 | DOC-P51-B | 7 大楼宇类型、25+10 扩展字段、系数映射、采集更新机制(吸收原 TND D03) | |
| 师傅特征库设计 | WPL | V1.1 | DOC-P51-W | 三级等级体系、6 类 50+ 字段、技能矩阵、CPT 反哺、隐私保护 | |
| 客户特征库设计 | CPL | V1.1 | DOC-P51-C | 五维标签体系、信任徽章、推荐关系链、PDPO 合规 | |
| 标签体系元模型 | 标签体系元模型设计 | TSMM | V1.0 | DOC-P52 | 标签分类框架、隐私合规、CPT-D 场景化采集机制 |
| OPS 运营服务 | 运营服务设计 | OPS-D | V1.1 | DOC-P61-D | 获客与增长引擎、6 类获客场景、7 组销售物料、口碑营销、B 端合作 |
| 销售物料详细设计 | OPS-M | V1.0 | DOC-P61-M | 7 组 32 项物料详细规格、版本管理、责任矩阵、场景组合、技术方案 | |
| 场景手册 | OPS-S | V1.0 | DOC-P61-S | 6 个获客场景运营执行手册、配套物料、协同触点、效果指标 | |
| DIS 派单服务 | 派单服务设计 | DIS-D | V1.0 | DOC-P71-D | V8.0 阶段一新增:独立物流派单决策引擎、三模式(M1/M2/M3)+ C7 保险赔付策略 + OL 人工调整;DDD 战略+战术设计完整 |
| TND 技术文档 | 技术规划 | TND-P | V1.1 | DOC-D00-P | 规划文档清单(D01-D10)、技术原则 |
| MVP 实施方案 | MVP | V1.0 | DOC-D00-M | 极简 MVP:飞书多维表格+AI 听写助手;40 字段数据模型;8 阶段操作手册;四阶段演进路径 | |
| ARC 归档 | docs/归档/) |
V8.0 已废止:原 docs/归档/ 目录已删除,版本快照通过 git tag / git branch 管理,详见 PJM §4.6 |
各子目录的
README.md为该目录索引页(RQD/QSV/CPT/TND/WLG 均为 V3.0)。
目录结构(Mermaid 文档树)¶
graph LR
ROOT["🗁 hk2026/ 项目根目录"] --> PMG["agents.md<br/>PMG V6.0 人机协作指南"]
ROOT --> PPT1["团队内部介绍.html/pdf"]
ROOT --> PPT2["投资方介绍.html/pdf"]
ROOT --> DOCS["🗁 docs/"]
ROOT --> REF["🗁 ref/ 参考资料库"]
DOCS --> PJM["项目管理.md<br/>PJM V1.3"]
DOCS --> GLY["术语表.md<br/>GLY V4.1"]
DOCS --> RQD_DIR["🗁 需求分析/ RQD V3.0"]
DOCS --> QSV_DIR["🗁 报价服务/ QSV V3.0"]
DOCS --> CPT_DIR["🗁 客户项目跟踪服务/ CPT V3.0"]
DOCS --> MDS_DIR["🗁 主数据服务/ MDS V1.0"]
DOCS --> OPS_DIR["🗁 运营服务/ OPS V1.0"]
DOCS --> TND_DIR["🗁 技术文档/ TND V3.0"]
DOCS --> WLG_DIR["🗁 工作日志/ WLG V3.0"]
DOCS --> ARC_DIR["🗁 归档/ ARC V1.0"]
RQD_DIR --> RQD_I["README.md 目录索引"]
RQD_DIR --> RQDS["战略级需求.md RQD-S V1.1"]
RQD_DIR --> RQDB["业务级需求.md RQD-B V1.1"]
RQD_DIR --> RQDO["执行级需求.md RQD-O V1.0"]
QSV_DIR --> QSV_I["README.md 目录索引"]
QSV_DIR --> QSVD["报价服务设计.md QSV-D V1.0"]
QSV_DIR --> QMD["报价模型设计.md QMD V2.0"]
CPT_DIR --> CPT_I["README.md 目录索引"]
CPT_DIR --> CPTD["客户项目跟踪服务设计.md CPT-D V2.1"]
CPT_DIR --> CPTF["现场工作登记表.md CPT-F V1.0"]
MDS_DIR --> MDS_I["README.md 目录索引"]
MDS_DIR --> MDSD["主数据服务设计.md MDS-D V1.0"]
MDS_DIR --> SCL["安装服务特征库设计.md SCL V1.0"]
MDS_DIR --> BPL["楼宇特征库设计.md BPL V1.0"]
MDS_DIR --> WPL["师傅特征库设计.md WPL V1.0"]
MDS_DIR --> CPL["客户特征库设计.md CPL V1.0"]
MDS_DIR --> TSMM["标签体系元模型设计.md TSMM V1.0"]
TND_DIR --> TND_I["README.md 目录索引"]
TND_DIR --> TNDP["技术规划.md TND-P V1.0"]
WLG_DIR --> WLG_I["README.md 日志索引"]
WLG_DIR --> WLG_TMP["_模板_对话记录.md"]
WLG_DIR --> WLG_DLG["🗁 对话记录/ DLG-01~18"]
ARC_DIR --> ARC_I["README.md 归档说明"]
ARC_DIR --> ARC_V1["🗁 20260804_V1.0_筹备期前期/"]
ARC_DIR --> ARC_V2["🗁 20260805_V1.1_筹备期前期/"]
classDef default fill:#F2F0EB,stroke:#004046,stroke-width:1px;
classDef dir fill:#D4AF78,color:#004046,stroke:#004046;
class ROOT,DOCS,REF,RQD_DIR,QSV_DIR,CPT_DIR,MDS_DIR,TND_DIR,WLG_DIR,ARC_DIR,WLG_DLG,ARC_V1,ARC_V2 dir;
文档关联关系图(总图)¶
关系线编号(R1~R43)对应下方《文档关系详情表》,详细说明每条关系的具体内容。 总图展示全项目 27 个文档节点的完整关联关系;如需聚焦查看,可参阅下方两张分图。
graph TD
%% 节点定义(DOC-A 管理类)
PMG["PMG<br/>agents.md V6.0"]
PJM["PJM<br/>项目管理.md V1.3"]
GLY["GLY<br/>术语表.md V3.0"]
WLG["WLG<br/>工作日志 V3.0"]
ARC["ARC<br/>归档 V1.0"]
%% 节点定义(DOC-A02 需求类)
RQD["RQD README<br/>目录索引 V3.0"]
RQDS["RQD-S<br/>战略级 V1.1"]
RQDB["RQD-B<br/>业务级 V1.1"]
RQDO["RQD-O<br/>执行级 V1.0"]
%% 节点定义(DOC-P 服务设计类)
QSV["QSV README<br/>目录索引 V3.0"]
QSVD["QSV-D<br/>报价服务设计 V1.0"]
QMD["QMD<br/>报价模型设计 V2.0"]
CPT["CPT README<br/>目录索引 V3.0"]
CPTD["CPT-D<br/>客户跟踪设计 V2.1"]
CPTF["CPT-F<br/>现场工作登记表 V1.0"]
MDS["MDS README<br/>目录索引 V1.0"]
MDSD["MDS-D<br/>主数据服务设计 V1.0"]
SCL["SCL<br/>安装服务特征库 V1.0"]
BPL["BPL<br/>楼宇特征库 V1.0"]
WPL["WPL<br/>师傅特征库 V1.0"]
CPL["CPL<br/>客户特征库 V1.0"]
TSMM["TSMM<br/>标签体系元模型 V1.0"]
TND["TND README<br/>目录索引 V3.0"]
TNDP["TND-P<br/>技术规划 V1.0"]
OPS["OPS README<br/>目录索引 V1.0"]
OPSD["OPS-D<br/>运营服务设计 V1.0"]
OPSS["OPS-S<br/>场景手册 V1.0"]
%% 入口导航关系(PMG → 其他)
PMG -- "R1 入口指引" --> PJM
PMG -- "R2 入口指引" --> RQD
PMG -- "R3 术语支撑 ←" --> GLY
PMG -- "R4 过程记录 ←" --> WLG
%% 管理类内部关系
PJM -- "R5 归档机制定义" --> ARC
PJM -- "R6 RACI角色定义" --> RQDO
ARC -- "R7 归档快照 ←" --> WLG
%% 需求层级关系
RQD -- "R8 目录→子文档" --> RQDS
RQD -- "R9 目录→子文档" --> RQDB
RQD -- "R10 目录→子文档" --> RQDO
RQDS -- "R11 战略→业务 细化" --> RQDB
RQDB -- "R12 业务→执行 落地" --> RQDO
%% 需求→服务设计 驱动
RQDB -- "R13 需求驱动 报价服务" --> QSV
RQDB -- "R14 需求驱动 跟踪服务" --> CPT
RQDB -- "R27 需求驱动 主数据服务" --> MDS
RQDB -- "R37 需求驱动 运营服务" --> OPS
RQDO -- "R15 MVP范围 双服务" --> QSVD
RQDO -- "R16 MVP范围 双服务" --> CPTD
%% 服务设计内部关系
QSV -- "R17 目录→子文档" --> QSVD
QSV -- "R18 目录→子文档" --> QMD
QSVD -- "R19 报价参数定义" --> QMD
CPT -- "R20 目录→子文档" --> CPTD
CPT -- "R25 目录→子文档" --> CPTF
CPTD -- "R26 设计依据→表单落地" --> CPTF
CPTD -- "R21 数据闭环反哺" --> QSVD
CPTD -.->|"R21 支撑"| QMD
%% MDS 主数据服务内部关系
MDS -- "R28 目录→子文档" --> MDSD
MDS -- "R29 目录→子文档" --> SCL
MDS -- "R30 目录→子文档" --> BPL
MDS -- "R31 目录→子文档" --> WPL
MDS -- "R32 目录→子文档" --> CPL
%% OPS 运营服务内部关系
OPS -- "R38 目录→子文档" --> OPSD
OPS -- "R39 目录→子文档" --> OPSS
%% MDS 与业务服务的主数据供给关系
MDSD -- "R33 主数据供给 报价参数" --> QSVD
MDSD -- "R34 主数据供给 主体档案" --> CPTD
CPTD -- "R35 数据闭环反哺 画像" --> MDSD
%% OPS 与业务服务的协同关系
OPSD -- "R40 获客协同" --> CPTD
CPTD -- "R41 口碑反哺" --> OPSD
MDSD -- "R42 主数据供给 营销画像" --> OPSD
%% 标签体系元模型
TSMM -- "R36 定义标签标准" --> SCL
TSMM -- "R36 定义标签标准" --> BPL
TSMM -- "R36 定义标签标准" --> WPL
TSMM -- "R36 定义标签标准" --> CPL
%% 技术落地
QSVD -- "R22 技术落地" --> TND
CPTD -- "R23 技术落地" --> TND
MDSD -- "R23b 技术落地" --> TND
OPSD -- "R43 技术落地" --> TND
TND -- "R24 目录→子文档" --> TNDP
%% GLY 全局支撑(虚线)
GLY -.->|"全局术语支撑"| PJM
GLY -.->|"全局术语支撑"| RQDS
GLY -.->|"全局术语支撑"| RQDB
GLY -.->|"全局术语支撑"| QSVD
GLY -.->|"全局术语支撑"| CPTD
GLY -.->|"全局术语支撑"| MDSD
GLY -.->|"全局术语支撑"| OPSD
GLY -.->|"全局术语支撑"| TNDP
%% WLG 全局追溯(虚线)
WLG -.->|"变更记录追溯"| PMG
WLG -.->|"变更记录追溯"| PJM
WLG -.->|"变更记录追溯"| RQDB
WLG -.->|"变更记录追溯"| QSVD
WLG -.->|"变更记录追溯"| CPTD
WLG -.->|"变更记录追溯"| MDSD
WLG -.->|"变更记录追溯"| OPSD
classDef mgmt fill:#D4AF78,stroke:#004046,color:#004046;
classDef req fill:#004046,stroke:#004046,color:#fff;
classDef srv fill:#2a9d8f,stroke:#004046,color:#fff;
classDef tech fill:#457b9d,stroke:#004046,color:#fff;
class PMG,PJM,GLY,WLG,ARC mgmt;
class RQD,RQDS,RQDB,RQDO req;
class QSV,QSVD,QMD,CPT,CPTD,CPTF,MDS,MDSD,SCL,BPL,WPL,CPL,TSMM,OPS,OPSD,OPSS srv;
class TND,TNDP tech;
文档关联关系分图¶
以下两张分图均为总图的局部裁剪,各自包含必要要素 + 涉及的全部关联关系 + 关联关系涉及的非必要要素。 两张分图之间存在重复内容(管理类与业务类文档在对方分图中作为非必要要素出现)。 - 深色实线节点=本图必要要素(归属本架构);浅色虚线节点=非必要要素(关系对端,来自另一架构)。 - 关系线编号与总图、详情表完全一致。 - 覆盖原则:分图一(业务架构)必要要素 22 个 + 分图二(项目管理架构)必要要素 5 个 = 27 个,覆盖总图全部 27 个文档节点,无遗漏。
分图一:业务设计架构¶
必要要素(22 个):RQD 三层需求(4)· QSV 报价服务(3)· CPT 跟踪服务(3,含 CPT-F 登记表)· MDS 主数据服务(6)· 标签体系元模型(1)· OPS 运营服务(3)· TND 技术文档(2)
非必要要素(4 个):PMG / PJM / GLY / WLG(来自管理架构,作为关系对端)
涉及关系:R2 / R6(管理入边)+ R8~R43(业务全链路,含 R27~R35 MDS 主数据 + R36 标签标准 + R37~R43 OPS 运营服务)+ GLY / WLG 全局支撑虚线
graph TD
%% ===== 非必要要素(管理类,关系对端,浅色虚线) =====
PMG["PMG<br/>agents.md"]
PJM["PJM<br/>项目管理.md"]
GLY["GLY<br/>术语表.md"]
WLG["WLG<br/>工作日志"]
%% ===== 必要要素-需求类(4 个) =====
RQD["RQD README<br/>目录索引 V3.0"]
RQDS["RQD-S<br/>战略级 V1.1"]
RQDB["RQD-B<br/>业务级 V1.1"]
RQDO["RQD-O<br/>执行级 V1.0"]
%% ===== 必要要素-服务设计类 QSV+CPT(6 个) =====
QSV["QSV README<br/>目录索引 V3.0"]
QSVD["QSV-D<br/>报价服务设计 V1.0"]
QMD["QMD<br/>报价模型设计 V2.0"]
CPT["CPT README<br/>目录索引 V3.0"]
CPTD["CPT-D<br/>客户跟踪设计 V2.1"]
CPTF["CPT-F<br/>现场工作登记表 V1.0"]
%% ===== 必要要素-服务设计类 MDS(6 个) =====
MDS["MDS README<br/>目录索引 V1.0"]
MDSD["MDS-D<br/>主数据服务设计 V1.0"]
SCL["SCL<br/>安装服务特征库 V1.0"]
BPL["BPL<br/>楼宇特征库 V1.0"]
WPL["WPL<br/>师傅特征库 V1.0"]
CPL["CPL<br/>客户特征库 V1.0"]
%% ===== 必要要素-标签体系元模型(1 个) =====
TSMM["TSMM<br/>标签体系元模型 V1.0"]
%% ===== 必要要素-技术类(2 个) =====
TND["TND README<br/>目录索引 V3.0"]
TNDP["TND-P<br/>技术规划 V1.0"]
%% ===== 必要要素-服务设计类 OPS(3 个) =====
OPS["OPS README<br/>目录索引 V1.0"]
OPSD["OPS-D<br/>运营服务设计 V1.0"]
OPSS["OPS-S<br/>场景手册 V1.0"]
%% ===== 管理入边(R2 R6) =====
PMG -- "R2 入口指引" --> RQD
PJM -- "R6 RACI角色定义" --> RQDO
%% ===== 需求层级 R8~R12 =====
RQD -- "R8 目录→子文档" --> RQDS
RQD -- "R9 目录→子文档" --> RQDB
RQD -- "R10 目录→子文档" --> RQDO
RQDS -- "R11 战略→业务 细化" --> RQDB
RQDB -- "R12 业务→执行 落地" --> RQDO
%% ===== 需求→服务 R13~R16 + R27 =====
RQDB -- "R13 需求驱动 报价服务" --> QSV
RQDB -- "R14 需求驱动 跟踪服务" --> CPT
RQDB -- "R27 需求驱动 主数据服务" --> MDS
RQDB -- "R37 需求驱动 运营服务" --> OPS
RQDO -- "R15 MVP范围 双服务" --> QSVD
RQDO -- "R16 MVP范围 双服务" --> CPTD
%% ===== QSV 服务内部 R17~R19 =====
QSV -- "R17 目录→子文档" --> QSVD
QSV -- "R18 目录→子文档" --> QMD
QSVD -- "R19 报价参数定义" --> QMD
%% ===== CPT 服务内部 R20 R21 R25 R26 =====
CPT -- "R20 目录→子文档" --> CPTD
CPT -- "R25 目录→子文档" --> CPTF
CPTD -- "R26 设计依据→表单落地" --> CPTF
CPTD -- "R21 数据闭环反哺" --> QSVD
CPTD -.->|"R21 支撑"| QMD
%% ===== MDS 服务内部 R28~R32 =====
MDS -- "R28 目录→子文档" --> MDSD
MDS -- "R29 目录→子文档" --> SCL
MDS -- "R30 目录→子文档" --> BPL
MDS -- "R31 目录→子文档" --> WPL
MDS -- "R32 目录→子文档" --> CPL
%% ===== OPS 服务内部 R38 R39 =====
OPS -- "R38 目录→子文档" --> OPSD
OPS -- "R39 目录→子文档" --> OPSS
%% ===== MDS ↔ 业务服务 R33 R34 R35 =====
MDSD -- "R33 主数据供给 报价参数" --> QSVD
MDSD -- "R34 主数据供给 主体档案" --> CPTD
CPTD -- "R35 数据闭环反哺 画像" --> MDSD
%% ===== OPS ↔ 业务服务协同 R40 R41 R42 =====
OPSD -- "R40 获客协同" --> CPTD
CPTD -- "R41 口碑反哺" --> OPSD
MDSD -- "R42 主数据供给 营销画像" --> OPSD
%% ===== 标签体系元模型 R36 =====
TSMM -- "R36 定义标签标准" --> SCL
TSMM -- "R36 定义标签标准" --> BPL
TSMM -- "R36 定义标签标准" --> WPL
TSMM -- "R36 定义标签标准" --> CPL
%% ===== 技术落地 R22~R24 + R23b =====
QSVD -- "R22 技术落地" --> TND
CPTD -- "R23 技术落地" --> TND
MDSD -- "R23b 技术落地" --> TND
OPSD -- "R43 技术落地" --> TND
TND -- "R24 目录→子文档" --> TNDP
%% ===== GLY 全局支撑(业务节点) =====
GLY -.->|"全局术语支撑"| RQDS
GLY -.->|"全局术语支撑"| RQDB
GLY -.->|"全局术语支撑"| QSVD
GLY -.->|"全局术语支撑"| CPTD
GLY -.->|"全局术语支撑"| MDSD
GLY -.->|"全局术语支撑"| OPSD
GLY -.->|"全局术语支撑"| TNDP
%% ===== WLG 全局追溯(业务节点) =====
WLG -.->|"变更记录追溯"| RQDB
WLG -.->|"变更记录追溯"| QSVD
WLG -.->|"变更记录追溯"| CPTD
WLG -.->|"变更记录追溯"| MDSD
WLG -.->|"变更记录追溯"| OPSD
classDef req fill:#004046,stroke:#004046,color:#fff;
classDef srv fill:#2a9d8f,stroke:#004046,color:#fff;
classDef tech fill:#457b9d,stroke:#004046,color:#fff;
classDef ext fill:#F2F0EB,stroke:#D4AF78,stroke-dasharray:5 5,color:#004046;
class RQD,RQDS,RQDB,RQDO req;
class QSV,QSVD,QMD,CPT,CPTD,CPTF,MDS,MDSD,SCL,BPL,WPL,CPL,TSMM,OPS,OPSD,OPSS srv;
class TND,TNDP tech;
class PMG,PJM,GLY,WLG ext;
分图二:项目管理架构¶
必要要素(5 个):PMG(人机协作)· PJM(制度)· GLY(术语)· WLG(日志)· ARC(归档)
非必要要素(10 个):RQD / RQD-O / RQD-S / RQD-B / QSV-D / CPT-D / MDS-D / OPS-D / TSMM / TND-P(来自业务架构,作为关系对端)
涉及关系:R1~R7(管理内部 + 跨域出边)+ GLY / WLG 全局支撑虚线(延伸至 MDS-D、OPS-D)
graph TD
%% ===== 必要要素-管理类(5 个) =====
PMG["PMG<br/>agents.md V6.0"]
PJM["PJM<br/>项目管理.md V1.3"]
GLY["GLY<br/>术语表.md V4.1"]
WLG["WLG<br/>工作日志 V3.0"]
ARC["ARC<br/>归档 V1.0"]
%% ===== 非必要要素(业务类,关系对端,浅色虚线) =====
RQD["RQD README<br/>目录索引"]
RQDO["RQD-O<br/>执行级"]
RQDS["RQD-S<br/>战略级"]
RQDB["RQD-B<br/>业务级"]
QSVD["QSV-D<br/>报价服务设计"]
CPTD["CPT-D<br/>客户跟踪设计"]
MDSD["MDS-D<br/>主数据服务设计"]
OPSD["OPS-D<br/>运营服务设计"]
TSMM["TSMM<br/>标签体系元模型"]
TNDP["TND-P<br/>技术规划"]
%% ===== 管理内部关系 R1~R7 =====
PMG -- "R1 入口指引" --> PJM
PMG -- "R2 入口指引" --> RQD
PMG -- "R3 术语支撑 ←" --> GLY
PMG -- "R4 过程记录 ←" --> WLG
PJM -- "R5 归档机制定义" --> ARC
PJM -- "R6 RACI角色定义" --> RQDO
ARC -- "R7 归档快照 ←" --> WLG
%% ===== GLY 全局支撑 =====
GLY -.->|"全局术语支撑"| PJM
GLY -.->|"全局术语支撑"| RQDS
GLY -.->|"全局术语支撑"| RQDB
GLY -.->|"全局术语支撑"| QSVD
GLY -.->|"全局术语支撑"| CPTD
GLY -.->|"全局术语支撑"| MDSD
GLY -.->|"全局术语支撑"| OPSD
GLY -.->|"全局术语支撑"| TNDP
%% ===== WLG 全局追溯 =====
WLG -.->|"变更记录追溯"| PMG
WLG -.->|"变更记录追溯"| PJM
WLG -.->|"变更记录追溯"| RQDB
WLG -.->|"变更记录追溯"| QSVD
WLG -.->|"变更记录追溯"| CPTD
WLG -.->|"变更记录追溯"| MDSD
WLG -.->|"变更记录追溯"| OPSD
classDef mgmt fill:#D4AF78,stroke:#004046,color:#004046;
classDef ext fill:#F2F0EB,stroke:#004046,stroke-dasharray:5 5,color:#004046;
class PMG,PJM,GLY,WLG,ARC mgmt;
class RQD,RQDO,RQDS,RQDB,QSVD,CPTD,MDSD,OPSD,TNDP ext;
文档关系详情表¶
| 关系编号 | 源文档 | → 目标文档 | 关系类型 | 详细说明 |
|---|---|---|---|---|
| R1 | PMG | PJM | 入口指引 | PMG 为 AI 入口,指向 PJM 了解管理制度、RACI、变更流程、归档机制 |
| R2 | PMG | RQD | 入口指引 | PMG 指向 RQD 目录索引,通过 RQD 再进入三层需求 |
| R3 | PMG ← GLY | 术语支撑(双向语义) | PMG 中使用的简称(SPO/BO/QSV 等)定义于 GLY;AI行为规则强制使用 GLY 术语 | |
| R4 | PMG ← WLG | 过程记录(双向语义) | WLG 记录 PMG 自身的变更历史;PMG 要求 AI 工作后记入 WLG | |
| R5 | PJM | ARC | 归档机制定义 | PJM §4.4 完整定义了版本规范、归档触发、命名规范、操作流程;ARC 按 PJM 执行 |
| R6 | PJM | RQD-O | RACI 角色定义 | PJM §3 定义的 SPO/BO/PO/TL/OL/ML/FL 权责,驱动 RQD-O 干系方需求分配 |
| R7 | ARC ← WLG | 归档快照记录 | WLG 中记录的每次文档变更,按归档节点汇总形成 ARC 批次快照 | |
| R8 | RQD | RQD-S | 目录→子文档 | RQD README 索引页指向战略级需求(第一层:市场/模式/壁垒) |
| R9 | RQD | RQD-B | 目录→子文档 | RQD README 指向业务级需求(第二层:QSV/CPT/跨服务/口碑) |
| R10 | RQD | RQD-O | 目录→子文档 | RQD README 指向执行级需求(第三层:阶段/干系方/功能组/MVP) |
| R11 | RQD-S | RQD-B | 战略→业务细化 | RQD-S 的业务模式/口碑壁垒/品类优先级 → RQD-B 转化为具体服务需求条目 |
| R12 | RQD-B | RQD-O | 业务→执行落地 | RQD-B 的功能需求(CPT-01~14等) → RQD-O 拆解为 MVP 范围/优先级/阶段里程碑 |
| R13 | RQD-B | QSV README | 需求驱动报价 | RQD-B §1 QSV 需求条目驱动报价服务文档目录及设计落地 |
| R14 | RQD-B | CPT README | 需求驱动跟踪 | RQD-B §2 CPT 需求条目(含跟踪池/口碑营销)驱动客户跟踪服务落地 |
| R15 | RQD-O | QSV-D | MVP 范围约束 | RQD-O §3 MVP 服务范围(5大品类/报价能力)限定 QSV-D 的实现边界 |
| R16 | RQD-O | CPT-D | MVP 范围约束 | RQD-O §3 MVP 范围(8阶段/异常/回访)限定 CPT-D 的实现边界 |
| R17 | QSV | QSV-D | 目录→子文档 | QSV README 索引页指向报价服务设计文档(服务边界/对接方案) |
| R18 | QSV | QMD | 目录→子文档 | QSV README 指向报价模型设计文档(8类参数/封顶价) |
| R19 | QSV-D | QMD | 报价参数定义 | QSV-D 定义的服务边界与封顶价规则 → QMD 中参数与系数的设计依据 |
| R20 | CPT | CPT-D | 目录→子文档 | CPT README 索引页指向客户跟踪服务设计(生命周期/跟踪池/采集物) |
| R21 | CPT-D → QSV-D / QMD | 数据闭环反哺 | 核心:CPT-D §5 采集的实际工时/复杂度/楼宇数据 → QSV-D 参数校准入口 → QMD 系数更新 | |
| R22 | QSV-D | TND README | 技术落地入口 | QSV-D 的报价引擎需求 → TND 中报价引擎技术方案(D02)的设计依据 |
| R23 | CPTD | TND README | 技术落地入口 | CPT-D 的跟踪表/采集需求 → TND 中系统架构(D01)、楼宇库(D03)的设计依据 |
| R24 | TND | TNDP | 目录→子文档 | TND README 索引页指向技术规划文档(栈选型/MVP实施计划) |
| R25 | CPT | CPT-F | 目录→子文档 | CPT README 索引页指向现场工作登记表(8 阶段电子表单、183 字段) |
| R26 | CPT-D | CPT-F | 设计依据→表单落地 | CPT-D §4.1 各阶段采集清单 → CPT-F 转化为可操作电子表格表单,覆盖 7 类采集物、5 类干系方 |
| R27 | RQD-B | MDS README | 需求驱动主数据 | RQD-B §MDS 主数据需求条目驱动 MDS 服务文档目录及设计落地 |
| R28 | MDS | MDS-D | 目录→子文档 | MDS README 索引页指向主数据服务设计文档(服务边界/四库/对接方案) |
| R29 | MDS | SCL | 目录→子文档 | MDS README 指向安装服务特征库(8 大品类/32 细分/参数映射/费率基准) |
| R30 | MDS | BPL | 目录→子文档 | MDS README 指向楼宇特征库(7 大楼宇类型/系数映射/采集更新机制,吸收原 TND D03) |
| R31 | MDS | WPL | 目录→子文档 | MDS README 指向师傅特征库(三级等级体系/技能矩阵/CPT 反哺) |
| R32 | MDS | CPL | 目录→子文档 | MDS README 指向客户特征库(五维标签/信任徽章/推荐关系/PDPO 合规) |
| R33 | MDS-D → QSV-D | 主数据供给 | 核心:MDS-D 向 QSV-D 供给报价主数据:SCL 品类费率/产品参数 + BPL 楼宇系数/楼层附加 + WPL 师傅等级系数 | |
| R34 | MDS-D → CPT-D | 主数据供给 | MDS-D 向 CPT-D 供给主体档案 ID:CPL 客户ID + WPL 师傅ID + SCL 服务类型 + BPL 楼宇ID | |
| R35 | CPT-D → MDS-D | 数据闭环反哺 | 核心:CPT-D 采集的实际工时→WPL 师傅画像;客户评分→WPL 等级校准;客户行为→CPL 标签;师傅核实→BPL 楼宇档案;成交价偏差→SCL 费率校准 | |
| R36 | TSMM | SCL/BPL/WPL/CPL | 定义标签标准 | 标签体系元模型定义四库中使用的所有标签的结构、分类规则、数据字典 |
| R37 | RQD-B | OPS README | 需求驱动运营 | RQD-B §5 OPS 运营服务需求条目(OPS-01~10)驱动 OPS 服务文档目录及设计落地 |
| R38 | OPS | OPS-D | 目录→子文档 | OPS README 索引页指向运营服务设计文档(服务边界/场景框架/物料体系/口碑营销/B 端合作) |
| R39 | OPS | OPS-S | 目录→子文档 | OPS README 指向场景手册(6 个获客场景运营执行手册/配套物料/协同触点/效果指标) |
| R40 | OPS-D → CPT-D | 获客协同 | OPS-D 在 L1-L2 获客阶段产生线索转入 CPT 生命周期;CPT-D L1 线索来源对接 OPS 获客场景(S01-S06) | |
| R41 | CPT-D → OPS-D | 口碑反哺 | 核心:CPT-D L8 NPS 采集与客户案例数据反哺 OPS-D 口碑营销与推荐客户池,形成"服务→口碑→获客"闭环 | |
| R42 | MDS-D → OPS-D | 主数据供给 | MDS-D 向 OPS-D 供给 CPL 客户标签/信任徽章 + WPL 师傅个人品牌资料,驱动精准营销与推荐激励 | |
| R43 | OPS-D | TND README | 技术落地入口 | OPS-D 的运营前端/物料管理系统需求 → TND 中运营技术方案的设计依据 |
| 隐含 | GLY → 全部文档 | 全局术语支撑 | 所有文档中的术语简称/缩写/编号规范均由 GLY 统一定义,禁止擅自定义 | |
| 隐含 | WLG → 全部文档 | 变更记录追溯 | 所有文档的变更过程/决策原因/沟通记录均记录于 WLG 对话记录 |
快速上手¶
新增 AI 协作者请按此顺序阅读: 1. 本文件(PMG) → 了解协作规则、AI 行为、文档全景 2. 目录结构图 → 了解文件位置 3. 文档关联关系总图 + 分图一·业务设计 + 分图二·项目管理 + 详情表 → 理解文档间的依赖关系 4. PJM → 了解管理制度、角色 RACI、变更与归档流程 5. RQD-S → RQD-B → RQD-O → 从战略到执行逐层理解业务 6. GLY → 掌握术语与缩写规范 7. WLG → 查看最新进展与沟通历史
修订记录¶
| 版本 | 日期 | 修订人 | 修订内容 |
|---|---|---|---|
| V1.0-V4.0 | 2026-08-04 | DT | 详见 WLG DLG-01~06 历史:从项目制度总纲 → 解耦服务 → 新增需求三层 → 术语规范化 → agents 迁移 |
| V5.0 | 2026-08-04 | DT | 重构为 AI 协作指南:精简内容、人机协作模型、指向 PJM、文档导航重构 |
| V6.0 | 2026-08-04 | DT | 1. 目录结构改为 Mermaid 文档树;2. 新增文档关联关系图(R1~R24 带编号关系线,含全局支撑虚线);3. 新增《文档关系详情表》(24 条关系 + 2 条隐含关系,逐条说明);4. 文档导航表扩展新增「简称/版本/编号」列,同步所有实际文档版本 |
| V6.1 | 2026-08-05 | DT | 保留总图不变,新增两张自包含分图:分图一(业务设计架构,11 必要要素+4 非必要要素)+ 分图二(项目管理架构,5 必要要素+7 非必要要素);分图含全部涉及关联关系,允许重复内容;修正文档树 GLY 版本号 V3.0→V4.1 |
| V6.2 | 2026-08-05 | DT | 新增 CPT-F 现场工作登记表节点(DOC-P41-F V1.0);总图+分图一新增 CPT-F 节点及 R25(CPT→CPT-F 目录关系)/R26(CPT-D→CPT-F 设计依据)关系线;详情表新增 R25/R26 行;分图一必要要素 11→12 |
| V6.3 | 2026-08-05 | DT | 新增 MDS 主数据服务节点(DOC-P51 系列 V1.0,含 MDS-D/SCL/BPL/WPL/CPL 五文档);总图新增 6 节点 + R27~R35 共 9 条关系线 + GLY/WLG 支撑虚线延伸至 MDS-D;详情表新增 R27~R35 行;文档树新增 MDS 目录;服务导航表新增 MDS 6 行;文档节点 16→21、关系 26→35 |
| V6.5 | 2026-08-05 | DT | 新增 TSMM 标签体系元模型(DOC-P52);定义标签三层分类(基础属性/能力画像/场景适配);引入 CPT-D 场景化采集机制;更新文档关系详情表(新增 R36),总图/分图增加 TSMM 节点,覆盖原则更新为 24 个节点 |
| V7.0 | 2026-08-05 | DT | 新增 OPS 运营服务(DOC-P61 系列:OPS/OPS-D/OPS-S);MKT→OPS 全局替换;RQD-B 新增 OPS 需求;RQD-O 升级四角协同架构;总图+分图新增 OPS 3 节点及 R37~R43;覆盖原则 24→27 节点;GLY V4.3 新增运营术语 |
| V7.1 | 2026-08-05 | DT | 整理 20260805 核心运营团队线下讨论记录格式;PJM V1.6 RACI 新增「现任人员」列(曾总/郭总/司徒总/成文/黄总/洪哥);CPT-D V2.3 新增 §2.1 L6 作业规范子流程(6 节点含穿鞋套/地面保护/垃圾带走等);RQD-O V1.4 干系方补充人员说明;WLG V3.8 新增 DLG-33 + 线下讨论索引;导航表版本同步 |
| V7.2 | 2026-08-05 | DT | 补全 V7.0 遗漏:总图+分图一+分图二+详情表新增 OPS 运营服务 3 节点(OPS/OPS-D/OPS-S)及 R37~R43 共 7 条关系线;GLY/WLG 支撑虚线延伸至 OPS-D;覆盖原则 24→27 节点;分图一必要要素 19→22、分图二非必要要素 9→10 |
| V7.3 | 2026-08-05 | DT | 服务导航表新增 OPS-M 销售物料详细设计(DOC-P61-M V1.0);OPS-D 版本同步 V1.0→V1.1 |
| V7.4 | 2026-08-06 | DT | 服务导航表新增 MVP 实施方案(DOC-D00-M V1.0):极简 MVP 方案(飞书多维表格+AI 听写助手;40 字段 CPT-Lite/QSV-Lite/MDS-Lite 数据模型;8 阶段操作手册;AI 协同规范;四阶段演进路径);TND-P 版本同步 V1.0→V1.1;一线团队已接单(日均 2-3 单),启动数据沉淀 |
| V8.0 | 2026-08-20 | DT | 整体重构重启:① §人机协作模型表三 AI 新分工——听写 DT 负责其他全面(Gitee/文档发布/项目管理/设计/用户测试)、听码 WDE 只做编码(dip1/ 本地,不接触 Gitee)、听云 OCM 只做生产部署/第三方集成/客服(ocm/,原 ops/→ocm/);② 新增§双轨交付机制:Gitee hk2026-docs ⏸ 暂停使用(保留操作信息但不做任何操作),hk2026 仅作团队协作源代码仓库,听写 push hk2026 备份 + 听云从听写 scp/rsync 接收代码包,听云/听码与 Gitee 无关;③ 新增§日志体系:DTL(docs/工作日志/dtl/,L-YYYYMMDD-NN)、OCL(ocm/worklog/ocl/,L-YYYYMMDD-NN)、WDL(dip1/docs/worklog/wdl/,L-YYYYMMDD-NN),历史 DLG/OWLG/DWLG 保留为历史归档不删,强制要求每完成一个任务立即写日志不得用协作记录代替;④ §AI 行为规则第 3 条「记录」更新为 DTL/OCL/WDL 编号;⑤ §归档目录取消:原 docs/归档/ 已删除,版本快照通过 git tag/branch 管理,导航表 ARC 行标注「V8.0 已废止」;⑥ §文档导航 PJM 版本同步 V1.6→V3.0 + 说明新增"三AI新分工""git tag 快照";⑦ 修订记录追加 V8.0 整体重构重启条目 |
| V8.1 | 2026-08-22 | DT | 🔴 hk2026-docs 废除 + AI 特定行为三条(同步用户指令):① §AI特定行为:原 2 条(文档汇总/汇报)→ 3 条(新增 3.git 同步 = 仅推 Gitee hk2026 私有主仓 main 分支 + hk2026-docs 相关同步/构建/部署全部永久取消 + 仅用户指令触发);原第 4 条「公开文档同步」整项删除(用户指令要求)。② §双轨交付机制·仓库现状表:hk2026-docs 行从"⏸暂停使用(保留操作信息)"→ "🔴已废除/不再使用,所有相关Git和站点操作全部永久取消,scripts保留不执行"。③ §双轨交付机制·边界约束#1:原"禁止push/sync"→ 扩充为"禁止 push/sync/MkDocs 构建/Cloudflare Pages 部署/sync-docs-repo.ps1/deploy-site.ps1,所有该仓相关操作永久取消",并加挂 PJM §4.3.1 V3.2/§4.3.6/§4.3.7 废除说明锚点。④ 同步对齐 PJM V3.4 六大修改点。依据用户 2026-08-22 原话:「PJM 和 PMG 帮我调整:git同步和公开文档同步(AI特定行为),我需要暂停使用 hk2026-doc,请将与这个 git 仓库有关的操作都取消。」 |
| V8.2 | 2026-08-22 | DT | V8.1 纠偏(补充用户原话澄清:仅废除 Gitee hk2026-docs Git仓,Cloudflare Pages 文档公开发布仍需恢复保留):① §AI特定行为从3条→4条:第3条git同步改写为中性(仅hk2026 main备份);新增第4条「文档公开发布」= hk2026私有主仓本地MkDocs构建→deploy-site.ps1直传Cloudflare Pages(Project=hk2026,生产=https://hk2026.pages.dev),链路取消中间Gitee hk2026-docs仓。② §双轨交付机制·仓库现状表从2仓→3行(Gitee hk2026+Gitee hk2026-docs废除+Cloudflare Pages活跃):新增Cloudflare Pages行明确Project=hk2026、新域名、deploy参数迁移。③ §双轨交付路径Mermaid流程图新增「AI特定行为#4 文档公开发布」分支(听写→MkDocs构建→wrangler直传Pages)。④ §边界约束#1重写:仅废除Gitee hk2026-docs仓相关Git操作(clone/push/sync/checkout/sync-docs-repo.ps1);deploy-site.ps1 / build-site.py / mkdocs.yml继续使用但ProjectName参数改为hk2026。对齐PJM V3.5。依据用户原话澄清:「刚才修改的似乎过头了,我只是废除 gitee 的 hk2026-doc ,Cloudflare Pages 文档公开发布 这个AI特定行为 还是需要的,实际上,原来 hk2026 --> hk2026-doc --> Cloudflare Pages ,改为:hk2026 --> Cloudflare Pages(仍然是公开的)」。 |
本文件为 AI 协作入口(PMG DOC-A01 V8.0),项目管理制度见 PJM,业务需求见 RQD,服务设计见 QSV/CPT/MDS/OPS。