1仕組みと動作原理
メインエントリは状態テーブルです。まず現在の対話と対象ディレクトリを読み取り、ワークフロー全体を一度に詰め込むのではなく、「現在のエビデンス」に基づいて読み込む references ファイルを1つだけ決定します。
skills/dbs-skill-maker/SKILL.md
| 只有一个想法，问题和完成态不清 | 形成问题契约与完成条件 | [references/problem-and-goal.md](references/problem-and-goal.md) |
ここでの処理内容：ステートマシン＋段階的開示によりコンテキストコストを抑制します。7行のルーティングテーブルで「アイデアから公開まで」のライフサイクル全般をカバーし、「テーブルを固定のアンケートに書き換えたり、ユーザーに1項目ずつ選択させたりしないこと」を明記しています。
スキルパッケージの構造を設計制約として扱います。共通の決定事項は SKILL.md に残し、条件付きの知識は references/ に、反復的かつ決定論的な操作は scripts/ に集約します。
skills/dbs-skill-maker/SKILL.md
**主入口保持轻。** `SKILL.md` 保存共同决策、关键流程和停止条件；条件性细节放进 `references/`，重复且确定的工作放进 `scripts/`。
この不変条件は、本skillに付属する5つの references と4つのスクリプトが存在する理由、およびその能力境界を直接説明しています。
デリバリーの規律は「問題から開始＋実ファイルを直接生成」であり、ソリューションの説明や空の骨組みを完成品と偽ることは認められません。
skills/dbs-skill-maker/SKILL.md
**从问题开始。** 先确定 Skill 反复解决什么问题、在什么情境使用、出现什么证据算完成。
関連する制約は「候補生成」セクションを参照してください。スクリプトは実際の内容を含んだ初稿のみを生成し、Agentは判断条件と境界を記述し終えてからデリバリーする必要があります。
実行可能スクリプトで決定論的タスクを担います。骨組みの初期化、構造検証、公開ステージング、npx インストール検証の4つのスクリプトがそれぞれ各フェーズを担当します。
skills/dbs-skill-maker/scripts/init_skill_project.py
Create a minimal single-Skill project without overwriting existing files."""
init スクリプトは既存ファイルを上書きしません。validate スクリプトは frontmatter/参照/リソース/スクリプトの静的チェックを実行します。prepare スクリプトはローカルのステージングのみに書き込みます。verify_npx_install.sh は一時的な HOME 環境で実際にインストールを行います。
検証スクリプトは未完了のプレースホルダーや疑わしいシークレットを遮断し、「骨組みだけの納品」や「シークレット漏洩」を機械的に検出可能な失敗へと変換します。
skills/dbs-skill-maker/scripts/validate_skill_project.py
UNFINISHED_MARKERS = ("[TODO", "TODO:", "FIXME", "{说明", "{写入", "{可观察", "<待填写>")
同ファイルには、公開前の遮断用として LOCAL_PATH_PATTERN（ローカル絶対パス）と SECRET_PATTERN（api_key/token/secret/password）の正規表現も含まれています。
検証は4段階に分かれており、実際に実行された最高レベルに応じてのみ表明が許可されます。構造検証を「検証済み」と偽装することは禁止されています。
skills/dbs-skill-maker/SKILL.md
未实际运行行为任务时，只能报告第 1 级。没有留出收益或出现关键回归时，不能宣称 Skill 已经变强。详细记录方式见 [references/evaluation.md](references/evaluation.md)。
4つのレベル：構造検証 → 振る舞いスモークテスト → ホールドアウト/リグレッション → GitHub npx インストールデリバリー。境界や近傍の反例をカバーする3〜6個のサンプルが必要であり、実行者は事前に答えを見てはなりません。
いかなるリモートの副作用も個別の認可が必要です。リポジトリの準備 ≠ push の認可獲得。
skills/dbs-skill-maker/SKILL.md
准备仓库不等于获得远端写入授权。执行 `gh repo create`、`git push`、创建 tag 或 Release 前，确认用户的明确要求能够覆盖该动作。
SKILL.md および references/github-publishing.md の両方で、gh repo create / git push / tag / Release はユーザーの明確な要求が必要なアクションとして定義されています。
公開パイプラインの実効性はスクリプトによって検証されます。隔離された一時 HOME 内で npx インストールを実行し、ソースディレクトリとインストール結果をファイル単位で cmp 比較します。
skills/dbs-skill-maker/scripts/verify_npx_install.sh
HOME="$temporary_home" "$skill_maker_npx" -y skills add "$source_locator" -g --all
スクリプトはシンボリックリンクを含むソースディレクトリを拒否し、frontmatter の name を検証し、SKILL.md/agents/references/scripts/assets をファイル単位で比較し、終了時に一時ディレクトリをクリーンアップします。
公開前のステージング規律を厳格なルールとして定めています。git add . / git add -A を禁止し、明示的なパスでのみステージングします。
skills/dbs-skill-maker/SKILL.md
不使用 `git add .` 或 `git add -A`；发布时只暂存明确文件。
github-publishing.md の「リリースゲート」では、diff、未追跡ファイル、シークレット、個人パス、および evals/ の確認をさらに要求しています。
2コア機能
01要件分析：繰り返し発生する問題を問題契約（コンテキスト、推進すべき変化、完了のエビデンス、扱わない近傍の問題）として記述
02振る舞い契約：「使いやすい／プロフェッショナル」といった形容詞を、観察可能な必須行動と禁止行動に書き換え
03メカニズムの選択：判断アクションをまず分解し、理論、ルール、素材、スクリプトが必要かを決定
04ワンクリックでのSkillプロジェクト骨組み生成（init_skill_project.py、実コンテンツを含む初稿付き、既存ファイルは上書きしない）
05構造の静的検証（validate_skill_project.py：frontmatter、参照、リソース、未完了プレースホルダー、シークレット/ローカルパス）
06段階的な振る舞い検証：正例/境界/近傍の反例/ホールドアウトをカバーする3〜6個のサンプルを用い、実際の最高レベルでレポート
07GitHub公開準備およびインストール検証（ステージングディレクトリ + 隔離環境での npx インストール + ファイル単位比較）
08ローカルデリバリーレポートチェックリスト（パス、境界、生成ファイル、実行済み検証、未検証リスク、呼び出し方法）
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| cli | python3（运行自带 scripts/*.py；纯本地，无网络） |
| package | skills —— 生态官方安装器包（仅发布验证脚本经 npx -y 拉取执行） |
| cli | git / gh（仅发布流程，且需用户授权；凭据由宿主 CLI 自理） |
| network | GitHub（远端仓库创建/推送）与 npm registry（npx 取包） |
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠（ファイルパスと抜粋）
- scripts/: ローカルスクリプトまたはコマンドの実行: python3 scripts/init_skill_project.py <skill-name> --output <親ディレクトリ>（新規Skillの生成）
- 外部 API: 外部プラットフォームに対する投稿、リソース作成、または書き込みの実行
- 本地工作目录: ファイルの読み書きと成果物の出力: ユーザー指定の親ディレクトリにおける新規Skillディレクトリおよびファイルの作成（init_skill_project.py、既存の実ディレクトリの上書きを拒否）
監査ノート： 判定根拠はすべて本skillディレクトリ内の実際の振る舞いに基づいており、自己証明可能です。3つのPythonスクリプト（init_skill_project.py / validate_skill_project.py / prepare_github_repo.py）はローカルファイルの作成と静的検証のみを行い、ネットワークアクセスや認証情報の読み取りは行いません。唯一の外部送信は公開パイプラインにあり、付属スクリプト scripts/verify_npx_install.sh に `HOME="$temporary_home" "$skill_maker_npx" -y skills add "$source_locator" -g --all` が含まれ、エコシステム公式インストーラー npx skills 経由で公開レジストリ/GitHubからパッケージを取得・インストールしてファイル単位で比較します。また references/github-publishing.md に基づき、ユーザー認可のもとで git/gh によるリモート公開を実行します（「認可が不明確な場合は、push、tag、またはReleaseの前に停止する」）。これは「公式CLIによる予測可能で低リスクな外部送信」に該当し、ユーザーの素材やプロンプトを生成バックエンドに送信せず、サードパーティの生成サービスを明示せず、skill自体のスクリプトも認証情報やプライベートトークンを読み取らないため、🟠 ではなく 🟡 に該当します。
5二重目の独立検証
- [ok] SKILL.md 的状态路由表真实存在且引用文件齐全 — 7 行路由表引用的 5 个 references 文件全部存在于 skills/dbs-skill-maker/references/。
- [ok] 四个脚本各自用途与宣称一致 — init/validate/prepare 三个 python 脚本 + 1 个 bash 安装验证脚本，均实读确认；validate 内确有 subprocess 用于 py 语法检查。
- [ok] "准备仓库不等于获得远端写入授权"可定位 — SKILL.md「GitHub 发布边界」节原文含该句；github-publishing.md「授权边界」节给出同义规则。
- [ok] 安装验证不是文字检查而是真装 — verify_npx_install.sh 用 mktemp 临时 HOME 执行 npx skills add，并逐文件 cmp 源目录与安装结果，输出"安装验证通过"计数。
- [ok] 网络/远端依赖清单无遗漏 — 目录级扫描仅命中 npx（verify 脚本与 SKILL.md 安装命令）、git/gh、GitHub/npm 相关文本；三个 python 脚本无 urllib/requests/socket 调用。
- [ok] 是否读取用户凭证 — 三个 python 脚本均无读取 ~/.gitconfig、gh 配置或 env 中 token 的代码；SECRET_PATTERN 仅用于扫描候选文件中的疑似密钥以拦截外泄。
- [ok] "不覆盖现有真实目录"是否属实 — init_skill_project.py docstring 为 "Create a minimal single-Skill project without overwriting existing files."，并含同名冲突检查。
- [ok] 分级验证等级表与"只能报第 1 级" — SKILL.md「未实际运行行为任务时，只能报告第 1 级。」与四级表格并存，无夸大表述。
6結論
最適な用途： 繰り返し発生する問題をインストール可能かつ再利用可能なSkillとして蓄積したい個人のクリエイターやエンジニアリングユーザーに適しています。また、候補Skillに対して構造検証や段階的振る舞い検証（ホールドアウトサンプル含む）を行いたいメンテナー、およびSkillをGitHubに公開して npx skills add 経由で配布・デリバリーしたい共有シナリオにも適しています。
不向きな用途： 特定のビジネス課題を単発で解決したいだけのユーザーには不向きです（それは業務Skillの役割であり、メタSkillの役割ではありません）。問題契約や完了のエビデンスを提供せず「テンプレート／枠組み」だけを求めるシナリオには不向きです（本Skillは骨組みだけの納品を明確に拒否します）。「検証済み」を品質保証と見なす期待には適しません。ユーザーの認可がない場合はGitHub公開プロセスに進むべきではありません。
Install Agent-Ready
① Verified Mirror 2026-09-15
Option A · Direct DownloadDownload dbs-skill-maker.tar.gz
sha256:
Option B · Copy Guide for Agente296c070f776d446…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit 8b8e33f1ec.