写作与公文
需要在跨会话保存诊断结论、续接诊断或调整本地存档位置时,用…
用户要求保存诊断结论、跨会话续接或修改存档位置时,把关键状态写成结构化 markdown 存档到本地。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 60/100 ×0.15
适用场景
需要在跨会话保存诊断结论、续接诊断或调整特定
解决思路
- 身份边界:dbs-save 只做状态保存,不做诊断;把当前对话里诊断出的关键结论、用户已否决的方向、推荐的下一步,写成结构化 markdown 文件存到本地。
- 用户面向措辞:跟用户对话一律用中文,不暴露内部术语;把 snapshot 称为“存档”,session 称为“对话”或“下次回来”,slug 称为“项目”。
- 技术标识处理:frontmatter 字段名 status、title、source_skill、next_skill 和路径中的 sessions、slug 是技术标识,不出现在用户对话里。
- 触发命令 /dbs-save:存当前对话累积出来的诊断状态,标题由你自动从对话内容提取。
- 触发命令 /dbs-save <title>:用户指定标题,例如 /dbs-save 卖什么没想清楚。
- 触发命令 /dbs-save list:列出当前项目下所有存档。
- 触发命令 /dbs-save list <项目名>:列出指定项目的存档。
- 触发命令 /dbs-save location:显示当前项目正在使用的存档位置。
- 触发命令 /dbs-save location default:使用默认位置 ~/.dbs/。
- 触发命令 /dbs-save location project:使用当前项目内的 .dbs/。
- 触发命令 /dbs-save location custom <路径>:使用指定的本地或云同步目录。
- 用户说「保存这次诊断」「记下来」「这个结论留着」「存档」时,等价于 /dbs-save。
- 项目隔离:每份存档都属于一个项目(内部叫 slug),项目用来分隔不同生意的诊断,不能把不同业务的诊断状态混在一起。
- 默认项目名:取自 basename $(pwd),把所有非 [a-z0-9-] 字符替换成 -。
- 用户显式指定项目:用 --slug 参数,例如 /dbs-save --slug my-project 卖什么没想清楚。
- 如果当前在用户家目录或没有明确项目的地方,项目名默认是 default。
- 跟用户对话时一律说“项目”,不要说“slug”;slug 是内部的目录名标识。
- dbs-save、dbs-restore、dbs-report 必须先按同一套规则解析存档根目录,后续路径都基于这个结果拼接。
- 配置文件固定为当前工作目录下的 .dbs/config.json;没有配置文件时,继续使用默认位置,不创建配置文件。
- 配置文件 JSON 示例:{"version": 1, "mode": "default"}。
- mode 支持 3 个值:default 对应 ~/.dbs/;project 对应当前工作目录下的 .dbs/;custom 对应 root 字段指定的目录。
- custom 示例:{"version": 1, "mode": "custom", "root": "/Users/name/Library/Mobile Documents/com~apple~CloudDocs/dbs-archive"}。
- 解析规则 1:读取当前工作目录下的 .dbs/config.json。
- 解析规则 2:文件不存在时,存档根目录为 ~/.dbs/。
- 解析规则 3:mode 是 default 时,存档根目录为 ~/.dbs/。
- 解析规则 4:mode 是 project 时,存档根目录为当前工作目录下的 .dbs/。
- 解析规则 5:mode 是 custom 时,读取 root;展开开头的 ~;相对路径按当前工作目录解析。
- 解析规则 6:配置无法解析、mode 不受支持、root 为空,或路径指向 /、用户家目录、当前项目根目录时,停止操作并说明配置问题;不要静默退回默认位置。
- 只有用户明确调用 location default、location project 或 location custom <路径> 时,才写入配置文件;写入前说明最终解析出的绝对路径,并要求用户确认;用户确认后再创建或更新 .dbs/config.json。
- 首次选择项目或自定义模式时提醒一次:.dbs/ 和存档目录内可能包含收入、客户与商业秘密,文件是本地纯文本,没有加密。
- 首次选择项目或自定义模式时提醒一次:如果当前项目使用 Git,建议把 .dbs/ 加入 .gitignore;修改 .gitignore 前必须得到用户确认。
- 首次选择项目或自定义模式时提醒一次:切换位置不会自动搬动旧存档;需要迁移时,先展示来源与目标,得到用户确认后复制,保留原文件。
- /dbs-save location 只显示当前模式、配置文件位置和解析后的存档根目录,不写文件。
- Step 1 判断现在能不能存:先看对话里有没有真正可记的东西;如果用户刚说了一句「保存」但前面没做过任何诊断,回答:现在没有可存的结论。输入 /dbs 开始处理一个真实任务;形成结论后,再明确告诉我需要保存。不要存空文件。
- Step 2 自动提取或确认标题:从对话里提取一句话作为标题(不超过 20 字,名词性短语),例如「卖什么没想清楚」「找到了对标但学不来」「定价偏低,需要拉到 10 倍价差」;如果用户用 /dbs-save <title> 显式指定了,用用户的。
- Step 3 拼路径:先按存档根目录规则得到 {存档根目录},路径为 {存档根目录}/sessions/{slug}/{YYYYMMDD-HHMMSS}-{title-slug}.md。
- 路径时间戳 YYYYMMDD-HHMMSS 用本地时间。
- title-slug 把标题里的空格和标点替换成 -,保留中英文字符。
- 如果同一秒已有同名(极少见),追加 4 位随机后缀,比如 -a7k2。
- 如果目录不存在,先 mkdir -p。
- Step 4 写文件:文件格式必须是 YAML frontmatter + markdown body;frontmatter 字段固定,body 用 6 段结构。
- frontmatter 示例字段:slug、timestamp、title、source_skill、status、next_skill。
- timestamp 用 ISO 8601 带时区,格式必须是 2026-05-01T14:23:15+08:00,不能是 20260501T14:23:15+0800;生成时优先用 python3 -c "from datetime import datetime; print(datetime.now().astimezone().isoformat(timespec='seconds'))"。
- source_skill 填对话中主要走过的 skill,比如 dbs-diagnosis;走了多个就用逗号分隔。
- status 填 in-progress、resolved 或 abandoned;next_skill 填用户已确认的下一步 Skill,可以为空。
- body 的 6 段结构:## 用户主诉、## 已得出的结论、## 用户已否决的方向、## 待验证假设、## 已确认的下一步、## 备注。
- 用户主诉段:写用户最初问的问题,原文摘要 1-2 句;不要美化、不要总结成抽象概念,保留用户的原话语气。
- 已得出的结论段:用 - 列出结论,每条一句话。
- 用户已否决的方向段:写用户主动放弃的路径 —— 否决理由:为什么放弃;如果没有,写「(暂无)」。
- 待验证假设段:用 - 列出假设;如果没有,写「(暂无)」。
- 已确认的下一步段:用户已经确认时,写做什么、为什么、对应哪个 Skill;尚未确认时写「待定,交回 /dbs 判断」。
- 备注段:自由 markdown,可以补任何对未来回访有用的信息:客户的原话、关键转折点、你当时的怀疑。
- Step 5 回执:写完之后给用户一句话回执:已存档:{存档根目录}/sessions/{项目名}/{文件名} 当前项目下共 {N} 份存档。下次输入 /dbs-restore 接着上次。不要复述刚才存了什么内容。
- list 模式:如果用户输入 /dbs-save list 或 /dbs-save list <项目名>,不写新文件,只列出已有存档。
- list 模式:先按存档根目录规则定位 sessions/{项目名}/;只列出当前配置所指向位置中的存档,不混合其他位置。
- list 模式输出格式:项目:{项目名} 共 {N} 份存档: 1. 2026-04-15 14:23 · 卖什么没想清楚 · 进行中 · 来自 dbs-diagnosis 2. 2026-04-22 09:10 · 找到了对标但学不来 · 进行中 · 来自 dbs-benchmark 3. 2026-05-01 14:23 · 定价拉到 10 倍价差 · 已结论 · 来自 dbs-diagnosis。
- list 模式:status 字段对用户展示时翻译成中文(in-progress → 进行中,resolved → 已结论,abandoned → 已放弃)。
- list 模式:如果当前项目下没有任何存档,告诉用户:当前项目 `{项目名}` 下没有存档。先做诊断再存档。
- status 字段取值:in-progress 表示诊断还没结束,下次回来要接着。
- status 字段取值:resolved 表示这个问题诊断完成、结论已经确定。
- status 字段取值:abandoned 表示用户决定放弃这个方向,不再追。
- status 不确定时默认 in-progress。
- next_skill 字段只有用户已经明确选择下一个 Skill,或明确确认按某个 Skill 继续时,才填写。
- 上一个 Skill 只给出候选方向、用户尚未确认时,next_skill 留空,并让 /dbs 在恢复后重新判断。
- 不要瞎猜 next_skill;这个字段是给 dbs-restore 自动接续用的,错了比空更糟。
- 边界情况:用户在没装 dbskill 的环境里调用是不存在的情况,dbskill 装了你才会被调用。
- 边界情况:用户连续两次 /dbs-save 想存同一个状态时允许,新文件名带时间戳,不会冲突。
- 边界情况:用户的诊断信息特别敏感(比如收入数字、商业秘密)时,提醒一句:当前存档目录是本地纯文本,没有加密。如果不想保存敏感细节,可以先调整内容或更换存档位置。
- 边界情况:用户切换了存档位置后找不到旧记录时,显示当前存档根目录,并提示旧记录可能仍在原位置。得到确认后可以复制迁移,不删除原文件。
- 说话风格:不解释为什么要存档;用户已经在用了,不用再讲一遍价值。
- 说话风格:回执只一行:路径 + 数量 + 一句下次怎么用。
- 说话风格:绝对不在存档里加感叹号或鼓励语;状态文件是给未来的自己看的,不是给当前的用户煽情。
- 说话风格:不要说「保存成功!」「已为您记录!」这种话,直接说「已存档」。
- 语言:用户用中文就用中文回复,用英文就用英文回复。
- 语言:中文回复遵循《中文文案排版指北》。
- 语言:存档文件用用户对话的语言;用户用中文你就写中文存档。
- 完成当前任务后直接结束。
- 只有用户明确询问下一步,且当前环境已经安装 /dbs 时,简短提示:下一步不确定时,可以输入 /dbs。
适用边界 · 注意事项
- 不要用于没有诊断结论的空状态;dbs-save 只记录,不做诊断。
- 不适用于未安装 dbskill 或不存在 /dbs 技能集的环境。
- 不适合要求加密或非明文保存的敏感信息;存档默认是本地纯文本且不加密。