diff --git a/docs/task/3-dev_scripts目录重命名.md b/docs/task/3-dev_scripts目录重命名.md new file mode 100644 index 0000000..40e2a75 --- /dev/null +++ b/docs/task/3-dev_scripts目录重命名.md @@ -0,0 +1,72 @@ + +generated: true (请先修改 Gitea Wiki,禁止直接编辑本文件) +wiki_page: Task-3-Dev-Scripts-Rename +wiki_url: http://ilaer.eicp.net:8418/opc/dev_harness/wiki/Task-3-Dev-Scripts-Rename.- +wiki_revision: 5e961648835c5d8ba73d2cb515d335294e480ba2 +synchronized_at: 2026-08-08T01:21:04Z + + +# 3 将 DevHarness 工具目录重命名为 dev_scripts + +- 类型:重构 +- 所属 Epic:无 +- 所属 MVP / 版本:无 +- 状态:待验收 +- 日期:2026-08-08 +- Gitea 工单:[opc/dev_harness#3](http://ilaer.eicp.net:8418/opc/dev_harness/issues/3) +- Wiki 页面:Task-3-Dev-Scripts-Rename +- Wiki revision:见本地镜像头 + +## 背景与目标 + +DevHarness 自身工具原来放在根目录 `scripts/`,容易和后续业务项目的脚本混淆。本任务把 Harness 检查、Wiki 同步和任务归档工具统一迁移到 `dev_scripts/`,不保留旧路径兼容入口。 + +## 最终方案 + +- `scripts/check_harness.py` → `dev_scripts/check_harness.py`。 +- `scripts/wiki_docs.py` → `dev_scripts/wiki_docs.py`。 +- `scripts/sync_wiki_docs.py` → `dev_scripts/sync_wiki_docs.py`。 +- `scripts/new_task_archive.py` → `dev_scripts/new_task_archive.py`。 +- 更新测试导入路径、必需文件检查、AGENTS、README 和稳定 Wiki 页面。 +- Wiki 先修改并读取确认,再导出本地镜像。 +- 历史任务 #1、#2 保留旧路径,避免改写历史事实。 +- 旧 `scripts/` 目录不保留包装器,未来业务脚本必须与 `dev_scripts/` 分开。 + +## 修改文件 + +- `scripts/**` → `dev_scripts/**`:整体目录重命名。 +- `dev_scripts/check_harness.py`:必需工具路径改为新目录。 +- `tests/test_wiki_docs.py`、`tests/test_harness_docs.py`:导入新目录。 +- `AGENTS.md`:更新同步、归档命令和目录边界。 +- `README.md`:更新快速开始和目录说明。 +- `docs/README.md`、项目档案、工作流、代码地图、开发验证、常见修改和新项目初始化:线上 Wiki 的更新镜像。 + +## 验收结果 + +| 验收标准 | 结果 | +|---|---| +| 四个工具位于 dev_scripts,旧目录不存在 | 通过 | +| 新命令可运行且不保留旧兼容入口 | 通过 | +| 测试导入和必需文件检查使用新路径 | 通过 | +| 稳定 Wiki 与本地镜像使用新路径 | 通过 | +| 非历史内容没有旧路径引用 | 通过 | +| 测试、严格检查、同步和编译通过 | 通过 | + +## 测试 + +- 执行命令:`python -m unittest discover -s tests -v` +- 结果:16/16 通过。 +- 执行命令:`python dev_scripts/check_harness.py --strict` +- 结果:通过。 +- 执行命令:`python dev_scripts/sync_wiki_docs.py --check` +- 结果:12/12 映射一致。 +- 执行命令:`python -m compileall -q dev_scripts tests` +- 结果:通过。 +- 执行命令:旧目录和非历史旧路径搜索。 +- 结果:旧目录不存在;非历史旧路径无残留。 +- **未验证部分**:仓库外部未纳入版本管理的自动化如果仍使用旧命令,需要使用方自行更新。 + +## 相关提交 + +- `1c99867` refactor: 将 Harness 工具移至 dev_scripts (#3) +- `51278fa` docs: 修正 dev_scripts 编译检查命令 (#3) diff --git a/wiki-docs.json b/wiki-docs.json index 470f975..d55b07b 100644 --- a/wiki-docs.json +++ b/wiki-docs.json @@ -51,6 +51,10 @@ { "page": "Task-2-Junior-Maintainer-Docs", "path": "docs/task/2-初级维护者文档体系.md" + }, + { + "page": "Task-3-Dev-Scripts-Rename", + "path": "docs/task/3-dev_scripts目录重命名.md" } ] }