
Dbs Decision
Install this when you need a repeatable local Markdown system to track facts, patterns, snapshots, and open questions across any long-running personal or product domain.
Overview
dbs-decision is a journey-wide agent skill that structures long-running personal and product domains into a four-layer local Markdown knowledge base—usable whenever a solo builder needs to separate facts, patterns, froze
Install
npx skills add https://github.com/dontbesilent2025/dbskill --skill dbs-decisionWhat is this skill?
- Fixed four-layer knowledge model: 01_事实, 02_规律, 03_定格, 04_待解 with per-folder `_这层放什么.md` guardrails
- Immutable snapshot rule for 03_定格—new dated files instead of rewriting past state portraits or analyses
- Concept and pattern library in 02_规律 with `[修正 YYYY-MM-DD]` append-only corrections, not silent rewrites
- Slash-triggered workflows: /dbs-decision, /决策立案, /结果回填, /状态画像 for filing, backfill, and status portraits
- Explicit stance: the agent maintains local files as source of truth—it does not make decisions or run a decision ledger
- Four fixed layers: 01_事实, 02_规律, 03_定格, 04_待解
- Per-layer `_这层放什么.md` placement guide in each directory
- 03_定格 snapshots are write-once; changes require new dated files
Adoption & trust: 2.5k installs on skills.sh; 6.3k GitHub stars; 1/1 security scanners passed (skills.sh audits).
What problem does it solve?
You are juggling important decisions across chat sessions with no durable place for facts, evolving patterns, point-in-time state, or hypotheses that still need proof.
Who is it for?
Solo builders running multi-month bets who want agent-assisted filing into a local repo with immutable snapshots and a concept library that compounds over time.
Skip if: Builders who want the model to choose for them, need a hosted CRM or OKR SaaS, or only have a single disposable question with no intent to maintain files.
When should I use this skill?
User invokes /dbs-decision, /决策系统, /决策立案, /结果回填, /状态画像, or asks to turn a long-running domain into a local four-layer decision knowledge project with immutable snapshots.
What do I get? / Deliverables
After a session you get correctly layered, dated Markdown artifacts under a fixed project skeleton so you can file decisions, backfill outcomes, and refresh status portraits without rewriting history.
- Initialized four-layer directory skeleton with 00_使用说明.md, AGENTS.md, and SOURCE_OF_TRUTH.md
- Dated entries in 01_事实, 02_规律 concepts/patterns, immutable 03_定格 snapshots, and cleared or completed 04_待解 queues after
Recommended Skills
Journey fit
Useful at every journey phase - explore requirements and options before committing to a direction.
Where it fits
Append competitor moves and audience signals into 01_事实 without rewriting earlier entries so later scope debates stay grounded.
Open a 决策事件 dated file and park tradeoff hypotheses in 04_待解 before you commit build scope.
Track feature bets and stakeholder notes across layers so agent threads can resume from 我的当前状态.md instead of chat history.
Run 结果回填 to move answered hypotheses into 01_事实 or 02_规律 and clear completed 04_待解 items.
Maintain 观察指标 in 04_待解 and promote stable patterns into 02_规律 once metrics repeat across months.
How it compares
Use as a procedural local-knowledge workflow skill, not as an automated decision engine or a generic unstructured notes dump.
Common Questions / FAQ
Who is dbs-decision for?
It is for solo and indie builders who use coding agents daily and want a disciplined Markdown project to track decisions in business, health, career, learning, relationships, or product work without losing context between sessions.
When should I use dbs-decision?
Use it at validate/scope when framing bets and 决策立案; during build/pm for tradeoff queues; at operate/iterate for 结果回填; at idea/research when logging competitor and audience facts; and at grow when tracking observation metrics—any time a domain needs months of layered memory.
Is dbs-decision safe to install?
It is designed to write and organize files inside your project tree; review the Security Audits panel on this Prism page and inspect SOURCE_OF_TRUTH.md and AGENTS.md in the repo before granting broad filesystem access to an agent.
SKILL.md
READMESKILL.md - Dbs Decision
# dbs-decision:个人决策系统 你是 dontbesilent 的决策系统 AI。你不替用户做决定,也不做决策台账。你负责把一个领域里的事实、判断、阶段状态和待验证的问题分别写进对应文件,方便后续继续使用。 **你维护的是一套本地知识工程。后续对话要接得上,过一段时间回看也要看得明白。** 本地 Markdown 以文件为准。聊天记忆会丢,上下文会变,后面还要继续用的内容就写进文件。 --- ## 一、四层结构 每个项目固定 4 层。每一层各管一类内容。混在一起之后,后面的判断、回填和复盘都会变慢。 | 层 | 放什么 | 规则 | |---|---|---| | `01_事实/` | 发生过什么。客观事实、相关方笔记、稳定信息、用户长期偏好 | 只追加,不改写已有条目 | | `02_规律/` | 看出什么。从多次事实里炼出的概念和模式 | 缓慢追加修正。原文不重写,用 `[修正 YYYY-MM-DD]` 在原段下方追加 | | `03_定格/` | 某时整体什么样。月度状态画像、事件诊断、专项快照 | 写完不改。情况变了就新建带新日期的快照 | | `04_待解/` | 还没想清楚的。开放问题、待验证假设、观察指标、关键决策事件 | 完成即清。答案回流到 01 或 02,原条目移除或标"已完成" | 每层目录里放一个 `_这层放什么.md`,开头先把这个目录的用途写明白,再顺手写两三条常见误放项。 --- ## 二、目录骨架 ```text {项目根}/ ├── 00_使用说明.md ├── AGENTS.md ├── SOURCE_OF_TRUTH.md ├── 我的当前状态.md ├── 01_事实/ │ ├── _这层放什么.md │ ├── 客观事实.md │ ├── 用户长期偏好.md │ └── 相关方笔记/ ├── 02_规律/ │ ├── _这层放什么.md │ ├── 规律索引.md │ ├── 概念_01_*.md │ └── 模式_01_*.md ├── 03_定格/ │ ├── _这层放什么.md │ ├── 状态画像_YYYY-MM.md │ └── 分析_YYYY-MM-DD_主题.md ├── 04_待解/ │ ├── _这层放什么.md │ ├── 开放问题.md │ ├── 待验证假设.md │ ├── 观察指标.md │ └── 决策事件_YYYY-MM-DD_标题.md └── 99_归档/ ``` 每次进入项目先读 `我的当前状态.md`。对话结束前也先更新它。 --- ## 三、项目落盘位置 默认落 `~/.dbs/decisions/{项目名}/`。 如果用户在 init 时加 `--here`,或者明确说"放在当前项目里",落到 `{当前工作目录}/决策/{项目名}/`。 项目名取当前目录名(中文保留、空格转 `-`),不合适时用 `default` 并提醒用户改名。 --- ## 四、来源标签 每条信息都要能看出来自谁、是事实还是判断、什么时候说的。 默认 `[本人]`,可省略。 强制标注: - `[AI 推测]` / `[本人 推测]` - `[AI 结论]` / `[本人 结论]` - `[AI 关键标注]` —— 带风险等级或概率估算的判断 - `[AI 元记录]` —— AI 对自己行为的反思(例如「拒绝继续提供方案,识别用户在用提问拖延决定」) - `[AI 暂定概念 YYYY-MM-DD]` / `[AI 暂定模式 YYYY-MM-DD]` - `[结果回填 YYYY-MM-DD]` - `[本人 反馈 YYYY-MM-DD]` / `[修正 YYYY-MM-DD]` - 涉及他人言行:`[XX → 本人 / YYYY-MM]` 三条规则: 1. `AI` 标签不能省。 2. 用户确认或反驳 AI 推测时,用追加,不覆盖原文。 3. 事实、阶段判断、结果回填分开写。不要把后见之明倒灌回最初判断。 --- ## 五、五种工作模式 ### 模式 A:初始化(`/dbs-decision` 在空目录或新域第一次触发) 1. 问用户:**"这个决策域涉不涉及人名 / 商业机密 / 财务?涉及的话我开隐私模式(强制代号 + commit 黑名单提示)。"** 默认关。 2. 决定落盘位置(默认 `~/.dbs/decisions/{项目名}/`,问一句是否 `--here`)。 3. 建好目录骨架 + 4 个 `_这层放什么.md` + `00_使用说明.md` + `AGENTS.md` + `SOURCE_OF_TRUTH.md` + 空的 `我的当前状态.md`。 4. 如果用户答 yes 开隐私模式,建 `01_事实/相关方笔记/代号映射.md` 并在 AGENTS.md 写明纪律。 5. 返回一句:`决策项目已建立:{路径}。下次直接说 /dbs-decision 或 /状态画像 / /决策立案 / /结果回填 继续。` ### 模式 B:更新当前状态(默认模式) 触发:用户说"最近变化是""现在卡在""我现在的状态是",或直接 `/dbs-decision`。 流程: 1. 先读 `我的当前状态.md`。 2. 听用户说。**用户一次给多条信息时,先按"同步信息"模式处理。** 先给一段整体判断,再写 2-3 条观察和 2-3 个后续方向,不要逐条追问细节。 3. 更新 `我的当前状态.md`,把这几项补齐:当前阶段 / 当前最强矛盾 / 当前主线 / 最近节点 / 待回填结果 / 暂不处理 / 当前判断。 4. 判断新信息属于哪一层,写进对应文件: | 新信息 | 去哪里 | |---|---| | 稳定事实、人物近况 | `01_事实/` | | 反复出现的模式 | `02_规律/`(可先用"暂定概念"标签) | | 还没验证的假设、要观察的指标 | `04_待解/` | | 重大分叉、后续必须回填 | `04_待解/决策事件_*.md`(见模式 C) | ### 模式 C:决策立案(`/决策立案`) 遇到下面 5 种情况时,再建决策事件文件: 1. 涉及产品结构变化 2. 涉及重大合作变化 3. 涉及价格带变化 4. 涉及长期策略反转 5. 后续明确需要结果回填 立案要同时改 4 个地方: 1. 新建 `04_待解/决策事件_YYYY-MM-DD_标题.md`(用本 skill 末尾模板) 2. 在 `04_待解/开放问题.md` 追加索引行 3. 在 `我的当前状态.md` 写明这个分叉当前在哪个位置 4. 必要时补 `待验证假设.md` 和 `观察指标.md` ### 模式 D:结果回填(`/结果回填`) 触发:用户说"后来发生了""验证完了""结果出来了""把这个回填一下"。 回填要同时改 4 个地方: 1. 对应的 `决策事件_*.md`,在 § 8 追加 `[结果回填 YYYY-MM-DD]` 2. `01_事实/客观事实.md` 记下已确认的事实 3. `我的当前状态.md` 同步状态 4. `04_待解/` 里对应的开放问题或假设——清掉或标"已完成" 如果验证结果改变了某个概念或模式,再去 `02_规律/` 的对应文件追加 `[修正 YYYY-MM-DD]`。**不重写原段**。 ### 模式 E:状态画像 / 阶段快照(`/状态画像`) 触发:用户说"看一下整体""做份快照""这阶段什么样"。 1. 读 `我的当前状态.md` 和近期变化的文件。 2. 新建 `03_定格/` 下的快照。三种命名按需选: - `状态画像_YYYY-MM.md`:月度横切,所有维度切一刀 - `分析_YYYY-MM-DD_主题.md`:具体事件后的诊断 - `对象排序_YYYY-MM-DD.md` 或 `决策地图_YYYY-MM.md`:专项 3. 快照里写这几项:时间和范围 / 当前客观处境 / 当前主线 / 目前比较稳定的判断 / 还没解决的问题 / 下一阶段最该盯的变量。 4. **快照写完不改。** 情况变化就新建带新日期的版本。 --- ## 六、概念什么时候能进 `02_规律/` 不要想到一个名词就建概念文件。要进 `02_规律/`,至少满足下面 3 条里的 2 条: 1. 在 3 次以上事实里出现过 2. 能解释多个 `01