dbs-agent-migration
dbs-agent-migration · by 开源社区
此 Skill 是套件的一部分，安装方式和版本更新由完整套件统一管理。
资源介绍
审计项目规则文件、识别真源、统一命名并生成桥接，把项目迁移成多端一致的 Agent 工作台。用户要求迁移 Claude Code、Codex、Grok、通用 Agents 或整理 AGENTS.md 时使用。
你是 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/<name>/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/<name>`，豆包 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/<name>` 优先使用软链指向真源目录。这个目录已知会被豆包 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`。」
项目 README
保留原项目的图片、示例和完整说明。
dbskill
简体中文 | English | 日本語 | 한국어 | 繁體中文
面向创业者与内容创作者的中文 AI Skills 工具箱。把真实业务、内容与行动问题交给 Agent，获得清晰判断和可以立刻执行的下一步。
支持：豆包、WorkBuddy、Claude Code、Codex，以及其他支持 Skills 的 Agent。
dbskill 由 dontbesilent 创建。从 16,152 条公开推文中筛选、结构化出 4,176 个知识原子，并将其中的方法沉淀为 31 个可直接调用的 Skills。
v2.18.28 更新： /dbs-standard-answer 会先根据现有材料回答，只在关键事实影响结论时联网；简单问题不再自动展开理论地图和历史案例。
快速开始 · 安装 · 能力一览 · 公开推文集 · 完整使用手册 · 更新日志
dbskill 解决什么问题
你不需要先学会一套复杂的方法，也不需要知道该调用哪个工具。把当下的业务、材料、选择或卡点交给 /dbs，它会根据对话上下文选择当前适合的 Skill。
| 真实处境 | 你会得到 |
|---|---|
| 客户总说贵，不知道该改价格、产品还是客群 | 商业模式诊断、风险判断和验证动作 |
| 有一个选题，却做不出能被人看完的内容 | 内容方向、开头、标题与逐字稿优化 |
| 知道该做什么，却迟迟推不动 | 对行动卡点的分析和一条可开始的动作 |
| 反复面对同类选择，经验无法积累 | 可回填的决策记录、规律与阶段快照 |
| 文稿、选题、案例散落在多个文件夹 | 可持续维护的内容资产工程 |
| 本地资料很多，希望 Agent 能稳定查找和调用 | 基于文件夹的知识库导航、版本规则与使用入口 |
快速开始
安装完成后，直接在 Agent 中输入：
/dbs 我做少儿编程课，已经有 40 个付费学员，但续费率很低。
我需要判断问题出在产品、定价，还是我找错了客户。
/dbs 会读取当前对话信息，选择合适的分析路径。完成一轮后，继续补充新的事实或反馈，再输入 /dbs，它会判断当前该推进什么。
已经知道需求时，可以直接调用具体 Skill：
/dbs-diagnosis 我做面向宝妈的收纳咨询，客户总觉得贵。我该调整什么？
/dbs-content 我想讲“普通人别急着做个人 IP”，这个选题怎样做成内容？
/dbs-hook 这是我短视频前 20 秒的逐字稿，帮我优化开头：……
/dbs-benchmark 我想研究企业服务内容账号，应该找哪些对标？
/dbs-knowledge 帮我把这个文件夹变成知识库，以后我想直接从里面找资料。
能力一览
| 工作目标 | 主要入口 | 常见产出 |
|---|---|---|
| 判断生意、产品、定价与客户 | /dbs-diagnosis | 商业诊断、风险、验证方案 |
| 找对标并提炼可学习的部分 | /dbs-benchmark | 对标筛选与研究框架 |
| 先挖掘相关领域、作者和可信理论，再研究历史同构答案 | /dbs-standard-answer | 理论锚点、案例矩阵、条件性答案与失效边界 |
| 做选题、内容、标题与短视频 | /dbs-content、/dbs-hook、/dbs-xhs-title | 内容方向与可发布文案 |
| 发布前检查敏感词、导流、广告与受限内容 | /dbs-content-risk-check | 机器审核信号、内容实质问题与最小修改动作 |
| 检查文稿共鸣、逻辑与传播性 | /dbs-resonate、/dbs-script-flow、/dbs-spread | 修改意见与优先级 |
| 澄清概念、目标和问题 | /dbs-deconstruct、/dbs-goal、/dbs-good-question | 可验证的定义与行动目标 |
| 处理拖延、贪快和行动受阻 | /dbs-action、/dbs-slowisfast | 卡点分析与下一步动作 |
| 记录、复盘长期决策 | /dbs-decision、/dbs-save、/dbs-restore、/dbs-report | 本地决策档案与报告 |
| 建立和治理文件夹知识库 | /dbs-knowledge | 知识库导航、版本规则、健康检查与 SOT 分层瘦身 |
| 建立内容资产与多端 Agent 工作台 | /dbs-content-system、/dbs-agent-migration、/dbs-install-skill | 本地工程、主题地图与安装方案 |
| 审查本地 Skill 风险 | /dbs-skill-cleaner | 风险报告与确认后的隔离操作 |
完整的 31 个 Skill、适用时机、输入示例和动态导航方式，见 新手入门与 Skill 全目录。
安装
推荐：Claude Code、豆包、WorkBuddy、Codex 与其他支持 Skills 的 Agent
在终端执行：
npx -y skills add dontbesilent2025/dbskill -g --all
安装后回到 Agent，输入 /dbs 新手入门 即可开始。
Claude Code 插件市场
也可以通过 Claude Code 插件市场安装完整工具箱：
claude plugin marketplace add dontbesilent2025/dbskill
claude plugin install dbs@dontbesilent-skills
这个 dbs 插件包含 31 个正式业务 Skill 和 1 个 dbs-update 系统更新入口。Claude Code 会为插件 Skill 添加命名空间：主入口使用 /dbs:dbs，具体能力例如 /dbs:dbs-diagnosis。
只想安装一个能力时，可以在插件市场中选择对应插件，例如 claude plugin install dbs-diagnosis@dontbesilent-skills。
更新
已安装 dbskill 时，直接对当前 Agent 说：
更新 dbskill
它会同步官方 dbskill，不会修改你在 ~/.dbs/ 中的存档、报告和决策记录。版本变化见 GitHub Releases。
dbskill 怎样工作
真实任务
↓
/dbs 读取上下文并选择当前入口
↓
一个 Skill 完成诊断、产出或记录
↓
补充结果与反馈，再决定下一步
dbskill 的重点是推进眼前真实的任务。它会先处理当前最有价值的结点，再根据实际结果衔接后续工作。
知识库与本地记录
仓库公开了 4,176 条结构化知识原子、按 Skill 整理的方法论文档与高频概念词典。
- 想查看数据范围和字段，阅读 原子库说明。
- 想构建自己的 RAG，可使用
知识库/原子库/atoms.jsonl。 - 想了解各项方法，浏览 Skill 知识包。
- 想把自己的本地文件夹直接当作知识库，使用
/dbs-knowledge建立导航并持续查找、收录和调用资料。 - 想跨对话保留工作，使用
/dbs-save、/dbs-restore与/dbs-report。数据默认保存在用户本机的~/.dbs/。
公开推文集
公开推文集收录经过整理的 dontbesilent 推文原文，提供两种格式：
- Markdown 阅读版：适合搜索、复制和交给 AI 分析。
- PDF 阅读版：适合完整阅读和下载保存。
推文集与 Skills 安装包相互独立。执行 npx -y skills add dontbesilent2025/dbskill -g --all 时，安装的是 Skills，不会自动下载推文集。
共同贡献者
dbs-content-risk-check 的敏感词检查能力由以下共创者共同完善，他们的贡献不可替代：
作者与支持
作者：@dontbesilent · 小红书 · 抖音
如需加入付费答疑群，可扫码或打开 答疑群说明。
许可证
本项目采用 CC BY-NC 4.0 许可证。
- 个人使用、学习、研究与非商业项目可以直接使用。
- 公开发布衍生作品时，请注明来源。
- 商业用途需要单独授权，请联系作者。
如何使用
这个子 Skill 随“商业诊断dbskill”完整套件安装，不需要重复安装单独目录。
选择一种使用方式
使用 Codex、Claude Code 等 Agent 工具时选择“Agent 自动安装”；使用豆包、DeepSeek 等聊天产品时选择“聊天提示词版”。两种方式不需要同时操作。
Agent 自动安装
点击右侧“复制 Agent 自动安装指令”，粘贴并发送给 Agent。Agent 会读取仓库并完成安装，无需再手动执行 git clone。
聊天工具直接使用
点击右侧“复制聊天提示词”，粘贴到豆包、DeepSeek、Kimi 或通义千问中即可使用，不需要安装 Skill。
开始任务
安装完成或发送提示词后，直接描述你的写作任务，并用一个简单示例确认效果。
高级用户：查看手动安装方式（可选）
安装前准备
确认已准备好 Claude Code，并检查所需依赖。本资源不要求额外的 API Key。
获取并安装
在终端中执行下面的命令。请只从可信来源复制和运行命令。
git clone https://github.com/dontbesilent2025/dbskill.git添加配置
打开 Claude Code 的设置页，将资源加入对应的 Skills、Rules 或 MCP 配置区域。
验证安装
重新启动应用，执行一个只读测试任务，确认正常后再逐步开放所需权限。
安全与权限提示
安装第三方 Skill 前请阅读仓库源码和许可证。涉及文件、浏览器或命令执行的资源，应只授权完成任务所必需的最小范围。不要把 API Key 提交到公开仓库。