ドキュメント&知識ベース · dontbesilent2025/dbskill

dbs-report

複数の dbs-save アーカイブを成果物としての Markdown レポートに統合します。ユーザーが診断の要約、レポートの整理、共有可能な資料の作成を求めた場合に使用します。

L3 ネットワーク · ドメインとキー範囲を宣言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仕組みと動作原理

プロンプトのオーケストレーションのみによる「成果物ジェネレーター」:入力は dbs-save で保存されたアーカイブ markdown、出力はタイムスタンプ付きの新規レポート markdown であり、全工程で読み込み、統合、分類、転記のみを実行

skills/dbs-report/SKILL.md
报告内容必须来自 `{存档根目录}/sessions/{项目名}/` 下的存档文件。
リポジトリの README.md では「長期的な意思決定の記録と振り返り | /dbs-decision、/dbs-save、/dbs-restore、/dbs-report」と位置付けられています。

dbs-save/dbs-restore と共通のアーカイブ ルートディレクトリ解決ルール(.dbs/config.json の default/project/custom の3モード)を使用し、3者とも設定の読み取りのみを行い書き込みは行わない

skills/dbs-report/SKILL.md
`dbs-report` 只读取配置,不修改配置。
解決に失敗した場合や、パスが /、ホームディレクトリ、またはプロジェクトルートを指している場合は、「レポート生成を中断して設定の問題を説明」し、デフォルト位置へのサイレントなフォールバックは行いません。

信頼性は「優れた要約」ではなく「追跡可能性」に依存:コア原則の第1項で会話からの根拠のない要約を禁止し、すべての内容は特定のアーカイブの特定のフィールドに紐付け可能である必要がある

skills/dbs-report/SKILL.md
**不从对话凭空总结**。报告内容必须能追溯到具体存档文件的具体字段。这是报告的可信度
そのため、レポートの6つのセクションのうち5つは転記+重複排除+分類であり、「ユーザーの主訴の変遷」セクションのみ簡潔な要約が許可されています。

複数回実行しても上書きせず、タイムスタンプによって「診断スナップショットの比較」能力を保持

skills/dbs-report/SKILL.md
每次新生成一份,**永不覆盖**。文件名带时间戳,方便对比不同时点的诊断快照。
パスルール:{アーカイブ ルートディレクトリ}/reports/{プロジェクト名}/{YYYYMMDD-HHMMSS}-{プロジェクト名}.md。ディレクトリが存在しない場合は事前に mkdir -p を実行。

結論の衝突に対して仲裁を行わない:新旧両方を記載し、新しいものを前に配置、古いものには「(以降の診断により修正済み)」と明記

skills/dbs-report/SKILL.md
如果一条结论在后续存档里被推翻或修正,**两条都列出来**,新的在前,旧的在后并加 `(已被后续诊断修正)` 标注。
「複数アーカイブ間での結論の衝突 → すべて記載する」ことがエッジケースに明記されています。

意図的にマスキングを行わない:アーカイブ内のセンシティブな数値や顧客名はそのままレポートに出力され、マスキングの責任は dbs-save の段階に委ねられる

skills/dbs-report/SKILL.md
存档文件里有用户标的「敏感信息」(比如真实收入、客户名字)→ 报告原样保留。不做脱敏。
スキル側の理由は「ユーザー自身が保存したものであるため」であり、成果物の形式も絞り込まれており、自発的に PDF/HTML を出力することはありません。

データ量に下限の基準を設ける:0件は即座に拒否、1件はまず思いとどまらせ強制するか確認、≥2件で初めて統合を開始(--since フィルタ後も同様に判定)

skills/dbs-report/SKILL.md
0 个文件 → 「`{项目名}` 下还没有可汇总的存档。
情報量のない空のレポートや、単一ファイルレポートによる見せかけの統合成果物の出力を防止します。

dbs-wechat-html との連携は条件付き:ユーザーに明確な公開ニーズがある場合にのみ1度提示し、ニーズがない場合は提示しない

skills/dbs-report/SKILL.md
想发公众号或群里,可以用 `/dbs-wechat-html` 把这份 markdown 转成微信后台粘贴版。
元の前提条件:「ユーザーがレポートを公式アカウントやグループに公開する必要がある場合は一文追加する」;後置条件:「ユーザーに公開ニーズがない場合は追加しない」。

2コア機能

01複数アーカイブの統合:YYYYMMDD-HHMMSS の昇順で読み込み、frontmatter と本文の6セクションを解析
02レポートの6セクション構成:主訴の変遷 / 確認済み結論 / 却下された方針 / 現在未解決の課題 / 推奨される次のステップ / アーカイブ索引表
03結論の重複排除と修正アノテーション(意味が近いものの統合、時系列逆順の並び替え、覆された両方の結論を保持)
04日付フィルタリング --since およびプロジェクト切り替え --slug
05未解決課題の集約:in-progress アーカイブの検証待ちの仮説 + 最も初期のアーカイブで提示されながら一度も対処されていない方針を統合
06次のステップの優先順位付け(最新優先 / 繰り返し出現しながら未着手 / 代替済みの注記)
07ステータスフィールドの中国語表示(in-progress/resolved/abandoned → 进行中/已结论/已放弃)
08ディレクトリを越えたプライベートファイルの検索は行わない:現在の設定が指す sessions ディレクトリ内でのみ動作

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

