dbs-knowledge

1仕組みと動作原理

プロンプト編成のみによる「ナレッジベースエンジニアリング」スキル：固定された一連のファイル（SOURCE_OF_TRUTH.md / AGENTS.md / CLAUDE.md / CODEBUDDY.md / 各ディレクトリの README.md）を用いて通常のフォルダーを再構成し、ベクトル検索、RAG、外部データベースを導入することなく、エージェントが毎ターン辿れる構造を実現します。

中核となる成果物は追跡可能な呼び出しチェーン（エントリールール → SOT ナビゲーション → ディレクトリ README → 元ファイル）です。ナビゲーションは経路の案内に専念して事実自体は保持せず、質問への回答には必ず元ファイルを直接読み込みます。

SKILL.md は「作成（建）/ 保存（存）/ 利用（用）/ 検査（查）」の4つの意図に基づいてモードをルーティングし、内部モードへマッピングします。複数の意図がある場合は依存順序に従って処理します（まずファイルを登録し、その後に当該ファイルに依存する質問へ回答）。

書き込みには「段階的確認基準」を採用：読み取り専用の監査は自由に実行可能、対象が明確かつ軽微な変更は一言の指示で確認完了とみなしますが、移動・コピー・名前変更・上書き・削除・一括操作を伴う処理は必ずプレビューを提示してから実行します。

安全境界は「デフォルトで行わないこと」リストに固定：サードパーティへの非送信、原文の非改変、権威性の非推測、未確認の一括ファイル操作の禁止、シークレット・ブラウザデータ・チャット履歴の非読み込みを徹底します。

軽量更新は独立した高速パスとして機能：SOT のみを読み込み、必要な項目のみを変更します。その間、全リポジトリのスキャン、エージェントのエントリポイントの変更、無関係なファイルのついで整理は禁止されます。

ガバナンス（スリム化）モードでは「保持/統合/移行/削除」の4ルールを提示し、書き込み前に元のナビゲーションをナレッジベース内の .trash/ へバックアップすることを義務付け、そのバックアップが最新の権威バージョンにならないよう制御します。

ガバナンス後の検証を必須とし、「パスの存在」と「内容の権威性」を明確に区別：動的な事実（金額、価格、ステータス、担当者など）は必ず元ファイルを再読して照合します。

2コア機能

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

5二重目の独立検証

• [ok] 外部资源/工具：是否隐性依赖外部服务（RAG/向量库/云） — 全文唯一涉及「上传」的句子是禁止性的（不上传用户文件到第三方平台）；无任何 URL、包名、CLI 调用。所谓「知识库」完全由本地 markdown 约定实现。external_deps 空数组成立。
• [ok] 安全结论：写入面是否都被「确认门槛」覆盖 — 逐条核对：新建库（用户明确要求才建）、收录（库外默认复制并保留原件、重名不覆盖）、轻量更新（仅改对应条目，不动 Agent 入口）、治理（先预览、后备份、再写入）、迁移（先展示来源与目标、得到确认后复制，保留原文件）。未发现无门槛的破坏性写入条款。
• [ok] 实现原理是否成立：无索引技术如何保证「稳定查找」 — 查找稳定性由 SOT 的「快速查找表 + 目录职责表 + 版本与冲突规则」三件套承担，且要求路径经过存在性检查（完成标准：「`SOURCE_OF_TRUTH.md` 中的路径经过存在性检查」）。这依赖模型每次真的按导航找到并读原文；skill 用「不能只根据导航中的摘要作答」「证据不足时说明缺口，不根据常识补造本地事实」约束。结论：机制成立，但属 prompt 级保证，非机制级强制。
• [unlocatable] 证据定位：仓库级元数据（stars/last_push）与 installs — stars=10121、last_push=2026-09-07 来自站点池 data/pool.json（GitHub API 采集），pin 本地副本内无此数据；installs 全站未采集，记 null。license 可在仓库根 LICENSE 逐字命中。

6結論