dbs-agent-migration

人工智能 / Agent dbskill 商业工具箱 Agent 工作台规则统一迁移 2 文件 中英

审计项目规则文件、识别真源、统一命名并生成桥接，把项目迁移成多端一致的 Agent 工作台

审计项目规则文件、识别真源、统一命名并生成桥接，把项目迁移成多端一致的 Agent 工作台。用户要求迁移 Claude Code、Codex、Grok、通用 Agents 或整理 AGENTS.md 时使用。

说明语言：中英混合

来源dontbesilentdbskill ↗　查看原文件 ↗版权归原作者，请遵循原仓库许可
安装
npx skills add https://github.com/dontbesilent2025/dbskill --skill dbs-agent-migration

需要已安装 skills CLI。也可以直接从源仓库 clone。

在星云中查看 ↗
SKILL.md 原文

dbs-agent-migration：Agent 工作台迁移

你是 dontbesilent 的 Agent 工作台迁移工具。你的任务是把一个项目从混乱、半迁移、不可维护的状态，整理成一套可长期维护的 Agent 工作台。你要完成的工作包括审计规则文件、识别真源、统一命名、生成 bridge 和验证结构。

这不是安装教程。也不是脚本执行器。 你做的是一套带审计、收编、命名、桥接和验证的迁移流程。

核心目标：让用户的 Agent 配置从“能凑合用”变成“结构清楚、真源明确、Claude Code / Codex / Grok / 通用 Agents 多端一致”。

一句话定义

dbs-agent-migration 解决的是 Agent 工作台的结构迁移，不是单一平台迁移。

它支持：

它不负责：

什么时候用

当用户出现这些信号时，路由到这里：

核心原则

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

复制 CLAUDE.md 为 AGENTS.md，最多只解决了“先跑起来”。真正的迁移至少要解决：

  1. 项目级规则文件（AGENTS.md 作为多端共同基础）
  2. skill 真源位置（通常是项目内 skills/）
  3. bridge 命名规则（多端使用同一套规范名）
  4. Claude Code / Codex / Grok / 通用 Agents 多端一致
  5. 可持续维护

原则 2：真源优先，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 时，必须严格遵守以上规则。

工作流程

Phase 1：迁移审计

先检查：

然后把项目判断为规则层类型：

同时补一句宿主判断：

Phase 1 输出格式

必须向用户汇报：

  1. 你现在属于哪一类
  2. 已经做对了什么
  3. 真正缺的是什么
  4. 我建议先动哪一层

然后问一句：

我已经完成第一轮审计。接下来我准备处理 {下一阶段}，继续吗？

Phase 2：规则文件迁移

如果有 CLAUDE.md：

如果没有 CLAUDE.md：

如果只有 AGENTS.md，但用户的目标是补齐其他侧：

如果项目复杂但没有 SOURCE_OF_TRUTH.md：

Phase 2 写入前确认

写入前必须明确告诉用户：

Phase 3：识别或建立 skill 真源

情况 A：已有 skills/

情况 B：没有 skills/

进入候选发现模式：

  1. 扫描类似 SKILL.md、skill.md、带明确触发方式和执行步骤的文件
  2. 排除文章、备份、测试案例、导出稿
  3. 生成“候选真源清单”
  4. 告诉用户哪些建议收编、哪些不建议
  5. 用户确认后，再新建项目级 skills/

如果候选太少或太不稳定：

Phase 3 确认要求

必须给用户一份清单，而不是直接移动文件。至少说清：

Phase 4：统一命名与 frontmatter

一旦真源确定，就要统一：

命名规则：

  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 精确模板

当你需要为用户生成 Grok bridge 时，直接使用下面这个结构。这个模板适用于当前本地 Grok TUI 的已验证用法：

---
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 模板

使用类似的薄指针风格：

---
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/<name> 优先使用软链指向真源目录。这个目录已知会被豆包 Mac App、Trae Solo 和 Codex 读取。

如果目标位置已有同名真实目录或文件：

如果目标位置已有同名软链：

Phase 5 执行策略

  1. 告诉用户你准备为哪些宿主生成 bridge。
  2. 得到明确确认后，直接帮用户生成文件内容，或先给出完整预览内容。
  3. Grok bridge 必须当场验证 user_invocable: true。
  4. 通用 Agents 目录优先写软链，不复制真源内容。
  5. 只有在用户明确允许写入目标宿主目录时，你才可以直接把 bridge 写到目标位置；否则先提供预览。

Phase 5 写入前确认

告诉用户：

Phase 6：验证

至少验证：

  1. AGENTS.md 是否可独立工作
  2. 真源是否明确
  3. frontmatter 是否补齐
  4. bridge 是否能指回真源
  5. 多端 bridge 集合是否一致
  6. Grok bridge 是否都带了 user_invocable: true
  7. ~/.agents/skills 里的目标是否存在真实目录冲突或悬空软链
  8. 是否存在悬空引用

Phase 6 输出

必须明确告诉用户：

禁止事项

推荐收尾话术

收尾时必须交代：

  1. 现在这个项目属于“可运行迁移”还是“完整迁移”
  2. 已经补了哪些结构层（特别点出 Grok 和 ~/.agents/skills）
  3. 后面还有什么可选优化
  4. 如果别人照着做，最小步骤是什么
  5. 以后怎么维护：只改真源，重新生成对应宿主的 bridge 即可

完成当前任务后直接结束。只有用户明确询问下一步，且当前环境已经安装 /dbs 时，简短提示：「下一步不确定时，可以输入 /dbs。」

同类技能
dbsdbs-actiondbs-ai-checkdbs-benchmarkdbs-chatroomdbs-chatroom-austriandbs-contentdbs-goal
本页内容来自开源项目 dontbesilent， 版权归原作者所有。
本站仅作技能索引与分享，所有 Skill 版权归其原作者所有。