diff --git a/Task-16-DevHarness-%E5%90%8E%E7%BB%AD%E5%8D%87%E7%BA%A7%E4%B8%8E%E5%9F%BA%E7%BA%BF%E8%AE%B0%E5%BD%95.-.md b/Task-16-DevHarness-%E5%90%8E%E7%BB%AD%E5%8D%87%E7%BA%A7%E4%B8%8E%E5%9F%BA%E7%BA%BF%E8%AE%B0%E5%BD%95.-.md index 65167fd..4365944 100644 --- a/Task-16-DevHarness-%E5%90%8E%E7%BB%AD%E5%8D%87%E7%BA%A7%E4%B8%8E%E5%9F%BA%E7%BA%BF%E8%AE%B0%E5%BD%95.-.md +++ b/Task-16-DevHarness-%E5%90%8E%E7%BB%AD%E5%8D%87%E7%BA%A7%E4%B8%8E%E5%9F%BA%E7%BA%BF%E8%AE%B0%E5%BD%95.-.md @@ -1,42 +1,60 @@ # 16 DevHarness 后续升级与基线记录 -- 类型：需求 / 缺陷 / 重构 -- 所属 Epic：# -- 所属 MVP / 版本：# -- 状态：待验收 / 已完成 +- 类型：流程文档 +- 状态：待验收 - 日期：2026-08-16 - Gitea 工单：http://ilaer.eicp.net:8418/opc/dev_harness/issues/16 - Wiki 页面：Task-16-DevHarness-后续升级与基线记录 -- Wiki revision：见本地镜像头 +- 本地镜像：按 #14 规则不自动导出 ## 背景与目标 - +已有项目接入后，需要从明确的旧 DevHarness 基线安全升级到新基线，并保留目标项目自己的业务、安全和文档事实。每个采用 DevHarness 的业务项目必须记录来源仓库和当前基线完整提交哈希。 ## 最终方案 - +- Project-Profile 新增“DevHarness 来源与基线”，记录来源仓库、当前基线提交、接入或升级日期和项目适配说明。 +- 基线是 DevHarness 上游提交，不是业务项目自己的提交；禁止使用“最新版本”等动态描述。 +- Existing-Project-Adoption-Guide 新增“后续升级”，规定基线比较、差异分类、目标项目建单、最小合并、Wiki-first、验证和验收更新记录。 +- 来源不一致、基线不存在、目标提交不明确或项目规则冲突时停止并等待确认。 +- 不增加自动升级脚本，不复制 DevHarness 工单、任务归档或项目事实。 ## 修改文件 -- `<文件>`：<改动说明> +- `docs/00-project-profile.md`：来源与基线记录要求。 +- `docs/08-existing-project-adoption.md`：升级步骤、停止条件和可复制指令。 +- `dev_scripts/check_harness.py`：新增章节的严格结构检查。 +- `tests/test_harness_docs.py`：新增章节校验测试。 ## 验收结果 | 验收标准 | 结果 | |---|---| -| | 通过 / 未通过 | +| 接入指南包含“后续升级”及完整步骤 | 通过 | +| 每个业务项目必须记录来源仓库和完整基线提交 | 通过 | +| 明确差异分类、保护边界和停止条件 | 通过 | +| 未增加自动升级脚本或新流程框架 | 通过 | +| Wiki 与核心镜像一致 | 通过 | +| 严格检查和单元测试通过 | 通过 | +| 工单保持待验收 | 通过 | ## 测试 -- 执行命令：`<命令>` -- 结果： -- **未验证部分**： +- `python dev_scripts/check_harness.py --strict`：通过。 +- `python -m unittest discover -s tests -v`：34 项全部通过。 +- `python dev_scripts/sync_wiki_docs.py --check`：13 个核心页面全部一致。 +- 人工检查：可从旧基线定位比较范围，分类采用、改写、冲突和不采用项，并明确验收后确认新基线。 +- **未验证部分**：未在具体业务项目执行真实升级；本任务只定义和校验流程文档。 + +## Wiki 证据 + +- Project-Profile revision：`16456d6ed083197759d553b1033e3e5c8a6b8932` +- Existing-Project-Adoption-Guide revision：`2ef3d7cd26874f652e9bfab2a5c2f6c8273ab7ac` ## 遗留问题 - +无。 ## 相关提交 -- `<提交哈希>` <提交说明> +- `947a068` docs: add DevHarness upgrade baseline guidance (#16)