安全運用のための推奨統制措置
Agent 向け
アクセス可能ドメインとキー範囲を宣言
管理者向け
最小権限のキー、リクエストログを保持
判定根拠(ファイルパスと抜粋)
  • 环境变量 / API Key: ベンダーサービス認証情報の読み込み: アーカイブ ルートディレクトリ(mode=default/project/custom + root)を解決するために .dbs/config.json を読み取る — これはユーザー自身の設定です
  • 本地工作目录: ファイルの読み書きと成果物の出力: {アーカイブ ルートディレクトリ}/reports/{プロジェクト名}/{YYYYMMDD-HHMMSS}-{プロジェクト名}.md(新規レポート、上書きなし;ディレクトリが存在しない場合は mkdir -p)
監査ノート: 判定対象は本スキル自身のディレクトリです。スクリプトなし、ネットワークエンドポイントなし、認証情報の読み取りなしですが、SKILL.md はローカルアーカイブを読み込んで新規レポートファイル({アーカイブ ルートディレクトリ}/reports/…md)を出力することをエージェントに明確に要求しており、「ローカル読み書きのみ、外部送信なし」の分類に該当します。注意点はコード実行ではなくプライバシーに集中しています。レポートは意図的にマスキングを行わず(売上、顧客名はそのまま保持)、成果物は「共有可能な資料」です。レポートを外部に送信した場合、アーカイブ内のセンシティブな詳細情報もすべて渡すことになります。スキル側はエッジケースにおいてこのスタンスを明示しています。

5二重目の独立検証

  • [ok] 外部资源/工具:是否存在未声明的依赖或格式转换器 — 无 URL、无包、无 CLI 调用;PDF/HTML 相关语句只有禁止性的(不主动出 PDF / HTML / 其他格式)。external_deps 空数组成立。
  • [ok] 安全结论:写入面是否只有报告文件 — 全文写入只有 mkdir -p 与报告文件生成;明确不修改 .dbs/config.json(「只读取配置,不修改配置」),不删除任何存档,不改写原始 sessions 文件。
  • [ok] 实现原理是否成立:报告能否真正做到「每条可追溯」 — 六段中五段规定逐条携带来源(「· 出自 {对应存档的标题} · {对应日期}」)、附录给出文件名索引表,「结论冲突两条都列」避免丢失信息。机制可核查。
  • [ok] 功能声明 vs 实际能力是否存在夸大 — description 只说「合并成可交付的 Markdown 报告」,未承诺分析深度或结论质量;SKILL.md 亦把「总结」限制到一段。一致。
  • [unlocatable] 证据定位:仓库级元数据(stars/last_push)与 installs — stars=10121、last_push=2026-09-07 来自站点池 data/pool.json(GitHub API 采集),pin 本地副本无法逐字定位;installs 未采集记 null。license 可在仓库根 LICENSE 逐字命中。

6結論

  • 「診断記録」を「納品可能物」へ変換:6セクション構成 + 索引表 + タイムスタンプ付きファイルにより、パートナーや外部コンサルタントへの直接共有や月次を跨ぐ振り返りに利用可能
  • 信頼性重視の設計:根拠のない要約の禁止、各セクションへの出所明記、衝突する両結論の併記、ステータスフィールドのローカライズ表示——成果物はアーカイブの照合に適しています
  • 不変の成果物:毎回新規ファイルを作成し上書きしないため、レポート自体が比較可能な時系列データとなる
  • ストレージサブシステム(dbs-save/dbs-restore)と設定解決ルールを共有し、パスと文言の一貫性を保つことで、ユーザーは「アーカイブ ルートディレクトリ」の概念を一度理解するだけで済む
  • 抑制的:成果物フォーマットを能動的に変更しない(markdown のみ)、隣接スキルを能動的に売り込まない(公開ニーズがある場合にのみ dbs-wechat-html を1度提示)
  • 最適な用途: 同一プロジェクトの長期的な診断を行い、分散した結論を外部向け資料にまとめる必要があるユーザーに最適:パートナー/コンサルタント/クライアント向けの照合文書、定期的な振り返り、月次を跨ぐ結論の変遷の追跡。dbs-save / dbs-restore と組み合わせることで、「保存—再開—出力」の完全なワークフローを構築します。
    不向きな用途: アーカイブがない状態で AI に「これまでの会話をまとめて」と求めるシナリオには不向き(本スキルは根拠のない要約を明確に禁止しており、先に拒否します);マスキングを行って外部公開するワークフローには不向き(意図的にマスキングを行いません);PDF/HTML/PPT などの完成品としての成果物を求める納品要件には不向き(markdown のみを出力し、自発的なフォーマット変換は行いません);単一のアーカイブのみを確認したいシナリオには不向き(1件の統合は思いとどまるよう促されます)。
    Install Agent-Ready
    ① Verified Mirror 2026-09-15
    Option A · Direct DownloadDownload dbs-report.tar.gz
    sha256: 1daf478be83e49ea…
    Option B · Copy Guide for Agent
    install.json
    Agent はこの JSON ガイドから自動的にダウンロードして検証します。
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit 8b8e33f1ec.