跳转至

P1 内容迁移阶段执行任务表 · v1.0

本文是 migration-plan-2026Q2.md §4 P1 章节的可执行级补充。 migration-plan 给出"应该做什么",本文给出"具体怎么做、每文件检查到哪一步、redirect 怎么写"。

执行主体:文档管理员智能体(P1.2 ~ P1.4)+ Cline 已完成 P1.1 示范(D0-company/00-vision/ → 01-strategy/00-vision/ 6 文件)。 配合方:各部门作者负责本部门文档的内容审阅。

1. P1 阶段总览

1.1 范围与文件量

子任务 源 目标 文件量 工期 状态
P1.1a 示范 docs/D0-company/00-vision/ docs/01-strategy/00-vision/ 6 0.5 d ✅ Cline 已完成
P1.1b 完整 docs/D0-company/{01-brand,02-policy,03-finance,04-pr-market}/ docs/01-strategy/{01-brand,02-policies,03-finance,04-roadmap}/ 14 1 w 🟡 待智能体
P1.1c 拆出 docs/D0-company/05-standards/ docs/05-standards/(独立一级) 22 0.5 w 🟡 待智能体
P1.2 docs/external/ docs/06-customer/ 33 0.5 w 🟡 待智能体
P1.3 docs/D3-execution/(若存在,实际为 D3-architecture 的子集) docs/07-engineering/ 2-37 0.5 w 🟡 待智能体
P1.4 docs/D6-testing-ops/ docs/04-departments/test/ 1 0.5 d 🟡 待智能体
总计 ≈ 78-113 3 w

注:D3 在 migration-plan §4 中标为 "D3-execution / 2 文件",但物理目录扫描显示 D3-architecture/ 含 37 篇。智能体执行 P1.3 前需要重新跨 §4.2 与 §5.2(P2.2)分流判定 — 跨产品稳态部分留 P2.2 处理,只有真·全局工程过程文档(如 release-process.md)在 P1.3 迁移。

1.2 P1 验收标准(继承自 migration-plan §4.3)

  • 01-strategy / 05-standards / 06-customer / 07-engineering 物理结构完整
  • 所有迁移文件 frontmatter 含 legacy_doc_id
  • 新文档 frontmatter 9 字段全部到位(本文 §3)
  • python -m mkdocs build --clean 0 ERROR
  • warning 数 ≤ 104(P0 完成时基线,允许等于不允许大于)
  • 9 视觉组件至少在 4 个新一级目录的某 1 篇文档中实际使用(P1.1c 已含 format-showcase.md)
  • mkdocs.yml: nav 二级条目已更新到 IA v3 路径

1.3 P1 红线(继承自 agent-handoff-spec §9)

  • ❌ R1-R12 全部硬约束(违反即 PR 拒绝)
  • ❌ 不允许 git rm — 旧文件只能改 status: deprecated 留原位 + 加顶部 redirect 提示横幅
  • ❌ 不允许跳过 frontmatter 字段升级 — 必须按 §3 升级表逐字段升级
  • ❌ 不允许只做迁移不配 redirect — 每个迁移必须在 mkdocs.yml plugins.redirects.redirect_maps 中加一条

2. 旧 → 新目录映射总表

基本原则:数字段稳态(目录前缀不变)+ 类型重组(子文件按 IA v3 + folder-structure-spec §3 调整)

2.1 D0-company → 01-strategy + 05-standards 拆分

旧路径 新路径 说明
docs/D0-company/00-vision/ docs/01-strategy/00-vision/ 公司愿景 / 战略白皮书 / Roadmap / 产品矩阵
docs/D0-company/01-brand/ docs/01-strategy/01-brand/ 品牌手册 / VI 体系
docs/D0-company/02-policy/ docs/01-strategy/02-policies/ 公司制度 / 劳动合同 / NDA / 期权
docs/D0-company/03-finance/ docs/01-strategy/03-finance/ 商业计划 / 财务模型 / Pitch Deck
docs/D0-company/04-pr-market/ docs/01-strategy/04-pr-market/ 公关与市场(P1.1b 暂用 04-pr-market,P2 可改名 04-roadmap)
docs/D0-company/05-standards/ docs/05-standards/ 拆出独立一级目录(P1.1c)

