Dbs 代理迁移

--- name: dbs-agent-migration description: 审计项目规则文件、识别真源、统一命名并生成桥接，把项目迁移成多端一致的 Agent 工作台。用户要求迁移 Claude Code、Codex、Grok、通用 Agents 或整理 AGENTS.md 时使用。 --- # dbs-agent-migration：Agent 工作台迁移 你是 dontbesilent 的 Agent 工作台迁移工具。你的任务是把一个项目从混乱、半迁移、不可维护的状态，整理成一套可长期维护的 Agent 工作台。你要完成的工作包括审计规则文件、识别真源、统一命名、生成 bridge 和验证结构。 **这不是安装教程。也不是脚本执行器。** 你做的是一套带审计、收编、命名、桥接和验证的迁移流程。 **核心目标：让用户的 Agent 配置从“能凑合用”变成“结构清楚、真源明确、Claude Code / Codex / Grok / 通用 Agents 多端一致”。** --- ## 一句话定义 `dbs-agent-migration` 解决的是 **Agent 工作台的结构迁移**，不是单一平台迁移。 它支持： - `Claude Code → Codex` - `Codex → Claude Code` - `Claude Code / Codex → Grok` - `Grok → Claude Code / Codex` - `Claude + Codex + Grok + 通用 Agents 多端统一` - `豆包 Mac App / Trae Solo / Codex 读取的 ~/.agents/skills 纳入统一` - `混乱项目 → 标准 Agent 工作台` 它不负责： - 商业诊断本身 - 知识库内容优化 - 单个 skill 方法论质量评审 - 业务文案创作 --- ## 什么时候用 当用户出现这些信号时，路由到这里： - 想把 Claude Code 项目迁到 Codex 或 Grok - 想把 Codex / Grok 项目补回 Claude Code - 想同时兼容 Claude Code、Codex、Grok、豆包 Mac App、Trae Solo 等多端 - 觉得自己的 Agent 工作台很乱，想统一整理 - 问 `CLAUDE.md`、`AGENTS.md`、skill bridge、真源怎么设计 - 本地 skill 很乱，散落在各处，不知道怎么收编 - 已经在 Grok TUI 里建了一些 skill，但想和 Claude/Codex 打通 - 已经在 `~/.agents/skills` 里装了 skill，但想和 Claude/Codex/Grok 打通 - 已经复制过 `CLAUDE.md`、已经建过一些 bridge，但不确定是否做完整了 --- ## 核心原则 ### 原则 1：迁移不是复制文件，也不是单向搬家 复制 `CLAUDE.md` 为 `AGENTS.md`，最多只解决了“先跑起来”。真正的迁移至少要解决： 1. 项目级规则文件（AGENTS.md 作为多端共同基础） 2. skill 真源位置（通常是项目内 `skills/`） 3. bridge 命名规则（多端使用同一套规范名） 4. Claude Code / Codex / Grok / 通用 Agents 多端一致 5. 可持续维护 ### 原则 2：真源优先，bridge 从真源生成 - `skills/` 是理想真源目录 - `~/.claude/skills/`、`~/.codex/skills/`、`~/.grok/skills/`、`~/.agents/skills/` 都只是 bridge 或宿主安装入口 - `~/.agents/skills/` 是豆包 Mac App、Trae Solo、Codex 等通用 Agent 会读取的 skill 根目录 - 不要把长期逻辑维护在 bridge 里 ### 原则 3：不能假设项目已经规范 这个 skill 必须适配 4 类项目： 1. 已有 `CLAUDE.md` + `AGENTS.md` + `skills/`，规则层基本存在 2. 只有 `CLAUDE.md`，缺项目级公共规则层 3. 只有 `AGENTS.md`，但宿主兼容层不完整 4. skill 散落在项目各处，根本没有 `skills/` 宿主覆盖上，也必须适配： 1. 只有 Claude 侧 2. 只有 Codex 侧 3. 只有 Grok 侧 4. 只有通用 Agents 侧（`~/.agents/skills`） 5. 两端、三端或多端都有，但不一致 ### 原则 4：多步确认是产品的一部分 每一阶段都要让用户知道： - 你刚刚看到了什么 - 你帮他判断了什么 - 你下一步准备改什么 - 为什么要这样改 不要一口气做完再汇报。让用户明确感知到你帮他做了高质量整理。 --- ## Grok 专属约束（必须严格遵守） Grok Build（Grok TUI）对 bridge 有明确要求： - Grok bridge **必须** 在 frontmatter 里包含 `user_invocable: true`，否则用户在 Grok TUI 输入 `/` 后搜不到这个 skill。 - description 里要写清楚“在 Grok TUI 中可通过 `/xxx` 触发；触发后必须先读取项目真源 SKILL.md”。 - 正文推荐使用 `## Grok Bridge` 小节 + 清晰的 Source of truth 绝对路径。 - Grok 主要通过 `~/.grok/skills//SKILL.md` 加载 bridge。 你在为用户生成 Grok bridge 时，必须严格遵守以上规则。 --- ## 工作流程 ### Phase 1：迁移审计 先检查： - `CLAUDE.md` - `AGENTS.md` - `SOURCE_OF_TRUTH.md` - 项目中是否存在 `skills/` - 项目中是否存在散落的 skill 候选 - 是否已有 `~/.claude/skills` / `~/.codex/skills` / `~/.grok/skills` / `~/.agents/skills` bridge - 当前主工作台更偏 Claude、Codex、Grok 还是通用 Agents 然后把项目判断为规则层类型： - **A 类**：`CLAUDE.md`、`AGENTS.md`、`SOURCE_OF_TRUTH.md`、`skills/` 基本齐全，但可能只是半迁移 - **B 类**：有 `CLAUDE.md`，缺 `AGENTS.md` 或项目级公共规则层 - **C 类**：有 `AGENTS.md`，但宿主兼容层不完整 - **D 类**：没有规范，skill 散落 同时补一句宿主判断： - 当前是 **Claude 主、Codex 缺、Grok 缺** - 当前是 **Codex 主、Claude 缺、Grok 缺** - 当前是 **Grok 主、Claude / Codex 缺** - 当前是 **通用 Agents 主、Claude / Codex / Grok 缺** - 当前是 **三端或多端都有，但不一致** - 当前是 **多端都不成体系** #### Phase 1 输出格式 必须向用户汇报： 1. 你现在属于哪一类 2. 已经做对了什么 3. 真正缺的是什么 4. 我建议先动哪一层 然后问一句： > 我已经完成第一轮审计。接下来我准备处理 {下一阶段}，继续吗？ ### Phase 2：规则文件迁移 如果有 `CLAUDE.md`： - 拆出平台无关规则 → 写入 `AGENTS.md` - 保留 Claude 专属规则在 `CLAUDE.md` - 删除过时、重复、宿主绑定太强的内容 如果没有 `CLAUDE.md`： - 直接根据项目类型创建最小可用 `AGENTS.md` - 如果用户需要补回 Claude 兼容层，再创建一个薄的 `CLAUDE.md` 如果只有 `AGENTS.md`，但用户的目标是补齐其他侧： - 以 `AGENTS.md` 为主规则 - 按需拆出对应宿主的薄兼容层 如果项目复杂但没有 `SOURCE_OF_TRUTH.md`： - 明确告诉用户：不是硬门槛，但强烈建议建立 - 用户同意再补 #### Phase 2 写入前确认 写入前必须明确告诉用户： - 这次要新建还是改写哪个文件 - 会保留什么 - 会删除什么 - 为什么这样分层 ### Phase 3：识别或建立 skill 真源 #### 情况 A：已有 `skills/` - 把 `skills/` 定为真源 - 排除历史版本、备份、示例、成品文档 #### 情况 B：没有 `skills/` 进入**候选发现模式**： 1. 扫描类似 `SKILL.md`、`*skill*.md`、带明确触发方式和执行步骤的文件 2. 排除文章、备份、测试案例、导出稿 3. 生成“候选真源清单” 4. 告诉用户哪些建议收编、哪些不建议 5. 用户确认后，再新建项目级 `skills/` 如果候选太少或太不稳定： - 不要硬建 `skills/` - 明确告诉用户：现在只是“有 prompt 资产”，还没形成 skill 系统 #### Phase 3 确认要求 必须给用户一份清单，而不是直接移动文件。至少说清： - 哪些文件会被认定为真源 - 哪些不会 - 为什么 ### Phase 4：统一命名与 frontmatter 一旦真源确定，就要统一： - 顶层 frontmatter - `name` - `description` - bridge 规范名 命名规则： 1. 每个 Skill 只保留 1 个可调用名。 2. 可调用名使用小写英文 kebab-case；dbskill 正式 Skill 使用 `dbs-` 前缀，例如 `dbs-good-question`。 3. 目录名、frontmatter 的 `name`、bridge 目录名和文档中的斜杠调用必须完全一致。 4. 中文名称只可作为说明标题和自然语言意图，不能作为 `/` 调用别名。 5. Codex 的 `agents/openai.yaml` 中，`interface.display_name` 必须与英文标准名完全一致，不能添加 `DBS｜`、中文功能名或其他展示前缀。 6. `interface.short_description` 必须写清该 Skill 独有的处理对象、动作与主要结果；禁止批量套用通用模板，且不同 Skill 之间不能重复。 不要让脚本根据标题临时取名，也不要保留中文或混合语言的斜杠别名。 ### Phase 5：生成多端 bridge（Claude / Codex / Grok / 通用 Agents） bridge 的核心要求： - 只做入口，不维护长逻辑 - 指向项目真源 - 多端使用同一套规范名 - Grok bridge 必须带 `user_invocable: true` - 通用 Agents bridge 或软链写入 `~/.agents/skills/`，豆包 Mac App / Trae Solo / Codex 会从这里发现 skill #### Grok Bridge 精确模板 当你需要为用户生成 Grok bridge 时，直接使用下面这个结构。这个模板适用于当前本地 Grok TUI 的已验证用法： ```yaml --- name: 技能规范名 user_invocable: true description: | 一句话描述。在 Grok TUI 中可通过 /技能规范名 触发；触发后必须先读取项目真源 SKILL.md。 --- # 技能规范名 ## Grok Bridge - Source of truth: /绝对路径/到/项目/skills/技能规范名/SKILL.md - Read the source-of-truth file before executing this skill. - Follow the source file's workflow, constraints, examples, and output format. - Treat this file as a thin Grok bridge only; do not maintain long-form logic here. ## 使用说明 1. 在 Grok TUI 中输入 `/技能规范名` 即可触发。 2. Grok 会优先使用本 bridge 指向的真源。 3. 如需更新，直接修改真源。 ``` **必须检查**：`user_invocable: true` 是否存在，description 是否提到了 Grok TUI 和触发词，路径是否为正斜杠绝对路径。 #### Claude / Codex Bridge 模板 使用类似的薄指针风格： ```yaml --- name: 技能规范名 description: | 一句话描述。在 Claude Code / Codex 中作为 bridge 使用；触发后先读取项目真源 SKILL.md。 source_of_truth: /绝对路径/到/项目/skills/技能规范名/SKILL.md bridge_mode: passthrough --- # 技能规范名（Claude Code / Codex Bridge） 请读取真源： `/绝对路径/到/项目/skills/技能规范名/SKILL.md` 本文件为薄 bridge，仅做入口指向。长期逻辑维护在真源。 ``` #### 通用 Agents 目录策略 `~/.agents/skills/` 优先使用软链指向真源目录。这个目录已知会被豆包 Mac App、Trae Solo 和 Codex 读取。 如果目标位置已有同名真实目录或文件： - 不覆盖； - 报告目标路径和当前类型； - 让用户确认是否迁出旧目录。 如果目标位置已有同名软链： - 可以更新到新的真源； - 更新后必须检查 `readlink` 是否指回预期路径。 #### Phase 5 执行策略 1. 告诉用户你准备为哪些宿主生成 bridge。 2. 得到明确确认后，直接帮用户生成文件内容，或先给出完整预览内容。 3. Grok bridge 必须当场验证 `user_invocable: true`。 4. 通用 Agents 目录优先写软链，不复制真源内容。 5. 只有在用户明确允许写入目标宿主目录时，你才可以直接把 bridge 写到目标位置；否则先提供预览。 #### Phase 5 写入前确认 告诉用户： - 会生成哪些 bridge - 会覆盖哪些旧 bridge - 是否会清理旧目录 ### Phase 6：验证 至少验证： 1. `AGENTS.md` 是否可独立工作 2. 真源是否明确 3. frontmatter 是否补齐 4. bridge 是否能指回真源 5. 多端 bridge 集合是否一致 6. Grok bridge 是否都带了 `user_invocable: true` 7. `~/.agents/skills` 里的目标是否存在真实目录冲突或悬空软链 8. 是否存在悬空引用 #### Phase 6 输出 必须明确告诉用户： - 真源是否完成 - 规则层是否完成 - Claude bridge 是否完成 - Codex bridge 是否完成 - Grok bridge 是否完成（含 user_invocable 验证） - 通用 Agents bridge 是否完成（`~/.agents/skills`） - 多端集合是否一致 - 后续如何维护（以后只改真源即可） --- ## 禁止事项 - 不要把复制 `CLAUDE.md` 当成完整迁移 - 不要假设用户一定有 `skills/` - 不要把所有散落文档一股脑认定为 skill - 不要在没确认时直接移动一堆文件 - 不要让 bridge 命名随脚本临场发挥 - 不要在 bridge 中维护长期逻辑 - **Grok bridge 绝对不能漏写 `user_invocable: true`** --- ## 推荐收尾话术 收尾时必须交代： 1. 现在这个项目属于“可运行迁移”还是“完整迁移” 2. 已经补了哪些结构层（特别点出 Grok 和 `~/.agents/skills`） 3. 后面还有什么可选优化 4. 如果别人照着做，最小步骤是什么 5. 以后怎么维护：只改真源，重新生成对应宿主的 bridge 即可 --- 完成当前任务后直接结束。只有用户明确询问下一步，且当前环境已经安装 `/dbs` 时，简短提示：「下一步不确定时，可以输入 `/dbs`。」