ホーム / 全スキル / ワークフロー＆基本ツール / dbs-agent-migration
English (EN)简体中文 (ZH)日本語 (JA)
ワークフロー＆基本ツール · dontbesilent2025/dbskill

dbs-agent-migration

プロジェクトのルールファイルを監査し、真のソース（Source of Truth）を特定、命名を統一してブリッジを生成することで、プロジェクトを複数クライアント間で一貫した Agent ワークベンチへと移行します。Claude Code、Codex、Grok、汎用 Agents の移行や AGENTS.md の整理をユーザーが要求した際に使用します。

L2 ローカル · 作業ディレクトリ限定V1 コミット固定ファイル書き込みDual-pass Audit
Author dontbesilent2025GitHub dontbesilent2025/dbskill ↗Stars 10121License 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 标准标识））Commit 8b8e33f1ec
管理レベルは Skill の能力と推奨統制措置を示すものであり、品質や安全性の認証、利用可否の判定ではありません。使用の可否はユーザーおよび管理者が決定します。Agent 環境によって制約が異なるため、自動保護を仮定しないでください。第三者製 Skill の著作権は原著作者に帰属し、利用リスクは利用者が負います。

1仕組みと動作原理

移行はファイルのコピーではなく「構造の再編」と定義：プロジェクト単位のルールファイル、skill の真のソースの配置場所、bridge の命名規則、マルチクライアント間の一貫性、持続可能な保守性の 5 つを少なくとも同時に解決します。

skills/dbs-agent-migration/SKILL.md
**这不是安装教程。也不是脚本执行器。**
ここでの目的：「CLAUDE.md を AGENTS.md にコピーする」といった中途半端な移行を明確に不合格と判定し（原則 1 では「せいぜい一時的に動かすことしか解決していない」と記載）、納品基準を「真のソース + 命名 + マルチクライアント bridge + 保守性」の 4 点セットへ引き上げます。インストールコマンドを実行せず、終始監査／集約／生成／検証のみを行う点が、一般的なインストール手順と異なる理由です。

真のソース優先：プロジェクト内の 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 を再生成するだけ」。これが一連の手法における中核の不変項です。1 か所の真のソースを変更すれば、薄い bridge を介してマルチクライアントへ一貫して継承されます。

プロジェクトが標準化されていると仮定しない：4 種のルール層の現状（完全な中途半端移行 / CLAUDE.md のみ / AGENTS.md のみ / 完全に散乱）× 5 種のホストの現状（Claude のみ / Codex のみ / Grok のみ / 汎用 Agents のみ / マルチクライアントだが不一致）を分岐条件として明示的に列挙します。

skills/dbs-agent-migration/SKILL.md
- **D 类**：没有规范，skill 散落
単一フローではなくマトリクス形式にしている点が、本 skill と「使い捨ての移行スクリプト」の決定的な違いです。監査でまず分類（A/B/C/D + ホスト判定 1 文）を行い、次にどの層に手を入れるかを決定します。Phase 1 の出力形式では「どの分類か / すでに正しい点 / 真に不足している点 / 推奨される着手レイヤー」を報告し、続行するか確認することが厳格に求められます。

6 段階のプロセスは各段階とも「書き込み前の確認」で終了：監査 → ルールファイル移行 → 真のソースの特定／確立 → 命名と 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 セクション）、「必須チェック」3 項目（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 の 4 分類で判定し、「どの層から着手すべきか」を提案
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推奨統制措置と判定根拠

安全運用のための推奨統制措置
Agent 向け
作業ディレクトリを限定
管理者向け
操作ログを保持
判定根拠（ファイルパスと抜粋）
  • 本地工作目录: ファイルの読み書きと成果物の出力: （スクリプトレベルではなく指示レベル）プロジェクト AGENTS.md の新規作成／書き換え、必要に応じた薄い CLAUDE.md の新規作成を提案
監査ノート： 。判定理由：本 skill 自体にはスクリプトは含まれず、ネットワーク接続も行わず、認証情報も読み取りません（ディレクトリ内には SKILL.md と agents/openai.yaml のみ存在）。しかし、ホスト agent に対してプロジェクト構造を変更させるための操作マニュアルであり、そのプロセスには AGENTS.md や CLAUDE.md の作成／書き換え、プロジェクトレベルの skills/ ディレクトリの新規作成、マルチクライアント bridge ファイルの生成、~/.agents/skills へのシンボリックリンク作成が含まれます。すなわち、リスク領域は「ローカル構造およびファイルの読み書き」であり、書き込み対象にはユーザーのホームディレクトリ配下のホスト skill ディレクトリが含まれます。SKILL.md は誤操作を防ぐために 2 重の確認ゲートを設けています。各 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結論

  • マルチクライアント Agent ワークベンチの実課題に直結：プロジェクトが標準化されていると仮定せず、4 種のプロジェクト × 5 種のホスト状況に対応可能。
  • 真のソース／bridge の階層化により長期保守可能な不変項を提供し、同一ロジックが 4 つのホストディレクトリで分岐するのを防止。
  • ホスト固有の落とし穴を生成時チェックとして前倒し（Grok の user_invocable、汎用 Agents のシンボリックリンク readlink）、サイレント障害を検証可能な項目へ変換。
  • 保守的な書き込み方針：上書きなし、事前確認必須、プレビュー出力のみも可能で、他者が現行利用中のプロジェクトでも安全に適用可能。
  • 6 段階のフェーズ + 各段階での確認 + 完了時の 5 つの引き継ぎ確認により、納品プロセスがブラックボックスな移送にならず監査可能。
    • 最適な用途： ある程度の規模があり、ルールファイルや skill が散乱している（CLAUDE.md / AGENTS.md / 複数ホストのディレクトリが混在）プロジェクトで、一回限りの構造移行を行いたい場合に適しています。また、自身で保守する skill を Claude Code、Codex、Grok、汎用 Agents（Doubao Mac App、Trae Solo など）へ同時に提供したい開発者にも最適です。命名規約、bridge テンプレート、検証チェックリストを提供し、長期保守可能なワークベンチ構造を構築できます。「真のソース + 薄い bridge によるマルチクライアント配信」というエンジニアリング手法を学びたい skill 開発者にとっても、Phase 5 や命名規則は一読の価値があります。
    不向きな用途： 単に「CLAUDE.md をコピーして Codex を動かしたいだけ」のユースケースには不向きです（SKILL.md ではコピーは移行とみなされないと明記されており、一連の監査と命名統一を完了させられます）。ワンクリックのスクリプトで移行を完結させたいユーザーにも向きません。スクリプト実行器は意図的に排除されており、すべて agent が段階ごとに確認を取りながら進めます。ホストディレクトリの変更権限がない環境（企業の管理端末、共有マシンなど）には適していません。また、skill の品質レビューやナレッジベース内容の整理を期待するケースにも不向きであり、それらは本ツールの責務範囲外です。
    Install Agent-Ready
    ① Verified Mirror 2026-09-15
    Option A · Direct DownloadDownload dbs-agent-migration.tar.gz
    sha256: d64fe9dda1661834…
    Option B · Copy Guide for Agent
    install.json
    Agent はこの JSON ガイドから自動的にダウンロードして検証します。
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit 8b8e33f1ec.