1实现原理 · 为什么它能做到
迁移被定义为「结构重排」而非复制文件：至少同时解决项目级规则文件、skill 真源位置、bridge 命名规则、多端一致、可持续维护五件事。
skills/dbs-agent-migration/SKILL.md
**这不是安装教程。也不是脚本执行器。**
注：这里在做什么：把「把 CLAUDE.md 复制成 AGENTS.md」这类半迁移明确判为不合格（原则 1 说它「最多只解决了先跑起来」），从而把交付标准抬到「真源 + 命名 + 多端 bridge + 可维护」四件套，这也是它区别于普通安装教程的地方——它全程只做审计/收编/生成/验证，不执行安装命令。
真源优先：项目内 skills/ 是理想真源，~/.claude|.codex|.grok|.agents/skills 只是 bridge 或宿主安装入口，长期逻辑不得写在 bridge 里。
skills/dbs-agent-migration/SKILL.md
- `~/.claude/skills/`、`~/.codex/skills/`、`~/.grok/skills/`、`~/.agents/skills/` 都只是 bridge 或宿主安装入口
注：配套禁令「不要把长期逻辑维护在 bridge 里」与收尾话术「以后怎么维护：只改真源，重新生成对应宿主的 bridge 即可」。这是整套方法的核心不变量：改一处真源，多端靠薄 bridge 一致性继承。
不假设项目已规范：显式枚举 4 类规则层现状（齐全半迁移 / 只有 CLAUDE.md / 只有 AGENTS.md / 完全散落）× 5 类宿主现状（只有 Claude / 只有 Codex / 只有 Grok / 只有通用 Agents / 多端但不一致）作为分支依据。
skills/dbs-agent-migration/SKILL.md
- **D 类**：没有规范，skill 散落
注：把它做成矩阵而不是单线流程，是这份 skill 与「一次性迁移脚本」的关键差异：审计先分类（A/B/C/D + 一句宿主判断），再决定后续动哪一层；Phase 1 输出格式被硬性要求汇报「哪一类 / 已做对什么 / 真正缺什么 / 建议先动哪一层」并问一句是否继续。
六阶段流程每段都以「写入前确认」收口：审计 → 规则文件迁移 → 真源识别/建立 → 命名与 frontmatter → 生成多端 bridge → 验证。
skills/dbs-agent-migration/SKILL.md
不要一口气做完再汇报。
注：Phase 2 要求写入前说明「新建还是改写哪个文件 / 会保留什么 / 会删除什么 / 为什么这样分层」；Phase 4 规定「必须给用户一份清单，而不是直接移动文件」；Phase 5 要求先说明将为哪些宿主生成 bridge 并取得确认。多步确认在这里被明确定义为「产品的一部分」。
Grok bridge 有硬约束与精确模板：frontmatter 必须含 user_invocable: true，description 必须写明在 Grok TUI 中的触发方式与「先读真源」，正文推荐 Grok Bridge 小节 + Source of truth 绝对路径。
skills/dbs-agent-migration/SKILL.md
Grok bridge **必须** 在 frontmatter 里包含 `user_invocable: true`，否则用户在 Grok TUI 输入 `/` 后搜不到这个 skill。
注：模板骨架逐字给出（name / user_invocable / description 多行 + ## Grok Bridge 段落），并附「必须检查」三项（user_invocable 是否存在、description 是否提到 Grok TUI 与触发词、路径是否为绝对路径）。这类宿主专属硬约束是「多端一致」目标的具体落点——把「Grok 侧搜不到」这种静默失败前置成生成期检查。
通用 Agents 侧优先用软链而非复制，并对同名冲突给出保守策略：不覆盖、报告目标路径与当前类型、由用户确认是否迁出旧目录。
skills/dbs-agent-migration/SKILL.md
`~/.agents/skills/<name>` 优先使用软链指向真源目录。这个目录已知会被豆包 Mac App、Trae Solo 和 Codex 读取。
注：同节要求：若目标已是同名软链可更新，但「更新后必须检查 readlink 是否指回预期路径」；Phase 6 验证清单专列一条「`~/.agents/skills` 里的目标是否存在真实目录冲突或悬空软链」。软链策略避免多份真源漂移，是「只改真源」不变量在文件系统层的落地。
命名统一有可判定规则：每个 Skill 只保留 1 个可调用名、小写英文 kebab-case、dbskill 正式 Skill 用 dbs- 前缀、目录名与 frontmatter name 与 bridge 目录名必须完全一致、Codex display_name 必须等于英文标准名、short_description 禁止模板套用。
skills/dbs-agent-migration/SKILL.md
可调用名使用小写英文 kebab-case；dbskill 正式 Skill 使用 `dbs-` 前缀，例如 `dbs-good-question`。
注：同段有 6 条编号规则，含「中文名称只可作为说明标题和自然语言意图，不能作为 `/` 调用别名」「不要让脚本根据标题临时取名」；这正是本项目 32 个 Skill 名称形态（dbs-xxx）的来源说明，属可核对的命名契约。
2核心能力
01规则层审计与分类：判定 A/B/C/D 四类项目并提出「先动哪一层」的建议
02规则文件分层迁移：拆出平台无关规则写入 AGENTS.md，Claude 专属留在 CLAUDE.md
03skill 真源识别或建立：无 skills/ 时进入候选发现模式，产出候选真源清单并标注建议收编/不建议
04多端 bridge 生成（Claude / Codex / Grok / 通用 Agents），含 Grok 的 user_invocable 硬约束与精确 YAML 模板
05命名与 frontmatter 统一：kebab-case 单一名、dbs- 前缀、Codex display_name 与英文标准名一致
06迁移后验证清单（8 项）：AGENTS.md 独立可用、真源明确、frontmatter 齐备、bridge 指回真源、多端集合一致、Grok 的 user_invocable、软链冲突、悬空引用
4风险提醒 风险提醒：蓝色 · 知晓即可
风险提醒：蓝色 · 知晓即可
- 会改动用户主目录下的宿主 skill 目录 — 在 ~/.agents/skills/<name> 建/更新软链会影响其它宿主应用（豆包 Mac App、Trae Solo、Codex）读到的 skill 集合；SKILL.md 要求冲突时不覆盖并要求用户确认，但确认后的影响范围超出当前项目——建议在受控环境先行验证。
- 写入/移动文件的风险依赖用户确认纪律 — 「不经确认不移动文件」是提示层约束；若宿主自动批准工具调用，Phase 2/3 的批量改写可能在用户未细看清单时执行。迁移前建议对项目做版本控制备份。
- 被收编的第三方 skill 文档成为长期指令源 — 候选发现模式会把项目内散落的 *skill*.md 认定为真源，之后每次调用都经它驱动行为；来源不明的文档一旦被收编，等于把外部文本升格为常驻规则。收编清单必须人工过目。
- 模板路径插值可能破坏 YAML/frontmatter — bridge 模板把「/绝对路径/到/项目/skills/技能规范名/SKILL.md」与技能名直接插入 YAML；含特殊字符、空格或换行的路径/名称可能产出不可解析的 frontmatter，需在生成后按 Phase 6 逐项验证。
- 不负责内容质量 — 它只做结构迁移：不评审方法论质量、不做知识库内容优化（SKILL.md 明确列在「不负责」清单），不应对迁移结果产生「内容也已整理好」的错觉。
风险提醒：蓝色，知晓即可。判定依据：本 skill 自身不含任何脚本、不联网、不读凭证（目录只有 SKILL.md 与 agents/openai.yaml），但它是一份「让宿主 agent 动手改项目结构」的操作手册——过程包含创建/改写 AGENTS.md 与 CLAUDE.md、新建项目级 skills/ 目录、生成多端 bridge 文件、在 ~/.agents/skills 建软链。即它的风险面是「本地结构与文件的读写」，且写入对象包含用户主目录下的宿主 skill 目录。SKILL.md 用两道确认闸门降低误伤：每个 Phase 都有「写入前确认」，并规定「只有在用户明确允许写入目标宿主目录时，你才可以直接把 bridge 写到目标位置；否则先提供预览」，另对已存在的同名真实目录/文件要求「不覆盖」并由用户确认是否迁出。无网络外发、无凭证读取 → 落蓝色档。
5第二遍独立确认
- [ok] 无脚本、无网络、无凭证 — 目录仅 SKILL.md + agents/openai.yaml；token 扫描（curl|wget|http|API_KEY|token|secret|\.env|bash|exec|python|npx）零命中；文中所有「写入」都是给 agent 的指令，不是自带代码。
- [ok] Grok 硬约束 user_invocable 逐字存在且被反复强调 — grep 命中 8 处，含约束条款、模板内字段、生成期校验、Phase 6 验证项与禁止事项「Grok bridge 绝对不能漏写 user_invocable: true」。
- [ok] bridge 模板为薄指针、不承载逻辑 — Claude/Codex 模板含 source_of_truth 与 bridge_mode: passthrough，正文仅「请读取真源：…本文件为薄 bridge，仅做入口指向。长期逻辑维护在真源。」；Grok 模板同样只指向 Source of truth。
- [ok] 「不覆盖既有同名真实目录/文件」是否有落地条款 — 「通用 Agents 目录策略」一节给出三条：不覆盖；报告目标路径和当前类型；让用户确认是否迁出旧目录。Phase 6 另列软链冲突/悬空软链检查项。
- [ok] 是否承诺执行安装（夸大检查） — SKILL.md 开篇即否认「这不是安装教程。也不是脚本执行器。」；全文无 npx/claude plugin install 之类命令，与自述一致。
- [ok] 与同仓库既有命名实践一致 — 命名规则第 2 条要求 dbs- 前缀；任务涉及的 8 个 skill 目录名（dbs-action、dbs-ai-check…）与各自 frontmatter name、agents/openai.yaml display_name 三处逐字一致，规则与仓库现状吻合。
- [ok] 元数据（license/stars/last_push/installs/commit） — GitHub API：stars 10121、pushed_at 2026-09-07T03:48:59Z、license.spdx_id NOASSERTION（根 LICENSE 为 CC BY-NC 4.0，非商业）；本地 HEAD = 8b8e33f1ecaed8cee606fe950c4426b525ead314 = 任务 pin。
- [discrepancy] meta.installs 值域校正（批4 质检 2026-09-15） — 原记录为 skills.sh 仓库级聚合徽标（579.6K（skills.sh 徽标 /b/dontbesilent2025/…），并非本 skill 的单体安装量；站内惯例只记可定位的单 skill 数值 → 校正为 null（其他 25 份 dbs 报告本就为 null，修此 8 份以齐平）
6结论
适合：适合已有一定规模、规则文件与 skill 散落（CLAUDE.md / AGENTS.md / 多个宿主目录混用）的项目做一次性结构迁移；也适合要把自己维护的 skill 同时供给 Claude Code、Codex、Grok 与通用 Agents（豆包 Mac App、Trae Solo）的开发者——它给出命名契约、bridge 模板与验证清单，能产出可长期维护的工作台结构。想学习「真源 + 薄 bridge 多端分发」这套工程做法的 skill 作者同样值得读它的 Phase 5 与命名规则。
不适合：不适合只想「把 CLAUDE.md 复制一份让 Codex 跑起来」的场景（SKILL.md 明说复制不算迁移，会让你做完一整轮审计与命名统一）；不适合希望一键脚本完成迁移的用户——它刻意不做脚本执行器，全靠 agent 逐阶段确认；不适合无权改动宿主目录（公司管控设备、共享机器）的环境；也不适合想让它顺手评审 skill 质量或整理知识库内容的场景，那不属于它的职责范围。
安装 agent 直装可复制
① 本站镜像 更新 2026-09-15
方式 A · 人下载镜像包下载 dbs-agent-migration.tar.gz
sha256:
方式 B · JSON 格式安装指南，复制给 agentd64fe9dda1661834…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库dontbesilent2025 / dontbesilent2025/dbskill
原始 GitHubdontbesilent2025/dbskill ↗
Stars10121
最近推送2026-09-07
本 skill commit
8b8e33f1ec许可CC BY-NC 4.0（仓库根 LICENSE 首行「Attribution-NonCommercial 4.0 International (CC BY-NC 4.0)」，条款为 Attribution + NonCommercial，Copyright (c) 2026 dontbesilent。**非商业授权**：个人/学习/研究可直接使用，商业用途需单独授权；GitHub API license.spdx_id 为 NOASSERTION（CC 系非 SPDX 标准标识））
本站信息
收录日期2026-09-06
分类基础工具与工作流
侦查报告AI 侦查 · 2 遍 · 2026-09-06
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。