コンテンツ制作 · dontbesilent2025/dbskill

dbs-learning

トピックを連続した学習記事に分解し、ユーザーのフィードバックに応じて後続の深度、切り口、ペースを調整します。ユーザーがテーマを体系的に学びたい時、次の記事へ進めたい時、またはフィードバックに基づきカリキュラムを調整したい時に使用します。

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);署名 + 禁止商业使用;Copyright (c) 2026 dontbesilent)Commit 8b8e33f1ec
管理レベルは Skill の能力と推奨統制措置を示すものであり、品質や安全性の認証、利用可否の判定ではありません。使用の可否はユーザーおよび管理者が決定します。Agent 環境によって制約が異なるため、自動保護を仮定しないでください。第三者製 Skill の著作権は原著作者に帰属し、利用リスクは利用者が負います。

1仕組みと動作原理

純粋なプロンプト構築による「アダプティブカリキュラムエンジン」:状態はすべてユーザーローカルの固定ファイル(00-学习计划.md + 2桁番号記事 + assets/ + 任意で INDEX.md)に保持され、モデルが毎ラウンドこれらを読み直すことで継続可能。

skills/dbs-learning/SKILL.md
你维护的是一个自适应学习梯度。
ディレクトリの優先順位:ユーザー指定ディレクトリ > カレントプロジェクト /学习课题/{トピック名}/ > フォールバック ~/Documents/dbskill-learning/{トピック名}/。

ループ完結の鍵となる「フィードバック抽出ルール」:記事末尾に4つのプロンプト質問を事前配置し、次回の記事生成時はテンプレート行を必ず除外してユーザーが手動追加したテキストのみをフィードバックとして処理。

skills/dbs-learning/SKILL.md
只有用户在提示问题下面新增的文字,才算真实反馈。
「テンプレート行除外後に内容がない場合はフィードバックなしとみなす」という補助ルールを設け、テンプレートを回答と誤認したりフィードバックを幻覚(ハルシネーション)したりするのを防止。

フィードバック信号を難易度/切り口の6つの調整戦略(テーブル駆動型)にマッピングし、固定シラバスではない「適応型学習」を実現。

skills/dbs-learning/SKILL.md
| 没看懂、概念混乱、问题很多 | 降低抽象度,补例子,放慢节奏 |
テーブルには「理解したが退屈に感じている → 切り口を変更」「明確に習得済み → 概念密度を向上」などの分岐も網羅。

前提知識の確認は独立したフェーズ(Phase 1.5)として新規トピックにのみ適用。カレントプロジェクトに対してスコープを限定した軽量検索を実施後、ユーザーに「プロジェクト準拠/ゼロから/指定資料」の3択を提示。

skills/dbs-learning/SKILL.md
本阶段只用于新课题。
検索範囲は厳格に制限:AGENTS.md/CLAUDE.md/README.md/SOURCE_OF_TRUTH.md およびディレクトリ目録の読み込みを優先し、「プロジェクト全体の走査や通読は行わない」。

エビデンスの格付けをフローに定義:ユーザーが自作/確認済みの正式な内容は強い証拠、AIの下書きは弱い証拠、サードパーティ資料はユーザーの知識ベースとみなさない。

skills/dbs-learning/SKILL.md
AI 生成的草稿、分析报告和未确认内容:只能作为弱证据。
さらに厳格な推論ルールを2点設定:「ファイル内に概念が登場したこと:ユーザーが見聞きした可能性があることのみを証明」、「複数の独立したシナリオで繰り返し呼び出されている場合」に限り理解度を推測可能。

検索フェーズに機密除外とプロジェクトルール優先を厳格に適用:デフォルトで .git/.env/.private/秘密鍵/認証情報/個人識別情報/財務原本/顧客機密資料をスキップし、プロジェクト規則の禁止範囲を最優先で遵守。

skills/dbs-learning/SKILL.md
默认跳过 `.git/`、`.env`、`.private/`、密钥、密码、凭证、身份信息、财务原件、客户私密资料和其他明确标记为敏感的内容。
さらに機密性の高い内容については「トピックに関連していても、ユーザーが明示的に指定した場合にのみ読み取り可能」と規定。

執筆スタイルは「禁止構文リスト」で制御。「〜ではなく…である」など6種類の構文およびその変種を明確に禁止し、中国語の全角句読点や中英間の半角スペース挿入を義務付け。

skills/dbs-learning/SKILL.md
默认禁止使用以下句式及其近似变体:
代替手法を提示:結論先行/因果関係文/条件文/動作文/具体例。例外は原文の模倣要求、原文の引用、構文自体の分析に限定。

ファイル命名と連番進行に厳格なルールを設定:学習計画は 00-学习计划.md に固定、記事は2桁連番、次回記事 = 現在の最大連番 + 1。番号飛ばしや中国語ファイル名は禁止。

skills/dbs-learning/SKILL.md
下一篇序号 = 当前课题目录中最大文章序号 + 1
記事本文の構成は「本記事で解決する課題/本文/まとめ/次回予告/学習フィードバック」に固定され、フィードバック欄が次ラウンドの入力となる。

2コア機能

