1仕組みと動作原理
スキル全体で同期コマンドは1つのみ:公式インストーラーを使用して公式リポジトリの全正式 Skill をサポート対象 Agent にインストールします。
skills/dbs-update/SKILL.md
npx -y skills add dontbesilent2025/dbskill -g --all
コマンドは単一で、対象は dontbesilent2025/dbskill にハードコードされており、パラメータ化された別リポジトリは受け付けません(「更新範囲」セクションの第1条)。
更新後にローカルタイムスタンプを書き込み、現在の会話に古い Skill が読み込まれていることによる通知の重複を防ぎます。
skills/dbs-update/SKILL.md
mkdir -p "$HOME/.dbs" && date +%s > "$HOME/.dbs/update_check_at"
同じタイムスタンプファイルが /dbs の check-update.sh から読み取られて24時間キャッシュとして機能し、双方向で同一のセマンティクスを共有します。
スコープの厳格な境界:公式リポジトリのみを更新し、ユーザーアーカイブを保持し、他の Skill に干渉せず、バックグラウンドタスクを作成せず、他の Skill に悪影響を及ぼす可能性のあるコマンドを明示的に禁止します。
skills/dbs-update/SKILL.md
不使用 `npx skills update`,该命令可能更新用户安装的其他 Skill。
4つの境界(更新範囲)+3つの境界(境界セクション)により、「更新」を公式コンテンツのみに限定します。
トリガーセマンティクスはコンテキストと厳密にバインド:直前のアシスタントの返答に更新通知が含まれている場合のみ単体の `1` が更新を意味し、それ以外の場合は数字を独自に解釈してはなりません。
skills/dbs-update/SKILL.md
缺少这段上下文时,不要自行解释数字含义。
これは「ユーザーが何気なく 1 と返信しただけで更新を承認したと判定される」のを防ぐためのものです。スキルで明確に定められた2種類のトリガー(明示的な要求/直前通知後の 1)は、いずれもテキストによる再確認を行わずに直接実行されます。
通知側のメカニズムは同一リポジトリの /dbs エントリから提供:バージョン比較 + 24時間キャッシュ + 固定の「1 と返信」文言。dbs-update はそのコンテキストを消費するのみです。
skills/dbs/scripts/check-update.sh
回复 1,我现在帮你更新。\n' "$REMOTE_VERSION" "$NOTICE"
check-update.sh は UPDATE.json からリモートバージョンを読み込み、ローカルより新しい場合のみバージョン番号とユーザーメリットを含む通知を出力します。キャッシュファイルは ~/.dbs/update_check_at です(CACHE_TTL=86400)。
返答フォーマットは成功/失敗の2種類のテンプレートに固定されており、失敗時は完全なターミナルログを出力せず、簡潔な原因と次のステップのみを返します。
skills/dbs-update/SKILL.md
不要把完整终端日志直接贴给用户,除非用户要求。
成功時の文言には、「新しい機能を使用する前に一度新しい会話を作成してください」という操作上の注意も含まれています(現在のセッションが古い Skill を保持し続けている可能性があるため)。
バージョンの整合性はリポジトリのツールチェーンによって保証:VERSION と marketplace/plugin マニフェストのバージョンが一致していることで更新契約が成立します。
tools/check-plugin-update-contract.py
errors.append(f"插件 {name} 的更新版本为 {plugin_version!r},应为 {version!r}")
リポジトリレベルの契約:VERSION には MAJOR.MINOR.PATCH を採用し、すべての marketplace プラグインのバージョンと各 plugin.json のバージョンは同一である必要があります(現在は 2.18.40)。
2コア機能
01公式 dbskill の全正式 Skill をワンクリックで同期(npx skills add -g --all)
02更新タイムスタンプ(~/.dbs/update_check_at)を記録して重複通知を防止
03更新スコープの限定:公式リポジトリのみ、~/.dbs アーカイブを保持、他の Skill に非干渉、バックグラウンドタスク未作成
04トリガー判定:明示的な要求または通知後の `1`。テキストでの二重確認は不要
05固定された成功/失敗レポート文言(失敗時に生ログを貼り付けない)
06バージョン・更新内容に関する Q&A(バージョンのみを尋ねられた場合はコマンドを実行しない)
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| cli | npx(执行官方生态安装器 skills) |
| package | skills —— 生态官方安装器包(npx -y 即时拉取执行) |
| network | GitHub / npm registry(拉取 skills 包与官方仓库内容) |
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠(ファイルパスと抜粋)
- scripts/: ローカルスクリプトまたはコマンドの実行: npx -y skills add dontbesilent2025/dbskill -g --all(SKILL.md で指定された唯一のアクション。公式エコシステムを実行
- 网络端点: 外部ネットワークアクセスの宣言: npx が npm パッケージ skills を取得し、GitHub にアクセスして dontbesilent2025/dbskill の内容を取得(SKILL.md ステップ1
- 本地工作目录: ファイルの読み書きと成果物の出力: $HOME/.dbs/update_check_at(タイムスタンプ、自身でのキャッシュ用)
監査ノート: 判定基準はすべて本スキルディレクトリ内の実際のアクションに基づいており、自己証明が可能です:SKILL.md のステップ1は `npx -y skills add dontbesilent2025/dbskill -g --all` であり、エコシステム公式インストーラーによって公式リポジトリの更新/インストールが行われます。外部送信先は公開レジストリと GitHub であり、バッチ4最終基準における「公式 CLI の update/check などの予測可能で低リスクな外部送信」に該当します。ステップ2ではローカルタイムスタンプ ~/.dbs/update_check_at を書き込むのみです。ユーザー素材/プロンプトの外部送信はなく、生成やサービスバックエンドを明記しておらず、クレデンシャルやプライベートトークンも読み取らないため、🟠 ではなく 🟡 に分類されます。スコープは公式リポジトリにハードコードされており、他の Skill を巻き込む可能性のある `npx skills update` は明示的に除外されています。
5二重目の独立検証
- [ok] 目标仓库写死且唯一 — SKILL.md 命令与"更新范围"节均只涉及 dontbesilent2025/dbskill,无参数化仓库输入。
- [ok] "不更新其他 Skill"有显式反例约束 — 原文"不使用 `npx skills update`,该命令可能更新用户安装的其他 Skill。"
- [ok] "回复 1"的语义绑定上一轮提醒 — SKILL.md 第二段与 skills/dbs/SKILL.md 都规定必须有上一条提醒上下文,否则不得解释数字含义。
- [ok] 时间戳缓存机制可回源 — check-update.sh 定义 CACHE_FILE="$DBS_DIR/update_check_at" 与 CACHE_TTL=86400,与 SKILL.md 的第 2 步配合。
- [ok] 更新日志/版本信息确实存在且为远端来源 — 仓库根 UPDATE.json(version 2.18.40 + notice)与 VERSION 文件存在;check-update.sh 默认从 raw.githubusercontent.com 读取。
- [ok] 是否读取用户凭证或存档内容 — 两条命令均不读取 ~/.dbs 内的存档/报告/决策记录(仅创建目录并写时间戳),无凭证读取。
- [ok] 是否创建后台任务/定时任务/Hook — 原文明确"不创建后台任务、定时任务或 Agent Hook。"
- [ok] 失败路径与网络依赖处理 — SKILL.md 要求按退出状态确认,失败时一句话说明原因与下一步,并要求不贴完整终端日志。
6結論
最適な用途: dbskill をインストール済みで、公式の32個のビジネス Skill を最新版に同期したいユーザーに適しています。また、「1 と返信」という更新通知を受け取った後にワンクリックでアップグレードを実行したい場合や、サードパーティ製 Skill に影響を与えずにメンテナンスを行いたいシーンにも適しています。
不向きな用途: 非公式 Skill の管理やアップグレードには不向き(本スキルは公式リポジトリのみを更新します)。バックアップを取らずにローカルのカスタマイズ版を保持したいユーザーには不向き。オフライン環境や npm 権限が制限された環境には不向き(失敗時は原因のみを提示し、オフライン手段は提供されません)。
Install Agent-Ready
① Verified Mirror 2026-09-15
Option A · Direct DownloadDownload dbs-update.tar.gz
sha256:
Option B · Copy Guide for Agent7d66b91d94084816…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit 8b8e33f1ec.