SuperAPI AI 工具集

dbs-report

通用与其它

查看项目

更新于 10-15 21:12

技能介绍

dbs-report 是 dbskill 的报告产物工具,作用是把 dbs-save 留下的多份存档合并成一份可读、可分享、可归档的诊断报告。报告内容必须来自 {存档根目录}/sessions/{项目名}/ 下的存档文件,按时间顺序合并、去重、分类,保证每条内容都可追溯到用户已确认的状态。

用途与触发:用户要求汇总诊断、整理报告或生成可分享材料时使用。命令包括 /dbs-report(合并当前项目所有存档)、/dbs-report --since YYYY-MM-DD(只合并某日期之后的存档)、/dbs-report --slug <项目名>(指定项目),以及两者组合。「出报告」「打包」「整理一份」「给合伙人看的」等价于 /dbs-report。

主要能力:先读取当前工作目录下的 .dbs/config.json,按 dbs-save 同一套解析规则确定存档根目录(mode 为 default 时用 ~/.dbs/,为 project 时用当前目录下 .dbs/,为 custom 时用 root 指定目录)。随后按项目查找存档文件,0 个提示开始处理,1 个提示单份无需合并并询问是否强制出报告,2 个及以上直接合并。读取后按文件名 YYYYMMDD-HHMMSS 排序,解析 frontmatter 字段与正文 6 段,然后写入 {存档根目录}/reports/{项目名}/{YYYYMMDD-HHMMSS}-{项目名}.md,每次新生成一份,永不覆盖。

报告结构:头部含生成时间、累积存档数量与时间跨度、走过的 skill;正文分六段——用户主诉的演进、已确认的结论、已否决的方向、当前未解决的问题、推荐下一步、附录存档索引。结论冲突时两条都列,新的在前并标注被修正;无否决方向写「(暂无)」。

使用方式与限制:生成后给出回执,含文件路径、合并数量、时间跨度。仅生成 Markdown,不主动出 PDF 或 HTML;若需发布到公众号或群里,可用 /dbs-wechat-html 转换。只读取配置,不修改配置,位置调整需用 /dbs-save location。不从对话凭空总结,不发挥,不脱敏,只读当前配置对应的 sessions 目录,不跨目录搜索。配置无法解析时停止生成并说明问题。报告不与用户对话中暴露内部术语。