project-migrate

project-migrate 技能旨在帮助开发者和 AI 代理将现有的“棕地”项目平稳迁移至 AgenticDev 方法论。该工具不只是简单的文件搬运，而是利用 Gemini CLI 对 Markdown 文档进行深度语义分析。它能够解析文档的上下文和意图，精准识别规格说明、研究记录和技术提案，并将它们映射到标准化的 AgenticDev 目录结构中。通过对内容的逻辑化分类和元数据填充，它能够构建一个高度可搜索且符合 AgenticDev 规范的文档环境。

• 自动发现并智能分类遗留文档，支持 docs/、wiki/ 及其他 Markdown 存储路径。

• 利用 Gemini AI 进行内容深度分析，自动归类文件类型，如规格书 (specs)、架构决策记录 (ADR) 和产品需求文档 (PRD)。

• 使用 git mv 命令确保 Git 历史记录的连续性，实现文档演变过程的完整溯源。

• 基于 LLM 的智能链接更新功能，能够理解文档上下文，有效修复因结构重组而失效的相对链接。

• 自动生成符合规范的 YAML frontmatter，补充标题、类型与摘要，极大提升文档的索引价值。

• 提供安全的第一保障，包括带有时间戳的完整备份机制及自动生成的 rollback.sh 脚本，确保操作过程数据零丢失。

• 提供三种操作模式：交互模式便于手动审核、模拟模式 (dry-run) 用于预览迁移计划、自动审批模式 (auto-approve) 适用于 CI/CD 流水线。

• 使用前需确保 Gemini CLI 已安装、完成授权并在系统路径下可调用。

• 建议在迁移流程结束后运行 doc-indexer 技能，以验证文档架构的合规性和目录索引完整性。

• 专为需要统一文档标准、提升技术资产可维护性的团队打造，助力处理分散的文档资源。

• 建议在执行迁移前保持 git 工作区整洁，并仔细查阅控制台输出的迁移方案，确保在任何异常情况下都能通过备份轻松回滚。