SuperAPI AI 工具集

project-migration

部署与运维

查看项目

更新于 10-16 00:01

技能介绍

用途:把已有项目迁移到主机原生工具链标准,目标状态参考 ~/Hermes-Shared/guitarizta/docs/dev-toolchain-architecture.md。与从零搭建的 project-setup 不同,本技能面向现有代码,强调非破坏性与交互式。

核心原则:不询问不得覆盖已有文件,需展示 diff;所有改动在 chore/migrate-project-setup 分支进行;意图不明时先问;不使用 devcontainer,若存在则计划移除。

工作流:

  1. 评估:确认项目类型(Python、Node.js 或混合),读取对应 blueprint,审计 .mise.toml、.python-version、pyproject.toml/uv.lock、package.json/pnpm-lock.yaml、packageManager 字段、.envrc、.envrc.local.example、apm.yml/apm.lock.yaml、.kiro/steering/、.devcontainer/、.gitignore,给出分组迁移计划并等待用户确认。
  2. 分支:先确认工作区干净,再 git checkout dev 或 main,创建 chore/migrate-project-setup。
  3. 执行:按类别逐项提交。mise 固定运行时版本;Python 用 uv 管理依赖;Node 固定 pnpm 版本并校验锁文件;direnv 配置环境变量,密钥放 .envrc.local;APM 创建 apm.yml 并运行 apm install;移除 .devcontainer/;清理 .gitignore。
  4. 验证:mise trust && mise install、uv sync、pnpm install、apm install --frozen、direnv allow,并运行项目自身构建/测试。
  5. 汇总:列出新增、修改、删除文件,分支名与下一步开 PR。

规则:不删除 .gitignore 条目只追加;不改源码只改基础设施与配置;devcontainer 的 .env 含真实密钥需标记且不得提交;每类完成后提交;Git 远程使用 SSH。若开发者纠正了本技能本应避免的行为,建议对该技能做具体修订。