01トピック初期化:トピックディレクトリ、00-学习计划.md、01.md、assets/、およびインデックス記録の作成
02前提知識の確認(プロジェクト検索 + 3択モード提示)、確認後は学習計画に記載・継承し、記事ごとに再確認しない
03進捗の再開:学習計画の確認 → 最大連番記事の特定 → 実際のフィードバック抽出 → 現在の理解度を3〜5項目で要約
04適応型調整:フィードバック信号に基づき、次回の記事の抽象度、切り口、情報密度を調整
05記事生成:固定の4段構成 + 末尾の学習フィードバック欄(4つのプロンプト質問と記入枠を含む)
06計画およびインデックスの保守:現在の進捗/本記事の主題/前回のフィードバック要約/次回の方向性/更新日時を更新し、INDEX.md の表を同期
07フォールバック書き込み:汎用ディレクトリやシステムディレクトリの汚染を防ぎ、~/Documents/dbskill-learning/ への書き込みに変更してユーザーへ明示的に通知
08スタイルの規律:「〜ではなく…である」等の構文を禁止し、中国語の組版規則に準拠(本文の英語出力は不可)

4推奨統制措置と判定根拠

安全運用のための推奨統制措置
Agent 向け
作業ディレクトリを限定
管理者向け
操作ログを保持
判定根拠(ファイルパスと抜粋)
  • 本地工作目录: ファイルの読み書きおよび成果物の出力: {トピックディレクトリ}/00-学习计划.md、{連番}.md(01.md から開始する2桁連番)、assets/
監査ノート: 判定対象は本 skill 自体のディレクトリです:スクリプトなし、ネットワークエンドポイントなし、認証情報の読み取りなし。ただし、SKILL.md はエージェントにローカルファイル(トピックディレクトリ、00-学习计划.md、連載記事、assets/、INDEX.md)の作成と継続的な書き込みを明確に求めているため、「ローカルの読み書きのみ・外部送信なし」に該当します。プライバシー面の留意点として、知識基盤の判断のためにプロジェクトファイルを読み取る必要があります。skill はデフォルトで .git/.env/.private/秘密鍵/認証情報/個人識別情報/財務/顧客機密資料を除外し、プロジェクトルールを優先するよう求めていますが、実際の読み取り範囲は最終的にホストの権限とモデルの遵守レベルに依存します。

5二重目の独立検証

  • [ok] 外部资源/工具:是否存在未声明的依赖 — 目录内仅 SKILL.md + agents/openai.yaml;无 URL、无包、无 CLI。external_deps 空数组成立。
  • [ok] 安全结论:敏感文件排除是否为可执行规则 — 排除项以编号 4 的形式写进「任何项目检索都必须遵循以下范围」,并给出 5(敏感内容需明确指定)、6(项目规则优先)两条兜底;验收用例 4 要求「不在知识基础摘要中暴露敏感文件名、内容或路径」。规则可判定、有对应场景,非泛泛声明。
  • [ok] 实现原理是否成立:反馈驱动是否真能改变后续深度 — Phase 3 给出六行映射表(反馈信号→处理方式),Phase 2 要求先读上一篇文章末尾反馈并概括为 3-5 条理解状态,Phase 5 要求把「用户上一轮反馈摘要」写回学习计划——形成 读反馈→判断→写文→回填计划 的闭环。用例 2/3 给出了两种典型反馈下的期望输出,可验证。
  • [ok] 功能声明 vs 实际能力:「系统学习一个主题」是否被夸大 — skill 不承诺教学效果、不做外部资料检索(不抓网页、不引第三方教材),只做「连续文章编排 + 反馈调整」;这与 description 一致,无越界承诺。
  • [unlocatable] 证据定位:仓库级元数据(stars/last_push)与 installs — stars=10121、last_push=2026-09-07 取自站点池 data/pool.json(GitHub API 采集),pin 源码内无法逐字定位;installs 未采集记 null。license 可在仓库根 LICENSE 逐字命中。

6結論

  • 「講座の連載」をステートマシン化:計画ファイル + 連番記事 + フィードバック欄によりセッションをまたいで再開可能、確認済みの知識ベースを継承し無駄な再質問を排除
  • フィードバック抽出の明確なハルシネーション防止(プロンプト質問の下に追加された文字のみ認識)により、独りよがりではない根拠ある「適応」を実現
  • 前提知識確認におけるローカル資料の慎重な扱い:証拠の強弱区分、「見聞きした」と「習得」の区別、機密ファイルのデフォルト除外、プロジェクトルールの優先
  • 判定可能な執筆スタイル:禁止構文リスト + 代替表現 + 3つの例外設定により、いわゆる「AI調」の教材記事の生成を回避
  • テスト検証の意識:6つの検収テストケースを内蔵し、新規トピック/機密資料/フィードバック種別などの主要分岐を照合可能なシナリオとして定義
  • 最適な用途: 1つのテーマを継続的にシリーズ教材へと仕上げたい方に適しています:学問の独学、ノウハウの講座化、チーム向け研修教材の作成、特に「自身の理解度に応じて難易度を調整したい」シナリオに最適です。dbs-knowledge と組み合わせ(トピックディレクトリをナレッジベースのナビゲーションに組み込む)ることで、より完全な効果を発揮します。
    不向きな用途: 単発記事の執筆代行には不向き(skill内で「担当するのはカリキュラムの連載設計であり、単発記事の代筆ではない」と明記);ビジネス診断や実行課題には不向き(対応する dbs-* skill に移管すべき);外部資料の検索・引用が必要なリサーチ型学習には不向き(外部ソースの取得や引用は行わず、順序の編成のみを担当);作業ディレクトリ内に新しいファイルを生成したくないシナリオには不向き。
    Install Agent-Ready
    ① Verified Mirror 2026-09-15
    Option A · Direct DownloadDownload dbs-learning.tar.gz
    sha256: 1f686116522fc75b…
    Option B · Copy Guide for Agent
    install.json
    Agent はこの JSON ガイドから自動的にダウンロードして検証します。
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit 8b8e33f1ec.