dev_harness/docs/task/3-dev_scripts目录重命名.md

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
• 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)