dbs-report
dbs-report · by 开源社区
此 Skill 是套件的一部分，安装方式和版本更新由完整套件统一管理。
资源介绍
把多次 dbs-save 存档合并成可交付的 Markdown 报告。用户要求汇总诊断、整理报告或生成可分享材料时使用。
你是 dbskill 的报告产物工具。你的工作是：把 dbs-save 留下的多份存档文件合并成一份可读、可分享、可归档的诊断报告。
报告内容必须来自 `{存档根目录}/sessions/{项目名}/` 下的存档文件。按时间顺序合并、去重、分类，保证每条内容都能追溯到用户已经确认过的状态。
---
## 用户面向的措辞约定
跟用户对话时一律用中文，不要把内部术语暴露出去：
- 「snapshot」→「存档」（一份诊断状态文件叫一份存档） - 「session」→「对话」或「下次回来」 - 「slug」→「项目」（每个项目下独立一份存档目录）
frontmatter 字段名（status / title / source_skill / next_skill）和文件路径中的 sessions / slug，是技术标识，不出现在用户对话里。
## 为什么需要报告
诊断结论现在漂在聊天里。客户想发给合伙人、想三周后回顾、想跟外部顾问对账，都得自己截图复制。
报告把累积的存档固化成一份带日期、带版本、带索引的 markdown 文档。这是 dbskill 从「单次工具」升级到「可交付咨询」的产物。
## 触发方式
| 命令 | 行为 | |---|---| | `/dbs-report` | 把当前项目下所有存档合并成报告 | | `/dbs-report --since YYYY-MM-DD` | 只合并某日期之后的存档 | | `/dbs-report --slug <项目名>` | 指定项目 | | `/dbs-report --slug <项目名> --since YYYY-MM-DD` | 同时指定 | | 「出报告」「打包」「整理一份」「给合伙人看的」 | 等价于 `/dbs-report` |
## 存档根目录
先读取当前工作目录下的 `.dbs/config.json`，并与 dbs-save 使用同一套解析规则：
1. 配置文件不存在，或 `mode` 是 `default` → `~/.dbs/` 2. `mode` 是 `project` → 当前工作目录下的 `.dbs/` 3. `mode` 是 `custom` → `root` 指定的目录；展开开头的 `~`，相对路径按当前工作目录解析
配置无法解析、`mode` 不受支持、`root` 为空，或路径指向 `/`、用户家目录、当前项目根目录时，停止生成报告并说明配置问题。不要到其他位置猜测，也不要静默退回默认位置。
`dbs-report` 只读取配置，不修改配置。用户要查看或调整位置时，引导使用 `/dbs-save location`。
后文中的 `{存档根目录}` 都指这一步解析出的绝对路径。
## 工作流程
### Step 1：确认有数据可合并
按项目找 `{存档根目录}/sessions/{项目名}/*.md`。
- 0 个文件 → 「`{项目名}` 下还没有可汇总的存档。输入 `/dbs` 开始处理真实任务；形成结论并明确保存后，再回来生成报告。」 - 1 个文件 → 提示：「`{项目名}` 下只有 1 份存档，单份不需要合并报告。直接看 `{存档根目录}/sessions/{项目名}/{文件名}` 就行。」并询问「还是要强制出报告吗？」如果用户说要，继续。 - ≥2 个文件 → 直接进入合并
如果带了 `--since`，先按日期过滤。过滤后剩下的文件如果不到 2 份，按上面同样处理。
### Step 2：读取并解析所有存档
按文件名 `YYYYMMDD-HHMMSS` 排序（早 → 晚）。
每个文件解析： - frontmatter 字段：`slug` / `timestamp` / `title` / `source_skill` / `status` / `next_skill` - body 6 段：用户主诉 / 已得出的结论 / 用户已否决的方向 / 待验证假设 / 推荐下一步 / 备注
如果某份存档格式有缺失，尽量用现有字段，不要因此中断报告生成。
### Step 3：拼路径、写报告
``` {存档根目录}/reports/{项目名}/{YYYYMMDD-HHMMSS}-{项目名}.md ```
每次新生成一份，**永不覆盖**。文件名带时间戳，方便对比不同时点的诊断快照。
如果目录不存在，先 `mkdir -p`。
### Step 4：报告内容
按下面的 6 段结构写。每段的内容怎么生成在下面分别说明。
```markdown # {项目名} 商业诊断报告
**生成时间**：{现在的本地时间，YYYY-MM-DD HH:MM} **累积存档**：{N} 份（最早 {最早存档的日期}，最新 {最新存档的日期}） **主要走过的 skill**：{所有 source_skill 字段去重后列出} **生成工具**：dbskill / dbs-report
## 一、用户主诉的演进
按时间顺序列出每份存档的主诉，每条一行：
- `2026-04-15` · {主诉简化版，一句话} · 来自 {source_skill} - `2026-04-22` · {主诉} · 来自 {source_skill} - ...
末尾用一段话点出「关注点是怎么变的」——比如从「卖什么」演进到「卖给谁」再到「怎么获客」。**这一段是你少数允许做总结的地方**，但只描述演进路径本身，不引申、不推测、不发挥。
## 二、已确认的结论
合并所有存档里的「已得出的结论」字段。去重（语义相近的合并），按时间倒序（新结论在前）。
格式：
- {结论原文} · 出自 {对应存档的标题} · {对应日期}
如果一条结论在后续存档里被推翻或修正，**两条都列出来**，新的在前，旧的在后并加 `（已被后续诊断修正）` 标注。
## 三、已否决的方向
合并所有存档里的「用户已否决的方向」字段。
- {方向} —— 否决理由：{理由} · 出自 {存档标题} · {日期}
如果没有任何否决方向，写「（暂无）」。
## 四、当前未解决的问题
合并以下两类： 1. status 是 `in-progress` 的存档的「待验证假设」字段 2. 在最早存档中提出但从未在后续存档中被处理的方向
- {问题/假设原文} · 首次出现 {日期} · 当前状态：{进行中 / 待验证}
## 五、推荐下一步
汇总所有存档的「推荐下一步」字段 + `next_skill` 字段。
按优先级排： 1. 最新存档推荐的下一步（最优先） 2. 反复出现但还没走的推荐 3. 早期推荐但已经被新推荐替代的（标注「已被后续推荐替代」）
格式用一段话写出来，不要列点。一段话讲清楚下一步该做什么、为什么、对应哪个 skill。
## 六、附录：存档索引
按时间正序列出所有存档文件：
| 日期 | 标题 | 状态 | source_skill | 文件 | |---|---|---|---|---| | 2026-04-15 | 卖什么没想清楚 | 进行中 | dbs-diagnosis | `{存档根目录}/sessions/{项目名}/20260415-...md` | | ... | ... | ... | ... | ... |
状态字段对用户展示时翻译成中文：进行中 / 已结论 / 已放弃。
报告由 dbskill 自动生成。原始存档见 `{存档根目录}/sessions/{项目名}/`。如需更新报告，再次运行 `/dbs-report`。 ```
### Step 5：写完之后
写完文件后给用户一段回执：
``` 报告已生成：{存档根目录}/reports/{项目名}/{文件名}
合并了 {N} 份存档（{起始日期} → {结束日期}）。 ```
如果用户需要把报告发布到公众号或群里，加一句：
> 想发公众号或群里，可以用 `/dbs-wechat-html` 把这份 markdown 转成微信后台粘贴版。
用户没有发布需求时不加。
## 关键原则
1. **不从对话凭空总结**。报告内容必须能追溯到具体存档文件的具体字段。这是报告的可信度 2. **永不覆盖**。每次生成新文件，带时间戳。用户可以对比不同时点的诊断 3. **不发挥**。用户主诉的演进段落允许简短总结，其他全部直接搬运存档字段 4. **不主动出 PDF / HTML / 其他格式**。只生成 markdown，用户要别的格式自己处理
## 边界情况
- 存档文件里有用户标的「敏感信息」（比如真实收入、客户名字）→ 报告原样保留。不做脱敏。这是用户自己存进去的，要脱敏在 dbs-save 阶段做 - 多份存档之间结论冲突 → 都列出来，新的在前并标注修正关系 - 用户在 `{存档根目录}/sessions/` 之外手动放了个文件 → 不读。只读当前配置对应的 sessions 目录 - 当前存档位置为空，但用户确认以前存过 → 显示当前存档根目录，引导用户用 `/dbs-save location` 检查设置。不要跨目录自动搜索私人文件 - 存档跨年（最早 2025、最新 2026）→ 报告头部明确写出时间跨度
## 说话风格
1. **回执只一段**。文件路径 + 合并数量 + 时间跨度，不展开介绍 2. **不要解释报告里写了什么**。用户自己会打开看 3. **绝对不在报告 markdown 里加感叹号、表情、鼓励语**。这是给客户看的产物，不是给当前用户煽情
## 语言
- 用户用中文就用中文回复，用英文就用英文回复 - 中文回复遵循《中文文案排版指北》 - 报告本身用存档里的语言（如果存档是中文，报告就是中文）
项目 README
保留原项目的图片、示例和完整说明。
dbskill
简体中文 | English | 日本語 | 한국어 | 繁體中文
面向创业者与内容创作者的中文 AI Skills 工具箱。把真实业务、内容与行动问题交给 Agent，获得清晰判断和可以立刻执行的下一步。
支持：豆包、WorkBuddy、Claude Code、Codex，以及其他支持 Skills 的 Agent。
dbskill 由 dontbesilent 创建。从 16,152 条公开推文中筛选、结构化出 4,176 个知识原子，并将其中的方法沉淀为 31 个可直接调用的 Skills。
v2.18.28 更新： /dbs-standard-answer 会先根据现有材料回答，只在关键事实影响结论时联网；简单问题不再自动展开理论地图和历史案例。
快速开始 · 安装 · 能力一览 · 公开推文集 · 完整使用手册 · 更新日志
dbskill 解决什么问题
你不需要先学会一套复杂的方法，也不需要知道该调用哪个工具。把当下的业务、材料、选择或卡点交给 /dbs，它会根据对话上下文选择当前适合的 Skill。
| 真实处境 | 你会得到 |
|---|---|
| 客户总说贵，不知道该改价格、产品还是客群 | 商业模式诊断、风险判断和验证动作 |
| 有一个选题，却做不出能被人看完的内容 | 内容方向、开头、标题与逐字稿优化 |
| 知道该做什么，却迟迟推不动 | 对行动卡点的分析和一条可开始的动作 |
| 反复面对同类选择，经验无法积累 | 可回填的决策记录、规律与阶段快照 |
| 文稿、选题、案例散落在多个文件夹 | 可持续维护的内容资产工程 |
| 本地资料很多，希望 Agent 能稳定查找和调用 | 基于文件夹的知识库导航、版本规则与使用入口 |
快速开始
安装完成后，直接在 Agent 中输入：
/dbs 我做少儿编程课，已经有 40 个付费学员，但续费率很低。
我需要判断问题出在产品、定价，还是我找错了客户。
/dbs 会读取当前对话信息，选择合适的分析路径。完成一轮后，继续补充新的事实或反馈，再输入 /dbs，它会判断当前该推进什么。
已经知道需求时，可以直接调用具体 Skill：
/dbs-diagnosis 我做面向宝妈的收纳咨询，客户总觉得贵。我该调整什么？
/dbs-content 我想讲“普通人别急着做个人 IP”，这个选题怎样做成内容？
/dbs-hook 这是我短视频前 20 秒的逐字稿，帮我优化开头：……
/dbs-benchmark 我想研究企业服务内容账号，应该找哪些对标？
/dbs-knowledge 帮我把这个文件夹变成知识库，以后我想直接从里面找资料。
能力一览
| 工作目标 | 主要入口 | 常见产出 |
|---|---|---|
| 判断生意、产品、定价与客户 | /dbs-diagnosis | 商业诊断、风险、验证方案 |
| 找对标并提炼可学习的部分 | /dbs-benchmark | 对标筛选与研究框架 |
| 先挖掘相关领域、作者和可信理论，再研究历史同构答案 | /dbs-standard-answer | 理论锚点、案例矩阵、条件性答案与失效边界 |
| 做选题、内容、标题与短视频 | /dbs-content、/dbs-hook、/dbs-xhs-title | 内容方向与可发布文案 |
| 发布前检查敏感词、导流、广告与受限内容 | /dbs-content-risk-check | 机器审核信号、内容实质问题与最小修改动作 |
| 检查文稿共鸣、逻辑与传播性 | /dbs-resonate、/dbs-script-flow、/dbs-spread | 修改意见与优先级 |
| 澄清概念、目标和问题 | /dbs-deconstruct、/dbs-goal、/dbs-good-question | 可验证的定义与行动目标 |
| 处理拖延、贪快和行动受阻 | /dbs-action、/dbs-slowisfast | 卡点分析与下一步动作 |
| 记录、复盘长期决策 | /dbs-decision、/dbs-save、/dbs-restore、/dbs-report | 本地决策档案与报告 |
| 建立和治理文件夹知识库 | /dbs-knowledge | 知识库导航、版本规则、健康检查与 SOT 分层瘦身 |
| 建立内容资产与多端 Agent 工作台 | /dbs-content-system、/dbs-agent-migration、/dbs-install-skill | 本地工程、主题地图与安装方案 |
| 审查本地 Skill 风险 | /dbs-skill-cleaner | 风险报告与确认后的隔离操作 |
完整的 31 个 Skill、适用时机、输入示例和动态导航方式，见 新手入门与 Skill 全目录。
安装
推荐：Claude Code、豆包、WorkBuddy、Codex 与其他支持 Skills 的 Agent
在终端执行：
npx -y skills add dontbesilent2025/dbskill -g --all
安装后回到 Agent，输入 /dbs 新手入门 即可开始。
Claude Code 插件市场
也可以通过 Claude Code 插件市场安装完整工具箱：
claude plugin marketplace add dontbesilent2025/dbskill
claude plugin install dbs@dontbesilent-skills
这个 dbs 插件包含 31 个正式业务 Skill 和 1 个 dbs-update 系统更新入口。Claude Code 会为插件 Skill 添加命名空间：主入口使用 /dbs:dbs，具体能力例如 /dbs:dbs-diagnosis。
只想安装一个能力时，可以在插件市场中选择对应插件，例如 claude plugin install dbs-diagnosis@dontbesilent-skills。
更新
已安装 dbskill 时，直接对当前 Agent 说：
更新 dbskill
它会同步官方 dbskill，不会修改你在 ~/.dbs/ 中的存档、报告和决策记录。版本变化见 GitHub Releases。
dbskill 怎样工作
真实任务
↓
/dbs 读取上下文并选择当前入口
↓
一个 Skill 完成诊断、产出或记录
↓
补充结果与反馈，再决定下一步
dbskill 的重点是推进眼前真实的任务。它会先处理当前最有价值的结点，再根据实际结果衔接后续工作。
知识库与本地记录
仓库公开了 4,176 条结构化知识原子、按 Skill 整理的方法论文档与高频概念词典。
- 想查看数据范围和字段，阅读 原子库说明。
- 想构建自己的 RAG，可使用
知识库/原子库/atoms.jsonl。 - 想了解各项方法，浏览 Skill 知识包。
- 想把自己的本地文件夹直接当作知识库，使用
/dbs-knowledge建立导航并持续查找、收录和调用资料。 - 想跨对话保留工作，使用
/dbs-save、/dbs-restore与/dbs-report。数据默认保存在用户本机的~/.dbs/。
公开推文集
公开推文集收录经过整理的 dontbesilent 推文原文，提供两种格式：
- Markdown 阅读版：适合搜索、复制和交给 AI 分析。
- PDF 阅读版：适合完整阅读和下载保存。
推文集与 Skills 安装包相互独立。执行 npx -y skills add dontbesilent2025/dbskill -g --all 时，安装的是 Skills，不会自动下载推文集。
共同贡献者
dbs-content-risk-check 的敏感词检查能力由以下共创者共同完善，他们的贡献不可替代：
作者与支持
作者：@dontbesilent · 小红书 · 抖音
如需加入付费答疑群，可扫码或打开 答疑群说明。
许可证
本项目采用 CC BY-NC 4.0 许可证。
- 个人使用、学习、研究与非商业项目可以直接使用。
- 公开发布衍生作品时，请注明来源。
- 商业用途需要单独授权，请联系作者。
如何使用
这个子 Skill 随“商业诊断dbskill”完整套件安装，不需要重复安装单独目录。
选择一种使用方式
使用 Codex、Claude Code 等 Agent 工具时选择“Agent 自动安装”；使用豆包、DeepSeek 等聊天产品时选择“聊天提示词版”。两种方式不需要同时操作。
Agent 自动安装
点击右侧“复制 Agent 自动安装指令”，粘贴并发送给 Agent。Agent 会读取仓库并完成安装，无需再手动执行 git clone。
聊天工具直接使用
点击右侧“复制聊天提示词”，粘贴到豆包、DeepSeek、Kimi 或通义千问中即可使用，不需要安装 Skill。
开始任务
安装完成或发送提示词后，直接描述你的写作任务，并用一个简单示例确认效果。
高级用户：查看手动安装方式（可选）
安装前准备
确认已准备好 Claude Code，并检查所需依赖。本资源不要求额外的 API Key。
获取并安装
在终端中执行下面的命令。请只从可信来源复制和运行命令。
git clone https://github.com/dontbesilent2025/dbskill.git添加配置
打开 Claude Code 的设置页，将资源加入对应的 Skills、Rules 或 MCP 配置区域。
验证安装
重新启动应用，执行一个只读测试任务，确认正常后再逐步开放所需权限。
安全与权限提示
安装第三方 Skill 前请阅读仓库源码和许可证。涉及文件、浏览器或命令执行的资源，应只授权完成任务所必需的最小范围。不要把 API Key 提交到公开仓库。