基础工具与工作流 · dontbesilent2025/dbskill

dbs-save

把当前诊断的关键状态保存到本地,并查看或设置存档位置。用户要求保存结论、跨会话续接或修改存档位置时使用。

风险提醒:蓝色 · 知晓即可AI 侦查报告
作者 dontbesilent2025GitHub dontbesilent2025/dbskill ↗Stars 10121许可 CC BY-NC 4.0(仓库根 LICENSE:Attribution-NonCommercial 4.0 International (CC BY-NC 4.0);署名 + 禁止商业使用;Copyright (c) 2026 dontbesilent)commit 8b8e33f1ec
agent 宿主通常会约束 skill 执行权限;风险提醒为 AI 侦查观点,不构成质量或安全保证。第三方 skill 仅作拆解与展示,安装使用风险自负,版权归原作者。

1实现原理 · 为什么它能做到

纯 prompt 编排的「写入端」,靠固定文件格式 + 固定路径规则把对话状态落成可恢复的 markdown;职责被明确切分——只记录不诊断

skills/dbs-save/SKILL.md
**你不做诊断。** 诊断是别的 skill 的事,你只做记录。
注:产物 = YAML frontmatter(slug/timestamp/title/source_skill/status/next_skill)+ 固定 6 段 body。

存档根目录由项目内 .dbs/config.json 决定,三模式(default ~/.dbs/、project 当前目录 .dbs/、custom 指定目录),且是该子系统的配置真源(dbs-restore/dbs-report 都按同一规则解析)

skills/dbs-save/SKILL.md
没有配置文件时,继续使用默认位置,不创建配置文件。
注:custom 模式支持云同步目录(举例 iCloud Drive 路径),并规定展开开头的 ~。

配置异常一律停机:不可解析/mode 不支持/root 为空/路径指向 / 或家目录或项目根 → 停止并说明问题,禁止静默退回默认位置

skills/dbs-save/SKILL.md
配置无法解析、`mode` 不受支持、`root` 为空,或路径指向 `/`、用户家目录、当前项目根目录时,停止操作并说明配置问题。不要静默退回默认位置。
注:这条防的是「以为存在 ~/.dbs 实际写到了别处」或「把家目录当存档根」的静默事故。

写配置要二次确认:仅在用户显式使用 location 子命令时才写,且写前必须说明解析出的绝对路径并获确认

skills/dbs-save/SKILL.md
写入前说明最终解析出的绝对路径,并要求用户确认;用户确认后再创建或更新 `.dbs/config.json`。
注:相对地,`/dbs-save location` 只读显示,不写文件。

写入前先判断「有没有值得存的东西」:没有诊断过程就拒绝存空文件,并给出正确路径提示

skills/dbs-save/SKILL.md
- 切换位置不会自动搬动旧存档。需要迁移时,先展示来源与目标,得到用户确认后复制;保留原文件。 `/dbs-save location` 只显示当前模式、配置文件位置和解析后的存档根目录,不写文件。 --- ## 工作流程 ### Step 1:判断现在能不能存 存之前先看对话里有没有真正可记的东西。如果用户刚说了一句「保存」但前面没做过任何诊断,你应该说: > 现在没有可存的结论。输入 `/dbs` 开始处理一个真实任务;形成结论后,再明确告诉我需要保存。 不要存空文件。 ### Step 2:自动提取或确认标题 从对话里提取一句话作为标题(不超过 20 字,名词性短语)。例如: - 「卖什么没想清楚」 - 「找到了对标但学不来」 - 「定价偏低,需要拉到 10 倍价差」 如果用户用 `/dbs-save <title>` 显式指定了,用用户的。 ### Step
注:对应 Step 1 的固定话术:现在没有可存的结论…输入 /dbs 开始处理一个真实任务。

项目隔离靠 slug:默认取 basename $(pwd) 并做字符清洗,家目录/无项目场景回落 default,用户可用 --slug 显式指定

