数据库代理迁移

人工智能 社区

技能解读

当前原文的自动摘译,尚未人工审校。

一句话定义

dbs-agent-migration 解决的是 Agent 工作台的结构迁移,不是单一平台迁移。 它支持: Claude Code → Codex Codex → Claude Code Claude + Codex 双端统一

什么时候用

当用户出现这些信号时,路由到这里: 想把 Claude Code 项目迁到 Codex 想把 Codex 项目补回 Claude Code 想同时兼容 Claude Code 和 Codex 觉得自己的 Agent 工作台很乱,想统一整理

原则 1:迁移不是复制文件,也不是单向搬家

复制 CLAUDE.md 为 AGENTS.md,最多只解决了“先跑起来”。真正的迁移至少要解决: 项目级规则文件 skill 真源位置 bridge 命名规则 Claude / Codex 双端一致

原则 2:真源优先,bridge 从真源生成

skills/ 是理想真源目录 ~/.claude/skills/ 和 ~/.codex/skills/ 都只是 bridge 不要把长期逻辑维护在 bridge 里

原则 3:不能假设项目已经规范

这个 skill 必须适配 4 类项目: 已有 CLAUDE.md + AGENTS.md + skills/ 只有 CLAUDE.md 只有 AGENTS.md skill 散落在项目各处,根本没有 skills/

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
人工智能
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@dontbesilent2025 · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
即装即用
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
Phase 1:迁移审计

先检查: `CLAUDE.md` `AGENTS.md` `SOURCE_OF_TRUTH.md` 项目中是否存在 `skills/`

02
Phase 2:规则文件迁移

如果有 `CLAUDE.md`: 拆出平台无关规则 → 写入 `AGENTS.md` 保留 Claude 专属规则在 `CLAUDE.md` 删除过时、重复、宿主绑定太强的内容 如果没有 `CLAUDE.md`:

03
Phase 3:识别或建立 skill 真源

情况 A:已有 `skills/` 把 `skills/` 定为真源 排除历史版本、备份、示例、成品文档 情况 B:没有 `skills/` 进入候选发现模式:

04
Phase 4:统一命名与 frontmatter

一旦真源确定,就要统一: 顶层 frontmatter `name` `description` bridge 规范名

05
Phase 5:生成 Claude / Codex bridge

检查或建立: `tools/sync-claude-skills.js` `tools/sync-codex-skills.js` 稳定映射表,例如 `tools/skill-bridge-map.md` bridge 必须满足:

06
Phase 6:验证

至少验证: `AGENTS.md` 是否可独立工作 真源是否明确 frontmatter 是否补齐 bridge 是否能指回真源

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。