2.2 external → 06-customer

旧路径 新路径 说明
docs/external/overview/ docs/06-customer/overview/ 客户专区总览
docs/external/case-studies/ docs/06-customer/case-studies/ 案例研究
docs/external/partner/ docs/06-customer/partner/ 合作伙伴专区
docs/external/support/ docs/06-customer/support/ 技术支持 / FAQ

2.3 D6-testing-ops → 04-departments/test

旧路径 新路径 说明
docs/D6-testing-ops/*.md docs/04-departments/test/*.md 测试运维相关文档(P1.4 只迁这 1 篇,D1-divisions 49 篇留 P2.3)

2.4 D3-execution(或其等价路径)→ 07-engineering

旧路径候选 新路径 说明
docs/D3-execution/ 或 docs/D3-architecture/ 中含 release-process.md 等真·全局工程过程文档 docs/07-engineering/ P1.3 只迁 2 篇核心,其余 D3 留 P2.2

2.5 P2 阶段才动的目录(P1 不动)

目录 文件量 P2 阶段任务
docs/D1-divisions/ 47 P2.3 整体迁到 04-departments/
docs/D2-products/ 152 P2.1 按 13 稳态结构重组到 02-products/
docs/D3-architecture/ 37 P2.2 跨产品部分到 03-platform/,产品特定到 02-products/
docs/D4-implementation/ 未知 P2.1 内并入对应产品的 _dev/phases/
docs/00-spec/ 6 P3.1 归档到 99-archive/2026-04-pre-ia-v3/old-spec/
docs/10-product-matrix/ 2 P3.1 内容并入 02-products/index.md
docs/20-doc-system/ 2 P3.1 内容并入 05-standards/
docs/_audit/ 1 P3.1 移到 99-archive/audit/

3. Frontmatter 字段升级表 ⭐

核心痛点:现有 D 系列 .md 的 frontmatter 字段与 [agent-handoff-spec §3.1 / md-writing-spec.md] 规范的 9 字段不完全对齐。本节给出精确升级规则。

3.1 现状字段(旧)

D 系列文件实际使用的字段(从 D0/D2 抽查归纳):

旧字段 类型 示例 是否保留
title str XiStudio 技术架构 v2.0 ✅ 保留
description str 产品概述、PRD、Spec、API、用户手册 ✅ 保留(可选,但推荐)
level str l1a / l1b / l2 / l3 ✅ 保留
hero_show bool true / false ✅ 保留
hero_label / hero_title / hero_sub / hero_meta / hero_tagline / hero_stats mixed (Hero 区配置) ✅ 保留(L1A/L1B 页面用)
category str spec / strat / product 🟡 改名 → tags(列表)
status str draft / published ✅ 保留
doc_id str D0-00-STRAT-001 ✅ 保留(但需加 legacy_doc_id)
version str v1.0 ✅ 保留
author str AlgoDepartment 🟡 改名 → owner
date str 2026-05-05 🟡 改名 → last_review

3.2 目标字段(新 · 来自 agent-handoff-spec §3.1)

---
doc_id: D2-P1-XISTUDIO-TECH-ARCH-001     # 必填 · 唯一标识(可保留旧 doc_id 数字)
title: XiStudio 技术架构 v2.0             # 必填 · 中文标题(原 title 直接搬)
description: ...                          # 可选 · 描述(原 description 直接搬)
status: published                         # 必填 · draft/review/published/deprecated
audience: internal                        # 必填 · 新增 · internal/external/agent
owner: AlgoDepartment                     # 必填 · 由原 author 改名
last_review: 2026-05-11                   # 必填 · 由原 date 改名(如已过 30 天则填迁移日)
version: v2.0                             # 必填 · 原 version 直接搬
tags:                                     # 必填 · 由原 category 升级为列表
  - product
  - xistudio
  - architecture
legacy_doc_id: D2-products/P1-xistudio/tech-arch.md   # 必填 · 迁移文档专属 · 原相对路径
level: l2                                 # 必填 · 原 level 直接搬
katex: false                              # 可选 · 含数学公式时设 true
hero_show: false                          # 可选 · 原 hero_show 直接搬
# hero_* 字段(若原文件有,全部保留)
---

3.3 字段映射对照表

旧字段 新字段 升级规则
title title 直接保留
description description 直接保留(可选字段)
level level 直接保留
hero_show hero_show 直接保留
hero_* hero_* 全部直接保留
category: spec tags: [spec] 字符串 → 单元素列表;"spec" / "strat" / "product" 等通常对应一个主 tag,可补充 2-3 个细分 tag(如 xistudio / architecture)
status: draft status: draft 直接保留(取值范围扩展为 draft/review/published/deprecated)
doc_id 已有 doc_id 直接保留;若旧 doc_id 含路径前缀(如 D2-products/...)建议升级为新格式(如 D2-P1-xistudio-tech-arch,详见 agent-handoff-spec §4)
doc_id 缺失 新增 doc_id: <自动生成> 用 <level-section-topic> 格式(如 D0-00-STRAT-VISION-MISSION)
version version 直接保留(若缺,默认 1.0.0)
author: AlgoDepartment owner: AlgoDepartment 改名;值不变
date: 2026-05-05 last_review: 2026-05-05 改名;若距今 > 30 天,改为迁移当日(2026-05-11)
(无) 新增 audience: internal 默认 internal;客户专区(06-customer/**)填 external;agent-handoff/format-showcase 类填 agent
(无) 新增 legacy_doc_id: <旧相对路径> 迁移文档必填 · 形如 D0-company/00-vision/strategy-whitepaper.md

3.4 升级示例(以 D0-company/00-vision/vision-mission.md 为例)

旧 frontmatter:

---
title: Xisound 公司愿景与使命
description: Xisound（羲音）公司愿景、使命、价值观、战略定位与文化基因
level: l1b
hero_show: true
hero_label: Vision & Mission · v1.0
hero_title: 以羲之名 · 重新定义汽车之声
hero_sub: Xisound 公司愿景、使命与核心价值观
hero_meta: 文档版本：v1.0 · 文档编号：D0-00-STRAT-001 · 发布日期：2026-05-05
hero_tagline: From Silicon to Sound
hero_stats:
  - num: "6"
    label: 产品层级
  - num: "13"
    label: 产品线
  - num: "3"
    label: 年战略周期
category: strat
status: published
doc_id: D0-00-STRAT-001
version: v1.0
author: Xisound CEO Office
date: 2026-05-05
---

新 frontmatter(升级后):

---
doc_id: D0-00-STRAT-001
title: Xisound 公司愿景与使命
description: Xisound（羲音）公司愿景、使命、价值观、战略定位与文化基因
status: published
audience: internal
owner: Xisound CEO Office
last_review: 2026-05-11
version: v1.0
tags:
  - strategy
  - vision
  - mission
legacy_doc_id: D0-company/00-vision/vision-mission.md
level: l1b
hero_show: true
hero_label: Vision & Mission · v1.0
hero_title: 以羲之名 · 重新定义汽车之声
hero_sub: Xisound 公司愿景、使命与核心价值观
hero_meta: 文档版本：v1.0 · 文档编号：D0-00-STRAT-001 · 发布日期：2026-05-05
hero_tagline: From Silicon to Sound
hero_stats:
  - num: "6"
    label: 产品层级
  - num: "13"
    label: 产品线
  - num: "3"
    label: 年战略周期
---

变更点: - category: strat → tags: [strategy, vision, mission](扩展为列表 + 补充细分 tag) - author: Xisound CEO Office → owner: Xisound CEO Office(改名) - date: 2026-05-05 → last_review: 2026-05-11(改名 + 时间更新) - 新增 audience: internal - 新增 legacy_doc_id: D0-company/00-vision/vision-mission.md(必填!)

4. Redirects 配置草案 ⭐

4.1 mkdocs.yml plugins.redirects.redirect_maps 模板

P1 阶段每完成一个文件的迁移,必须在 mkdocs.yml 的 plugins.redirects.redirect_maps: 中加一条映射。

当前 mkdocs.yml(line 159-160):

plugins:
  - redirects:
      redirect_maps: {}     # ← 空,P1 阶段开始填充

P1.1a 示范完成后应改为(6 条):

plugins:
  - redirects:
      redirect_maps:
        # ── P1.1a · D0-company/00-vision → 01-strategy/00-vision ──
        D0-company/00-vision/index.md: 01-strategy/00-vision/index.md
        D0-company/00-vision/vision-mission.md: 01-strategy/00-vision/vision-mission.md
        D0-company/00-vision/strategy-3y.md: 01-strategy/00-vision/strategy-3y.md
        D0-company/00-vision/strategy-whitepaper.md: 01-strategy/00-vision/strategy-whitepaper.md
        D0-company/00-vision/roadmap-3y.md: 01-strategy/00-vision/roadmap-3y.md
        D0-company/00-vision/product-matrix.md: 01-strategy/00-vision/product-matrix.md

4.2 P1 阶段完整 redirect_maps 预期(草案)

P1 全部完成后,redirect_maps 应至少含以下规则(估算 ≈ 78-113 条):

redirect_maps:
  # P1.1a · D0-company/00-vision → 01-strategy/00-vision  (6 条)
  D0-company/00-vision/index.md: 01-strategy/00-vision/index.md
  D0-company/00-vision/vision-mission.md: 01-strategy/00-vision/vision-mission.md
  # ... (4 more)

  # P1.1b · D0-company/{01-brand,02-policy,03-finance,04-pr-market} → 01-strategy/* (14 条)
  D0-company/01-brand/index.md: 01-strategy/01-brand/index.md
  D0-company/01-brand/brand-manual.md: 01-strategy/01-brand/brand-manual.md
  # ... (12 more)

  # P1.1c · D0-company/05-standards → 05-standards (拆出独立一级)  (22 条)
  D0-company/05-standards/index.md: 05-standards/index.md
  D0-company/05-standards/agent-handoff-spec.md: 05-standards/agent-handoff-spec.md
  D0-company/05-standards/format-showcase.md: 05-standards/format-showcase.md
  D0-company/05-standards/format-spec-changelog.md: 05-standards/format-spec-changelog.md
  D0-company/05-standards/brand-color-system.md: 05-standards/brand-color-system.md
  D0-company/05-standards/md-writing-spec.md: 05-standards/md-writing-spec.md
  D0-company/05-standards/nav-display-spec.md: 05-standards/nav-display-spec.md
  D0-company/05-standards/folder-structure-spec.md: 05-standards/folder-structure-spec.md
  D0-company/05-standards/migration-plan-2026Q2.md: 05-standards/migration-plan-2026Q2.md
  D0-company/05-standards/p1-migration-task-list.md: 05-standards/p1-migration-task-list.md
  # ... (12 more)

  # P1.2 · external → 06-customer  (33 条)
  external/overview/index.md: 06-customer/overview/index.md
  # ... (32 more)

  # P1.3 · D3-execution → 07-engineering  (2 条)
  D3-execution/release-process.md: 07-engineering/release-process.md
  # ...

  # P1.4 · D6-testing-ops → 04-departments/test  (1 条)
  D6-testing-ops/test-strategy.md: 04-departments/test/test-strategy.md

4.3 配置 redirects 后的验证

cd AlgoDepartment/06_docs/site-build
python -m mkdocs build --clean
# 验证:0 ERROR · warning ≤ 104

# 浏览器测试:
python -m mkdocs serve --dev-addr 127.0.0.1:8767
# 1. 访问旧 URL: http://127.0.0.1:8767/D0-company/00-vision/vision-mission/
#    应自动 302 跳转到: http://127.0.0.1:8767/01-strategy/00-vision/vision-mission/
# 2. 访问新 URL: http://127.0.0.1:8767/01-strategy/00-vision/vision-mission/
#    应直接打开新位置内容

5. 旧文件 deprecated 处理(Q2=A 决策)

用户决策:旧文件留原位 + 改 status: deprecated(Q2=A 选择)。物理归档(移到 99-archive/)留 P3 阶段。

5.1 每个旧文件的处理流程

旧文件迁移到新位置后,不删除原文件,而是修改其 frontmatter + 顶部加 redirect 提示横幅:

---
doc_id: D0-00-STRAT-001                                    # 保留原 doc_id
title: Xisound 公司愿景与使命(已迁移)                        # 在标题后加"(已迁移)"
status: deprecated                                          # ⭐ 改为 deprecated
audience: internal
owner: Xisound CEO Office
last_review: 2026-05-11
version: v1.0
tags:
  - deprecated-d-series
  - migrated-to-01-strategy
legacy_doc_id: D0-company/00-vision/vision-mission.md       # 自指(让 main.html 横幅触发)
level: l3                                                   # 降级 level(deprecated 文档不需要 Hero)
hero_show: false
---

> ⚠️ **本文档已迁移**
>
> 新位置:[`docs/01-strategy/00-vision/vision-mission.md`](../../01-strategy/00-vision/vision-mission.md)
>
> 你被自动重定向到了旧位置;若 redirect 失效,请直接访问新位置链接。
> 旧位置内容保留作历史参考,**不再维护**。

---

(以下内容保持原样,不做修改)

说明:overrides/main.html line 74-81 已实现 deprecated 横幅渲染逻辑(基于 page.meta.status == 'deprecated'),所以只要 frontmatter 改对,横幅会自动出现。本文 §5.1 的 blockquote 提示是补充说明,可以让用户即使在 redirect 失效时也能手动点击新链接。

5.2 自动化脚本建议(P1.1b 之后批量执行)

智能体可写一个 scripts/deprecate-old-files.ps1 批量处理:

# 用法: pwsh -File scripts/deprecate-old-files.ps1 -OldDir docs/D0-company/00-vision/ -NewDirRel ../../01-strategy/00-vision/

param(
  [string]$OldDir,
  [string]$NewDirRel
)

Get-ChildItem -Path $OldDir -Filter '*.md' | ForEach-Object {
  $f = $_.FullName
  $content = Get-Content $f -Raw

  # 1. 把 status: published / status: draft 替换为 status: deprecated
  $content = $content -replace 'status:\s*(published|draft|review)', 'status: deprecated'

  # 2. 在第一个 H1 之后插入 redirect 横幅(若尚未存在)
  if ($content -notmatch '⚠️\s*\*\*本文档已迁移\*\*') {
    $bannerLine = "`n> ⚠️ **本文档已迁移**`n>`n> 新位置:[" + $_.Name + "](" + $NewDirRel + $_.Name + ")`n>`n> 旧位置内容保留作历史参考,**不再维护**。`n`n---`n"
    # 在 frontmatter 结束后(第二个 ---)+ 第一个空行处插入
    $content = $content -replace '(?ms)(^---\s*$.*?^---\s*$)', "`$1$bannerLine"
  }

  Set-Content -Path $f -Value $content -Encoding utf8
  Write-Host "  ✓ deprecated: $($_.Name)"
}

6. P1.1a 示范迁移操作流程(Cline 已执行,作为模板)

6.1 步骤序列

用户决策 Q1=A:先写本任务表 → 然后做 P1.1a 6 文件示范。

flowchart TD
  A[Step 1 · 创建目标目录<br>docs/01-strategy/00-vision/] --> B[Step 2 · 复制 6 文件到新位置<br>用 Copy-Item / cp]
  B --> C[Step 3 · 升级新位置 6 文件 frontmatter<br>按 §3.4 模板]
  C --> D[Step 4 · 旧位置 6 文件改 status: deprecated<br>+ 加 redirect 横幅]
  D --> E[Step 5 · mkdocs.yml 加 6 条 redirect_maps<br>§4.1 模板]
  E --> F[Step 6 · mkdocs build --clean<br>验证 0 ERROR + warning ≤ 104]
  F --> G[Step 7 · mkdocs serve + 浏览器抓 HTML<br>验证旧 URL 跳转 + 新 URL 内容正确]
  G --> H{全部通过?}
  H -->|是| I[Step 8 · git commit + 总结报告]
  H -->|否| J[回滚到 Step 6 前 + 修复]

6.2 单文件迁移 checklist(智能体逐文件填)

P1.1a 6 个文件清单:

# 旧路径 新路径 doc_id tags last_review
1 D0-company/00-vision/index.md 01-strategy/00-vision/index.md D0-00-VISION-INDEX-001 [strategy, vision, index] 2026-05-11
2 D0-company/00-vision/vision-mission.md 01-strategy/00-vision/vision-mission.md D0-00-STRAT-001 [strategy, vision, mission] 2026-05-11
3 D0-company/00-vision/strategy-3y.md 01-strategy/00-vision/strategy-3y.md D0-00-STRAT-3Y-001 [strategy, 3-year-plan] 2026-05-11
4 D0-company/00-vision/strategy-whitepaper.md 01-strategy/00-vision/strategy-whitepaper.md D0-00-STRAT-WP-001 [strategy, whitepaper] 2026-05-11
5 D0-company/00-vision/roadmap-3y.md 01-strategy/00-vision/roadmap-3y.md D0-00-ROADMAP-3Y-001 [strategy, roadmap] 2026-05-11
6 D0-company/00-vision/product-matrix.md 01-strategy/00-vision/product-matrix.md D0-00-PRODUCT-MATRIX-001 [strategy, product-matrix] 2026-05-11

6.3 单文件 PR 自查清单(智能体每文件填一遍)

### 文件 N · <旧路径> → <新路径>
- [ ] 新位置文件已创建(`docs/01-strategy/00-vision/<filename>`)
- [ ] 新位置 frontmatter 9 字段全部到位(doc_id / title / status / audience / owner / last_review / version / tags / level)
- [ ] 新位置 frontmatter 含 `legacy_doc_id: D0-company/00-vision/<filename>`
- [ ] 新位置正文与旧位置 100% 一致(可用 diff 验证)
- [ ] 旧位置文件 status 改为 `deprecated`
- [ ] 旧位置文件顶部加 redirect 提示横幅(blockquote)
- [ ] mkdocs.yml redirect_maps 加一条 `<旧>: <新>`
- [ ] `python -m mkdocs build --clean` 0 ERROR + warning ≤ 104
- [ ] 浏览器访问旧 URL 自动 302 到新 URL
- [ ] 浏览器访问新 URL 内容显示正常

7. P1.1b ~ P1.4 智能体接力清单

P1.1a 由 Cline 完成后,以下子任务交给智能体接力:

7.1 P1.1b · D0-company/{01-brand,02-policy,03-finance,04-pr-market} 迁移(14 文件)

docs/D0-company/01-brand/index.md            → docs/01-strategy/01-brand/index.md
docs/D0-company/01-brand/brand-manual.md     → docs/01-strategy/01-brand/brand-manual.md
docs/D0-company/02-policy/index.md           → docs/01-strategy/02-policies/index.md
docs/D0-company/02-policy/employee-handbook.md → docs/01-strategy/02-policies/employee-handbook.md
docs/D0-company/02-policy/labor-contract-template.md → docs/01-strategy/02-policies/labor-contract-template.md
docs/D0-company/02-policy/nda-template.md    → docs/01-strategy/02-policies/nda-template.md
docs/D0-company/02-policy/compensation-equity.md → docs/01-strategy/02-policies/compensation-equity.md
docs/D0-company/02-policy/org-chart.md       → docs/01-strategy/02-policies/org-chart.md
docs/D0-company/03-finance/index.md          → docs/01-strategy/03-finance/index.md
docs/D0-company/03-finance/business-plan.md  → docs/01-strategy/03-finance/business-plan.md
docs/D0-company/03-finance/company-charter.md → docs/01-strategy/03-finance/company-charter.md
docs/D0-company/03-finance/financial-model.md → docs/01-strategy/03-finance/financial-model.md
docs/D0-company/03-finance/pitch-deck.md     → docs/01-strategy/03-finance/pitch-deck.md
docs/D0-company/04-pr-market/index.md        → docs/01-strategy/04-pr-market/index.md

7.2 P1.1c · D0-company/05-standards 拆出独立一级(22 文件)

特殊处理:Cline 已经在 docs/05-standards/ 创建了占位 index.md。P1.1c 智能体的任务是把 D0-company/05-standards/ 下 22 篇规范文档全部复制到 docs/05-standards/(覆盖占位 index.md),然后旧位置改 deprecated。

Cline 新建的两份(agent-handoff-spec / format-showcase / p1-migration-task-list)位于 D0-company/05-standards/,P1.1c 时也一并迁出。

清单:agent-handoff-spec.md / brand-color-system.md / checklist.md / doc-code-sync-policy.md / doc-numbering.md / folder-structure-spec.md / format-demo/(子目录 7 文件) / format-showcase.md / format-spec-changelog.md / md-writing-spec.md / migration-plan-2026Q2.md / nav-display-spec.md / p1-migration-task-list.md / release-to-other-depts.md / todo-list.md / index.md

7.3 P1.2 · external → 06-customer(33 文件)

操作类同 P1.1。external 有 33 个文件,4 个二级子目录(overview / case-studies / partner / support)。 注意:P1.2 文件 audience 字段必须填 external(默认 internal 不适用)。

7.4 P1.3 · D3-execution → 07-engineering(2 文件)

需要先核查 docs/D3-execution/ 是否真实存在,或是否为 docs/D3-architecture/ 的子集。 仅迁全局工程过程文档(release-process.md / 类似的)。

7.5 P1.4 · D6-testing-ops → 04-departments/test(1 文件)

最简单的一个子任务,1 个文件。

8. 修订记录

版本 日期 修订人 改动
1.0.0 2026-05-11 Cline / AlgoDepartment Doc Council 首版 · P1 启动准备 · 含 frontmatter 升级表 + redirect_maps 草案 + P1.1a 示范模板 + P1.1b-P1.4 智能体接力清单

下一步给智能体:

  1. 通读 agent-handoff-spec.md 全文(必读 6 份规范的总入口)
  2. 通读本文 §3 frontmatter 升级表 + §4 redirects 配置 + §5 deprecated 处理
  3. 按 §7 清单接力执行 P1.1b ~ P1.4
  4. 每完成一个文件,填 §6.3 单文件 PR 自查清单
  5. 每完成一个子任务(P1.1b/P1.1c/P1.2/P1.3/P1.4),跑一次 python -m mkdocs build --clean 验证 0 ERROR + warning ≤ 104
  6. P1 全部完成后,提一份 docs/05-standards/p1-completion-report.md 总结报告