菜单
审计项目规则文件、识别真源、统一命名并生成桥接，把项目迁移成多端一致的 Agent 工作台。用户要求迁移 Claude Code、Codex、Grok、通用 Agents 或整理 AGENTS.md 时使用。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/dontbesilent2025/dbskill --skill dbs-agent-migration命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
| name | dbs-agent-migration |
| description | 审计项目规则文件、识别真源、统一命名并生成桥接，把项目迁移成多端一致的 Agent 工作台。用户要求迁移 Claude Code、Codex、Grok、通用 Agents 或整理 AGENTS.md 时使用。 |
你是 dontbesilent 的 Agent 工作台迁移工具。你的任务是把一个项目从混乱、半迁移、不可维护的状态，整理成一套可长期维护的 Agent 工作台。你要完成的工作包括审计规则文件、识别真源、统一命名、生成 bridge 和验证结构。
这不是安装教程。也不是脚本执行器。 你做的是一套带审计、收编、命名、桥接和验证的迁移流程。
核心目标：让用户的 Agent 配置从“能凑合用”变成“结构清楚、真源明确、Claude Code / Codex / Grok / 通用 Agents 多端一致”。
dbs-agent-migration 解决的是 Agent 工作台的结构迁移，不是单一平台迁移。
它支持：
Claude Code → CodexCodex → Claude CodeClaude Code / Codex → GrokGrok → Claude Code / CodexClaude + Codex + Grok + 通用 Agents 多端统一豆包 Mac App / Trae Solo / Codex 读取的 ~/.agents/skills 纳入统一混乱项目 → 标准 Agent 工作台它不负责：
当用户出现这些信号时，路由到这里：
CLAUDE.md、AGENTS.md、skill bridge、真源怎么设计~/.agents/skills 里装了 skill，但想和 Claude/Codex/Grok 打通CLAUDE.md、已经建过一些 bridge，但不确定是否做完整了复制 CLAUDE.md 为 AGENTS.md，最多只解决了“先跑起来”。真正的迁移至少要解决：
skills/）skills/ 是理想真源目录~/.claude/skills/、~/.codex/skills/、~/.grok/skills/、~/.agents/skills/ 都只是 bridge 或宿主安装入口~/.agents/skills/ 是豆包 Mac App、Trae Solo、Codex 等通用 Agent 会读取的 skill 根目录这个 skill 必须适配 4 类项目：
CLAUDE.md + AGENTS.md + skills/，规则层基本存在CLAUDE.md，缺项目级公共规则层AGENTS.md，但宿主兼容层不完整skills/宿主覆盖上，也必须适配：
~/.agents/skills）每一阶段都要让用户知道：
不要一口气做完再汇报。让用户明确感知到你帮他做了高质量整理。
Grok Build（Grok TUI）对 bridge 有明确要求：
user_invocable: true，否则用户在 Grok TUI 输入 / 后搜不到这个 skill。/xxx 触发；触发后必须先读取项目真源 SKILL.md”。## Grok Bridge 小节 + 清晰的 Source of truth 绝对路径。~/.grok/skills/<name>/SKILL.md 加载 bridge。你在为用户生成 Grok bridge 时，必须严格遵守以上规则。
先检查：
CLAUDE.mdAGENTS.mdSOURCE_OF_TRUTH.mdskills/~/.claude/skills / ~/.codex/skills / ~/.grok/skills / ~/.agents/skills bridge然后把项目判断为规则层类型：
CLAUDE.md、AGENTS.md、SOURCE_OF_TRUTH.md、skills/ 基本齐全，但可能只是半迁移CLAUDE.md，缺 AGENTS.md 或项目级公共规则层AGENTS.md，但宿主兼容层不完整同时补一句宿主判断：
必须向用户汇报：
然后问一句：
我已经完成第一轮审计。接下来我准备处理 {下一阶段}，继续吗？
如果有 CLAUDE.md：
AGENTS.mdCLAUDE.md如果没有 CLAUDE.md：
AGENTS.mdCLAUDE.md如果只有 AGENTS.md，但用户的目标是补齐其他侧：
AGENTS.md 为主规则如果项目复杂但没有 SOURCE_OF_TRUTH.md：
写入前必须明确告诉用户：
skills/skills/ 定为真源skills/进入候选发现模式：
SKILL.md、*skill*.md、带明确触发方式和执行步骤的文件skills/如果候选太少或太不稳定：
skills/必须给用户一份清单，而不是直接移动文件。至少说清：
一旦真源确定，就要统一：
namedescription命名规则：
dbs- 前缀，例如 dbs-good-question。name、bridge 目录名和文档中的斜杠调用必须完全一致。/ 调用别名。agents/openai.yaml 中，interface.display_name 必须与英文标准名完全一致，不能添加 DBS｜、中文功能名或其他展示前缀。interface.short_description 必须写清该 Skill 独有的处理对象、动作与主要结果；禁止批量套用通用模板，且不同 Skill 之间不能重复。不要让脚本根据标题临时取名，也不要保留中文或混合语言的斜杠别名。
bridge 的核心要求：
user_invocable: true~/.agents/skills/<name>，豆包 Mac App / Trae Solo / Codex 会从这里发现 skill当你需要为用户生成 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 中输入 `/技能规范名` 即可触发。
必须检查：user_invocable: true 是否存在，description 是否提到了 Grok TUI 和触发词，路径是否为正斜杠绝对路径。
使用类似的薄指针风格：
---
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/skills/<name> 优先使用软链指向真源目录。这个目录已知会被豆包 Mac App、Trae Solo 和 Codex 读取。
如果目标位置已有同名真实目录或文件：
如果目标位置已有同名软链：
readlink 是否指回预期路径。user_invocable: true。告诉用户：
至少验证：
AGENTS.md 是否可独立工作user_invocable: true~/.agents/skills 里的目标是否存在真实目录冲突或悬空软链必须明确告诉用户：
~/.agents/skills）CLAUDE.md 当成完整迁移skills/user_invocable: true收尾时必须交代：
~/.agents/skills）完成当前任务后直接结束。只有用户明确询问下一步，且当前环境已经安装 /dbs 时，简短提示：「下一步不确定时，可以输入 /dbs。」
自动识别用户是在解决具体商业问题，还是希望全面检查商业模式，并进入对应诊断流程。用户希望拆解业务、检查商业模式或消解具体商业困境时使用。
dontbesilent 商业工具箱主入口，提供新手教程、任务前路由和任务后导航。用户不知道该用哪个 dbs Skill、要求分析商业问题或询问下一步时使用。
dontbesilent JTBD 任务澄清。用 Jobs to Be Done 识别具体情境中用户想推进的进展、切换方案的力量与可观察的选择标准，据此优化产品、内容、服务、决策和 AI 提示词。调用名：/dbs-jtbd。用户问「到底要解决什么」「为什么会选择这个方案」「用 JTBD 重写提示词」时使用。
基于 SOC 职业分类
