1仕組みと動作原理
dbs は純粋なプロンプトオーケストレーションエントリであり、初心者チュートリアルと単一タスクオーケストレーションの2つのみを担当し、具体的な業務実行は次回呼び出される下流の Skill に明示的に委ねます。
skills/dbs/SKILL.md
本 Skill 只负责发现候选、判断单项或组合、分配角色和生成提示词。具体诊断、研究、制作、检查与执行留给用户下一轮调用的下游 Skill。
ここでの処理内容：「ルーティング」と「実行」を2つのターンで完全に分離します。現在のターンでは送信可能なプロンプトのみを出力し、実際の業務成果物の生成はすべて次回ユーザーがリーフ Skill を呼び出すターンに委ねます。これによりエントリ Skill による権限逸脱した出力を防ぎ、オーケストレーション結果をユーザーが確認してから実行できるようにします。
Skill 実行時にまずバージョン確認スクリプトを実行：bash で scripts/check-update.sh を呼び出し、公式の UPDATE.json を読み込みます。通信は24時間に1回のみ行われ、キャッシュは ~/.dbs/update_check_at に保存されます。
skills/dbs/SKILL.md
DBS_LOCAL_VERSION="2.18.40"; bash "<本 SKILL.md 所在目录>/scripts/check-update.sh" "$DBS_LOCAL_VERSION"
スクリプトは実際に存在する実行可能コードです（プロンプトのプレースホルダーではありません）：skills/dbs/scripts/check-update.sh は curl で https://raw.githubusercontent.com/dontbesilent2025/dbskill/main/UPDATE.json を取得し、python3（代替として node）で解析して semver 比較を行います。リモートのバージョンが高い場合、「dbskill vX：<notice> 1 と返信すれば、今すぐ更新をお手伝いします。」という1行を出力します。SKILL.md には「コマンドに出力がない、実行失敗、またはタイムアウトした場合はスキップする」と規定されており、スクリプトの失敗によってオーケストレーションが停止することはありません。
候補の検出もスクリプトで実施：python3 で scripts/list-official-skills.py を実行し、.claude-plugin/marketplace.json を公開候補の正式な情報源とし、ファイルが存在しない場合はバージョンビルド時の名称スナップショットにフォールバックします。
skills/dbs/SKILL.md
脚本在完整项目中以当前版本的 `.claude-plugin/marketplace.json` 为公开候选权威源；独立 Skill 安装包缺少 Marketplace 文件时，使用随版本构建并经过一致性检查的正式名称快照。
list-official-skills.py の実装は skills/dbs/scripts/list-official-skills.py にあります。上位ディレクトリの .claude-plugin/marketplace.json を探索し、なければ references/official-skill-names.txt を読み込みます。次にプロジェクトの skills/ およびユーザーホームディレクトリの ~/.agents/skills、~/.codex/skills、~/.claude/skills からインストール済み Skill を特定し、name/description/source を含む JSON を出力します。除外ルールはスクリプト内にハードコードされており、dbs という名前のエントリや beta/private を含むエントリはスキップされます。
オーケストレーションの決定は検証可能な判定基準の集合：5つの候補判定（タスク結果／入力一致／段階一致／境界一致／実行可能性）に基づき、まず単一 Skill で十分かを判定し、必要な場合のみ組み合わせ、上限は主1＋副2に厳格に制限されます。
skills/dbs/SKILL.md
总量不超过 1 个主 Skill 和 2 个辅助 Skill。
組み合わせの5つの必要条件は同セクションに記述されており（「ユーザーの最終タスクと最終納品物が1つのみである」「候補選定、証拠、停止条件、検収結果を変更する独立した要件が2つ以上ある」など）、3種類の補助ロール（事前スクリーニング／証拠補完／検収制約）とそれぞれの依存位置が定められています。ロール、順序、フォールバックの詳細規定は references/composition-contract.md に外出しされており、組み合わせが必要と判定された場合のみ読み込まれるプログレッシブディスクロージャー（段階的開示）設計となっています。
出力規律：プロンプトを1つ生成した時点で直ちに当該ターンを終了し、下流の業務結論を先取りして出力しません。
skills/dbs/SKILL.md
没有第二个辅助 Skill 时省略对应内容。提示词生成后立即结束当前轮次。
単一 Skill の出力テンプレートでは「推奨：`/{skill-name}` ＋ 選定理由1行 ＋ そのまま送信可能なプロンプト」が求められます。組み合わせテンプレートでは主副の役割分担を明記し、「最終的には主 Skill が統括する単一の成果物のみを納品し、複数の Skill レポートを順次結合しないこと」を義務付けています。テンプレートは SKILL.md 本文にハードコードされており、ターン間での出力形式の安定性が保証されています。
Skill 間ハンドオーバー契約：dbs が唯一の動的オーケストレーションハブであり、リーフ Skill 同士での直接の案内は禁止され、タスク未完了時に次のステップに言及することは許可されません。
skills/dbs/SKILL.md
`/dbs` 是正式 Skill 之间唯一的动态编排中心。
付帯条項：リーフ Skill は現在のタスク完了後に直ちに終了し、ユーザーから次のステップについて明示的な問い合わせがあった場合のみ「次のステップが不明な場合は `/dbs` と入力してください」と案内します。一致しない Skill が呼び出された場合は、抽出済み情報を保持したまま /dbs に制御を戻します。この契約は他の31個のリーフ Skill の末尾にも一語一句違わず記載されており、リポジトリ全体で単一エントリ構造を確立しています。
2コア機能
01初心者チュートリアル（モード A）：初回利用者向けに成果物、システムの仕組み、開始方法を説明
02タスクオーケストレーション（モード B）：現在の対話から単一タスクを特定し、単一 Skill 推奨または主1＋副≤2の組み合わせを出力
03候補検出：Marketplace の公式エントリを基準とし、スクリプトを実行してインストール済み公式 Skill と実際のソースパスを列挙
04バージョン通知とワンクリック更新：スクリプトがリモートバージョンを比較し、更新がある場合は回答末尾に通知を追加。「1」と返信すると /dbs-update を実行
05権限と安全ゲート：オーケストレーション時に自動で権限拡大を行わず、不審な Skill や機密データのリスクを検知した場合は停止して事前確認を要求
06空対話ガイダンス：認識可能なタスクがない場合、空回りせずにハードルの低い導入メッセージを案内
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| cli | bash |
| cli | curl |
| network | 官方 UPDATE.json（版本检查，可用环境变量覆盖） |
| cli | python3 |
| cli | node（python3 不可用时的解析兜底） |
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠（ファイルパスと抜粋）
- scripts/: ローカルスクリプトまたはコマンドの実行: bash <skillディレクトリ>/scripts/check-update.sh "2.18.40"（本 skill 呼び出し時に毎回実行）
- 网络端点: 外部ネットワークアクセスの宣言: GET https://raw.githubusercontent.com/dontbesilent2025/dbskill/main/UPDATE.
- 本地工作目录: ファイルの読み書きと成果物の出力: mkdir -p ~/.dbs および ~/.dbs/update_check_at の書き込み（現在の unix タイムスタンプで上書き）
監査ノート： 。判定基準は知名度ではなく実際の挙動に基づきます。本 skill はローカルスクリプトを実行し、check-update.sh は呼び出しごとに raw.githubusercontent.com へ GET リクエストを送信し（24時間キャッシュ内はスキップ）、$HOME/.dbs/ にキャッシュファイルを書き込みます。認証情報の読み込みやユーザーデータの外部送信は一切行われず（リクエストにパラメータ、Cookie、ペイロードは含まれません）、外部送信先も単一かつ予測可能であり、「一般的なネットワーク呼び出し（公開 API/公式 CLI）」の基準に該当します。第4バッチ最終判定基準の第3レベル（固定の公開エンドポイントへの問い合わせ、公式 CLI による update/check 等の予測可能で低リスクな外部送信。先例：guizang-ppt / archify / llm-icon-finder）に従い yellow と判定します。本 skill は開始時に同梱の check-update.sh を実行し、スクリプトは固定の公開エンドポイントへ無条件で GET を送信するため（24時間キャッシュ内のみスキップ）、オプション機能や禁止条項のみの言及ではなく update/check 型の外部送信に該当します。留意すべき点として、環境変数 DBS_UPDATE_URL により接続先を任意のホストに変更可能である点（サプライチェーン上のリスクですが、解析処理に長さ・改行・正規表現の検証があり、最悪の場合でも80文字以内の偽のバージョン通知が表示される程度にとどまります）、および list-official-skills.py がユーザーホームの skill ディレクトリを読み取って絶対パスを対話に出力する点があります。その他については、自動的な権限拡大を明示的に禁止しています（「オーケストレーションによって読み取り、書き込み、公開、削除、支払い、外部通信の権限が自動的に拡張されることはない」）。
5二重目の独立検証
- [ok] 两个脚本真实存在且可执行语义与描述一致 — skills/dbs/scripts/check-update.sh（116 行 bash）与 skills/dbs/scripts/list-official-skills.py（python3）均逐行读过；SKILL.md 对二者行为的描述（24h 缓存、marketplace 优先、快照兜底、只返回已安装正式 Skill）与实现一致，无夸大。
- [ok] 网络外发唯一且为官方端点 — 全目录 token 扫描只命中一处 curl，指向 raw.githubusercontent.com/dontbesilent2025/dbskill/main/UPDATE.json；无 webhook、无上报、无第三方域名。
- [ok] 凭证读取为零 — 脚本只读 $HOME 路径与可选 DBS_UPDATE_URL；无 token/api_key/keychain/.env/.netrc 读取。
- [ok] 写文件范围（仅 ~/.dbs 缓存） — check-update.sh 中唯一写入是 mkdir -p "$DBS_DIR" 与 printf 时间戳到 ~/.dbs/update_check_at；list-official-skills.py 无 write 调用（只 read_text/print）。
- [ok（确认为设计内行为）] 远端 notice 文本会进入模型上下文（注入面） — SKILL.md 明确要求「命令有输出时，将输出内容追加在本次回复的最末尾，单独成段，引用格式为 > 🔔 {输出内容}」；notice 由脚本做 1–80 字与禁换行校验，非任意长文本。已按「远端可控字符串入上下文」如实计入 injection_surface。
- [ok] 版本号硬编码 2.18.40 与仓库 VERSION 一致 — SKILL.md 的 DBS_LOCAL_VERSION="2.18.40" 与仓库根 VERSION 文件（2.18.40）、UPDATE.json.version（2.18.40）三处一致。
- [ok] 「编排不自动扩权」是否只是口号 — SKILL.md 有可执行的落地条款：任一成员需要新增授权时把授权条件写进提示词、本入口不代替用户授权；组合条件第 4 条要求「组合不会绕过任何成员的证据、权限、安全或停止边界」。属提示层约束（无代码级强制），已在 risks 中说明。
- [ok] 元数据（license/stars/last_push/installs） — GitHub API：stargazers_count 10121、pushed_at 2026-09-07T03:48:59Z、license.spdx_id NOASSERTION（仓库根 LICENSE 实为 CC BY-NC 4.0，非商业）；skills.sh 徽标 579.6K 为仓库级聚合。本地 git HEAD = 8b8e33f1ecaed8cee606fe950c4426b525ead314，与任务 pin 一致。
6結論
最適な用途： dbskill（32種類の公式 Skill ファミリ）をインストール済みで、各 Skill の用途を覚えたくないユーザーに最適です。実際のタスクをそのまま /dbs に渡すことで、単一または主副の組み合わせを判定し、そのまま送信できるプロンプトを取得できます。また、エントリ Skill による「候補検出 ＋ 組み合わせオーケストレーション ＋ プロンプト生成」の設計手法を学びたい Skill 開発者にも適しています（スクリプトによる候補検出、上限付きの組み合わせ、段階的開示のパターンをそのまま参考にできます）。単体インストール（marketplace.json なし）環境でも名称スナップショットにより利用可能ですが、候補の description は SKILL.md の frontmatter 読み込みにフォールバックするため選定精度は低下します。
不向きな用途： dbs シリーズの単一 Skill のみインストールされた環境には不向きです。候補プールが存在しないためオーケストレーションが空回りします（スクリプトが空リストを返すため、その場合は対象のリーフ Skill を直接呼び出す必要があります）。1回のターンで即座に業務結論を得たいユーザーには適していません。本エントリでは「本ターン内で選定された Skill の業務プロセスを実行してはならない」と明記されており、プロンプトを再送信する必要があります。/dbs を対話型アシスタントとして利用する用途には不向きです。各ターンで現在の1つのタスクのみを処理し、タスクをまたぐ固定の組み合わせの保持やデフォルトの長い実行チェーンは設計されていません。また、完全なサイレント動作を期待するオフライン・閉域網環境にも適していません（24時間ごとに raw.githubusercontent.com へのリクエストが1回発生します）。
Install Agent-Ready
① Verified Mirror 2026-09-15
Option A · Direct DownloadDownload dbs.tar.gz
sha256:
Option B · Copy Guide for Agentab141ef415ad29ec…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit 8b8e33f1ec.