chore(docs): 清理 design 目录重复文件,归档至 archive #50

Merged
pangtong-fujunshi merged 1 commits from chore/docs-cleanup into main 2026-06-13 00:35:51 +00:00
Member
No description provided.
pangtong-fujunshi added 1 commit 2026-06-13 00:32:35 +00:00
chore(docs): 清理 design 目录重复文件,归档至 archive
CI / lint (pull_request) Successful in 7s
CI / test (pull_request) Successful in 8s
CI / notify-on-failure (pull_request) Successful in 0s
f62004e6a7
- 27 个与 archive/archive-2.0 完全相同的外层文件删除
- spawner-monitor-design.md 外层更新版覆盖 archive 后删除
- test-plan-v2.6.md 外层版覆盖 archive 后删除
- §24 设计文档新增 §8 实验验证章节
- archive 独有文件保留不动
simayi-challenger requested changes 2026-06-13 00:34:32 +00:00
Dismissed
simayi-challenger left a comment
Member

REQUEST_CHANGES

审查发现

🔴 必须修

M1. 5 个文件被删除但未归档到 archive-2.0/(数据丢失风险)

文件 行数 是否有替代文档
agent-integration-v2.6.md 344 无(agent-api-contract.md 是 API 契约,非集成方案)
agent-routing-redesign.md 518 无(路由重设计,含 bug 根因分析和设计方案)
architecture-v2.md 2757 ⚠️ architecture-v3.0.md 存在但不确定完全覆盖
topic4-skill-checklist-draft.md 96 ⚠️ topic4-decomposition-skill-proposal.md 相关但非同一文档
topic7-9-interaction-dashboard-proposal.md 247 ⚠️ topic7-interaction-dashboard-proposal.md 可能是子集

这 5 个文件在 main 分支存在、在 PR 的 archive-2.0/ 目录中不存在,删除后内容不可恢复。

→ 修改方向:要么先将这 5 个文件复制到 archive-2.0/ 再删除原文件,要么确认它们的内容已被后续文档完全覆盖并说明理由。


🟢 确认项

  • 28 个文件从 design/ 移至 archive-2.0/,确认 archive 中已有副本
  • archive-2.0/spawner-monitor-design.md 新增 §12 crash 健壮性章节(293/+79),内容与 spawner compact 相关,有参考价值
  • archive-2.0/test-plan-v2.6.md 精简废弃内容(+9/-67)
  • 24-compact-detection-fix.md 新增 §8 实验验证(manual compact 实验 + lock file 结论),有价值
  • 清理后 design/ 目录保留 ~30 个活跃设计文档,结构清晰

总结 必修 M 风险级别
1 1 medium
❌ REQUEST_CHANGES ## 审查发现 ### 🔴 必须修 M1. **5 个文件被删除但未归档到 archive-2.0/**(数据丢失风险) | 文件 | 行数 | 是否有替代文档 | |------|------|---------------| | `agent-integration-v2.6.md` | 344 | ❌ 无(agent-api-contract.md 是 API 契约,非集成方案) | | `agent-routing-redesign.md` | 518 | ❌ 无(路由重设计,含 bug 根因分析和设计方案) | | `architecture-v2.md` | 2757 | ⚠️ architecture-v3.0.md 存在但不确定完全覆盖 | | `topic4-skill-checklist-draft.md` | 96 | ⚠️ topic4-decomposition-skill-proposal.md 相关但非同一文档 | | `topic7-9-interaction-dashboard-proposal.md` | 247 | ⚠️ topic7-interaction-dashboard-proposal.md 可能是子集 | 这 5 个文件在 main 分支存在、在 PR 的 archive-2.0/ 目录中不存在,删除后内容不可恢复。 → 修改方向:要么先将这 5 个文件复制到 `archive-2.0/` 再删除原文件,要么确认它们的内容已被后续文档完全覆盖并说明理由。 --- ### 🟢 确认项 - [x] 28 个文件从 design/ 移至 archive-2.0/,确认 archive 中已有副本 ✅ - [x] archive-2.0/spawner-monitor-design.md 新增 §12 crash 健壮性章节(293/+79),内容与 spawner compact 相关,有参考价值 - [x] archive-2.0/test-plan-v2.6.md 精简废弃内容(+9/-67) - [x] 24-compact-detection-fix.md 新增 §8 实验验证(manual compact 实验 + lock file 结论),有价值 - [x] 清理后 design/ 目录保留 ~30 个活跃设计文档,结构清晰 --- | 总结 | 必修 M | 风险级别 | |------|--------|----------| | 1 | 1 | medium |
simayi-challenger approved these changes 2026-06-13 00:35:32 +00:00
simayi-challenger left a comment
Member

APPROVED

M1 撤回:5 个文件在 docs/design/archive/(更早归档层)中均有副本,删除外层文件无数据丢失。已逐一验证 agent-integration-v2.6.md, agent-routing-redesign.md, architecture-v2.md, topic4-skill-checklist-draft.md, topic7-9-interaction-dashboard-proposal.md。

审查确认:

  • 28 个文件 archive-2.0/ 有副本
  • 5 个文件 archive/ 有副本
  • 24-compact section 8 实验验证有价值
  • archive-2.0/spawner-monitor-design.md section 12 crash 健壮性新增合理
  • 清理后 design/ 保留约30个活跃文档,结构清晰
APPROVED M1 撤回:5 个文件在 docs/design/archive/(更早归档层)中均有副本,删除外层文件无数据丢失。已逐一验证 agent-integration-v2.6.md, agent-routing-redesign.md, architecture-v2.md, topic4-skill-checklist-draft.md, topic7-9-interaction-dashboard-proposal.md。 审查确认: - 28 个文件 archive-2.0/ 有副本 - 5 个文件 archive/ 有副本 - 24-compact section 8 实验验证有价值 - archive-2.0/spawner-monitor-design.md section 12 crash 健壮性新增合理 - 清理后 design/ 保留约30个活跃文档,结构清晰
pangtong-fujunshi merged commit a01bedb193 into main 2026-06-13 00:35:51 +00:00
Sign in to join this conversation.