task-folder-migrator

Task Folder Migrator 是专为 drupal-dev-framework 设计的工具，协助开发者将旧版 v2.x 单文件任务文档迁移至现代化的 v3.0.0 文件夹结构。对于维护中的 Drupal 项目，此工具能确保任务内容在需求扩张时依然条理分明。通过自动解析如“研究 (Research)”、“架构 (Architecture)”与“实施 (Implementation)”等 Markdown 标题，该技能能在保持数据完整性的同时，提升任务相关资料的检索效率。它会自动识别遗留的任务文件，建立对应的目录，并将内容拆解为 task.md、research.md、architecture.md 与 implementation.md，大幅降低手动整理的工作负载。

• 自动检测并迁移旧版 .md 任务文件至标准化的项目文件夹结构中。

• 支持双模式操作：可由 project-orchestrator 自动触发以实现无缝对接，或由用户通过手动模式进行确认与规划。

• 具备数据安全性，在重建目录前强制建立原始文件的 .bak 备份。

• 具备智能内容解析能力，可根据 Markdown 约定提取目标、验收标准、相关任务与备注等区块。

• 与项目编排器（project-orchestrator）紧密整合，能动态识别并处理项目状态。

• 提升复杂开发周期的状态追踪能力，特别适合转换至分阶段编写流程的项目。

• 适用于管理 Drupal 模块、主题或多阶段实施项目的开发者。

• 需运行于 drupal-dev-framework 环境，以确保正确读取项目状态与路径。

• 针对空白区块、丢失内容或备份档冲突等边缘情况，提供健全的处理机制（例如通过时间戳命名）。

• 执行前请确认项目根目录或目标路径的可写权限，以防路径解析失败。

• 迁移完成后请检视产出的迁移报告，确认所有任务皆已成功转换为新架构并可正确链接。