skills/dbs-save/SKILL.md
**默认项目名**:取自 `basename $(pwd)`,把所有非 `[a-z0-9-]` 字符替换成 `-`。
注:对外统一说「项目」,不说 slug——技术标识不出现在用户对话里。

隐私提示是首次进入 project/custom 模式时的一次性提醒,含「本地纯文本无加密」「建议把 .dbs/ 加入 .gitignore(改前需确认)」「切换位置不自动搬运旧存档」

skills/dbs-save/SKILL.md
如果当前项目使用 Git,建议把 `.dbs/` 加入 `.gitignore`。修改 `.gitignore` 前必须得到用户确认。
注:配套原文:「`.dbs/` 和存档目录内可能包含收入、客户与商业秘密,文件是本地纯文本,没有加密。」

next_skill 字段采取「宁空不猜」纪律,避免给 dbs-restore 自动接续喂错方向

skills/dbs-save/SKILL.md
不要瞎猜——这个字段是给 dbs-restore 自动接续用的,错了比空更糟。
注:status 不确定时同理默认 in-progress。

2核心能力

01存档写入:按 {存档根目录}/sessions/{slug}/{YYYYMMDD-HHMMSS}-{title-slug}.md 落盘,目录不存在先 mkdir -p
02固定 6 段结构:用户主诉 / 已得出的结论 / 用户已否决的方向 / 待验证假设 / 已确认的下一步 / 备注
03标题自动提取(≤20 字名词性短语)或用户显式指定 /dbs-save <title>
04list 模式:按当前配置位置列项目内存档并中文化状态,不混合其他位置
05location 三态查看/切换(default/project/custom <路径>)+ 解析规则说明
06冲突自解:同秒同名追加 4 位随机后缀;连续两次保存同状态也允许(时间戳不同即不冲突)
07status 字段语义固定三值并在展示时中文化
08回执极简:一行路径 + 数量 + 下次怎么用,不复述存档内容

4风险提醒 风险提醒:蓝色 · 知晓即可

风险提醒:蓝色 · 知晓即可
  • 存档是明文且可能含商业秘密 — 默认 ~/.dbs/ 为本地纯文本,无加密、无脱敏;若改到 iCloud/Dropbox 等 custom 目录会随云外流。skill 会提醒一次,但提醒可被忽略。
  • 敏感内容一旦落盘就会反复回放 — 存档会被 dbs-restore 读回复述、被 dbs-report 汇入可分享报告(且报告刻意不脱敏);写入端的把关(Step 1 拒绝空文件、备注自由填写)无法阻止用户把敏感细节写进去。
  • 可能写入 .gitignore — skill 建议把 .dbs/ 加入 .gitignore,并规定修改前必须得到用户确认——这是一处对用户仓库配置的写入面,仅靠确认条款约束。
  • slug 默认值依赖工作目录 — 默认项目名取 basename $(pwd),在系统目录或家目录回落 default;在不同目录运行会落到不同「项目」,可能让用户找不到自己刚存的存档(skill 用 list/location 提示缓解)。
风险提醒:蓝色,知晓即可。判级对象是本 skill 自身目录:无脚本、无网络端点、无凭证读取,但 SKILL.md 明确要求 agent 把诊断状态持续写入本地存档({存档根目录}/sessions/…md,默认 ~/.dbs/,可指向云同步目录)并在用户确认后写 .dbs/config.json,属「仅本地读写、无外发」档。风险集中在数据而非代码:存档含收入、客户、商业秘密且明文无加密;skill 已把提醒、gitignore 建议、路径确认与「不静默退回默认位置」写进流程,但加密与脱敏不在其能力范围。

5第二遍独立确认

  • [ok] 外部资源/工具:是否存在未声明的依赖 — 无 URL、无包、无 CLI;目录内仅 SKILL.md + agents/openai.yaml。external_deps 空数组成立(文中出现的 python3 datetime 命令只是 timestamp 生成建议,不构成依赖)。
  • [ok] 安全结论:写入是否可能落到危险位置 — 配置解析显式拒绝 path 指向 /、家目录、项目根的场景并停机(「不要静默退回默认位置」);config 写入有绝对路径确认;存档写入固定在 {存档根目录}/sessions/ 下,无删除操作。除用户自定义 root 外,默认落点为 ~/.dbs/。
  • [ok] 实现原理是否成立:跨会话可恢复是否真由本 skill 保证 — 四要素齐备:确定路径规则、含时间戳文件名(供 dbs-restore 排序)、固定 frontmatter 字段(供解析)、固定 body 六段(供报告搬运),并规定 source_skill/next_skill 的填写纪律。恢复端(dbs-restore)的读取假设与本端写入格式逐条对应。
  • [ok] 功能声明 vs 实际能力:description 声称的「查看或设置存档位置」 — 对应 location 子命令三态(查看 / default / project / custom <路径>)与「只读显示不写文件」的区分,实现与声明相符。
  • [unlocatable] 证据定位:仓库级元数据(stars/last_push)与 installs — stars=10121、last_push=2026-09-07 来自站点池 data/pool.json(GitHub API 采集),pin 源码内无法逐字定位;installs 未采集记 null。license 可在仓库根 LICENSE 逐字命中。

6结论

  • 把「跨会话记忆」落成可核查的工程约定:固定路径 + 时间戳文件名 + 固定 frontmatter/body,使恢复与汇总端只需依赖格式而非模型记忆
  • 配置子系统设计克制:默认不创建配置文件、异常一律停机报告、写配置需路径确认——避免「以为存在其实没写」「静默换位置」两类长期隐患
  • 隐私提醒前置且具体(本地纯文本无加密、建议 .gitignore、切换位置不搬旧档),在诊断类 skill 里属少见的诚实披露
  • 对下游负责:next_skill 宁空不猜、status 默认 in-progress,明确「错了比空更糟」——保护 dbs-restore 的自动接续
  • 输出纪律严格:回执一行、不复述内容、存档内禁感叹号与鼓励语,使存档成为中性的状态文件而非情绪化手账
  • 适合:适合长期跟同一批商业问题打交道、需要跨会话累积判断的用户(咨询式自我诊断、多个生意/项目并行)。它是 dbskill 从「单次问诊」升级为「私人医生」的写入端,与 dbs-restore(读回)、dbs-report(汇总)配套使用;也适合需要把 AI 对话结论沉淀成本地可检索文件的人。
    不适合:不适合不想在本地留痕的场景——它的全部价值就是落盘;不适合需要加密或权限隔离的敏感资料(明文纯文本);不适合当成笔记/日记工具(不诊断、拒绝空文件、要求 6 段结构与 frontmatter 字段);不适合在多台机器间共享同一存档库而无同步方案(位置固定、不自动搬迁)。
    安装 agent 直装可复制
    ① 本站镜像 更新 2026-09-15
    方式 A · 人下载镜像包下载 dbs-save.tar.gz
    sha256: b6062f2bb252be4a…
    方式 B · JSON 格式安装指南,复制给 agent
    安装指南
    agent 读 JSON 指南后会自动从本站下载安装,无需更多说明。
    ② 上游 GitHub · 原始来源
    能访问 GitHub?直接去上游安装(实时版,可能已更新)GitHub 原始 ↗
    本页镜像锁定 commit 8b8e33f1ec;上游为实时仓库。
    来源信息 GitHub 原始
    作者 / 仓库dontbesilent2025 / dontbesilent2025/dbskill
    Stars10121
    最近推送2026-09-07
    本 skill commit8b8e33f1ec
    许可CC BY-NC 4.0(仓库根 LICENSE:Attribution-NonCommercial 4.0 International (CC BY-NC 4.0);署名 + 禁止商业使用;Copyright (c) 2026 dontbesilent)
    本站信息
    收录日期2026-09-06
    分类基础工具与工作流
    侦查报告AI 侦查 · 2 遍 · 2026-09-06
    本站镜像与 GitHub 原始是不同来源:本站锁定 commit 快照经 /r2 分发;GitHub 为实时上游,内容可能已更新。
    同分类邻近