1实现原理 · 为什么它能做到
单目录重型 skill：交付物不是总结，而是一套能继续运转的本地内容工程；SKILL.md 要求自身自包含。
skills/dbs-content-system/SKILL.md
**你交付的不是一份总结，而是一套能继续运转的系统。**
注：自包含要求写得很硬：「**本 skill 必须自包含。不要假设用户安装后还能读取仓库里的知识包、参考文档或额外支持文件。只要拿到这一个 `SKILL.md`，也必须能完整执行。**」
目录自持全部资产：脚手架、模板、脚本、文档都留在 skill 目录内并随安装分发（10 个 Node 脚本 + 7 份模板 + 4 份根级 scaffold + 6 份规则 + 2 份文档）。
skills/dbs-content-system/SKILL.md
**本 skill 不是轻量 prompt，而是单目录重型 skill。`SKILL.md`、脚手架、模板、脚本、文档都固定留在 `skills/dbs-content-system/` 目录内部，不依赖共享目录。**
注：SKILL.md 逐项列出这些可分发文件，并声明「如果用户安装后的 skill 包里没有这些文件，视为交付不完整。」
先审计再建工程：内容量与边界两道门槛，不达标只出审计结论并给降级路径。
skills/dbs-content-system/SKILL.md
### 原则 1：先审计，再建工程
注：门槛写死数字：可处理文本文件不少于 50 个、或可提取正文不少于 80000 字；来源维度至少命中 2 类。
原始素材只复制不改写：源目录原文件不碰，副本进 `01-原始素材区/完整副本/` 仅作回溯依据。
skills/dbs-content-system/SKILL.md
原目录里的原文件不碰。
注：处理全部在新工程里进行，避免破坏用户既有资料。
处理对象是内容单元而非文件：首期固定 5 类（QST/CON/OPI/CAS/SOL），每个单元独立 Markdown 并带 YAML frontmatter。
skills/dbs-content-system/SKILL.md
首期只保留 5 类内容单元：
注：文件规则为「- 文件名固定为 `ID_标题.md`」，且「- 当前文件代表当前有效版本，历史变化交给 Git」。
关系与去重先冻结口径：关系只允许 4 类（回应/解释/证明/冲突），去重只允许 4 类，且只有完全重复与同义重复默认合并。
skills/dbs-content-system/SKILL.md
第一期只允许 4 类关系：
注：合并范围由「只有 `完全重复` 与 `同义重复` 默认合并。」限定，防止误合并近似重复。
四模式逐档升级（审计→样本→批量→全量），每档设硬闸门，少一条都不升档。
skills/dbs-content-system/SKILL.md
只有前一档闸门全部通过，才允许进入下一档。少一条都不升档。
注：且「默认永远从 `审计模式` 进入。」；升档闸门以 `审计模式 → 样本模式` 一类标题逐条列出。
交付工具层随 skill 自带：初始化脚本建目录骨架、复制模板与 scaffold，并把 9 个工具脚本复制进工程 `07-脚本与工具/`。
skills/dbs-content-system/SKILL.md
- `tools/init-content-system.js`：初始化工程骨架
注：脚本实证：`const src = path.join(skillRoot, "templates", name);` / `fs.copyFileSync(src, dst);` 与 `const src = path.join(skillRoot, "tools", name);` 三段循环把 templates/scaffold/tools 复制到目标工程。
首批样本抽取是「固定协议 + 脚本辅助」，不是黑箱全自动语义抽取。
skills/dbs-content-system/SKILL.md
这里说的「自动抽取」，不是写一个虚假的全自动语义脚本批量乱拆，而是让 skill 直接按固定协议，从用户指定的 `3` 到 `5` 篇样本文稿里产出第一批内容单元。
注：协议要求每篇样本强制抽 1 个 QST + 1 个 OPI，视情况补 CON/CAS/SOL，并规定「不要假装可以一次把文稿里的所有语义对象抽全」。
结构先于规模：先用样本验证字段/关系/去重口径稳定，再批量推进；批量转全量另有 7 条闸门（含抽查 30 个单元误判≤3）。
skills/dbs-content-system/SKILL.md
#### `批量模式 → 全量模式` 升档闸门
注：样本转批量要求关系校验目标缺失数为 0、状态层文件可重建；批量转全量要求连续 2 批不改字段/关系/去重规则，并「- 人工抽查 `30` 个内容单元，重大误判不超过 `3` 个」。
「能用」有可验收定义：骨架、规则、素材副本、首批单元、主题地图、装配稿、关系与去重索引、状态总览齐备即可交付，不承诺全量完成。
skills/dbs-content-system/SKILL.md
- `03-处理状态/处理状态总览.md` 已明确当前范围、未处理量与下一步入口
注：配套默认数量目标「- 至少产出 `15` 个内容单元」，以及 docs/acceptance.md 的首次交付最低标准。
执行纪律要求真动手：不要停在建议层，素材不够就直接指出，边界混乱就先收缩边界；并明确与其它 skill 的转入口。
skills/dbs-content-system/SKILL.md
- 不要停留在建议层
注：转入口写明「- `/dbs-good-question` 已把问题说明书写清楚，且适合自动化执行」；同时规定本 skill 不自行选择下一个 Skill。
2核心能力
01审计门槛判定（数量 50 文件/80000 字 + 来源 2 类 + 纳入排除边界）
02工程骨架初始化与资产分发（init-content-system.js 复制模板/scaffold/工具）
03原始素材副本与三张状态表（来源注册表/原始素材索引/待处理清单）
04首批样本抽取协议（3-5 篇、每篇强制 QST+OPI、补齐来源/主题/关键词/关系）
05内容单元规范（独立文件、ID_标题.md、frontmatter、7 个最小字段、4 类关系、4 类去重）
06主题地图与选题装配稿产出（≥3 张地图、≥2 份装配稿）
07关系/去重/状态索引校验链路（8 条可跑命令）
08四模式逐档升级闸门与可用态判定
09随 skill 分发的 10 个 Node 工具（init/source-registry/ledger/unit-draft/extract/assemble/link-map/duplicate/obsidian-links/summarize）
3外部依赖
| 类型 | 依赖 |
|---|---|
| cli | node |
| cli | npx skills（skills.sh CLI，安装途径） |
4风险提醒 风险提醒：蓝色 · 知晓即可
风险提醒：蓝色 · 知晓即可
- 抽取器对作者自有语料特化，换语料会静默降级 — extract-sample-units.js 内含硬编码上下文判定（如 /生产型兴趣/、/686种组合/、/赛道思维/ 等），对陌生题材会走通用兜底分支，产出质量下降且不报错；使用者应按 docs/acceptance.md 抽查单元质量。
- 脚本按 cwd/参数写盘，跑错目录会污染工作目录 — 多数脚本以 `path.resolve(process.cwd())` 为工程根，必须在目标工程内运行；只有 init 脚本接受目标目录参数。
- 会复制用户全部源素材到新工程 — 素材副本进 `01-原始素材区/完整副本/`，含敏感/未发布内容时形成第二份拷贝，使用者需自行决定纳入范围（审计门槛要求明确排除目录）。
- 清理是移动到 .trash 而非删除，磁盘占用持续增长 — 重复单元清理只做 rename；长期使用会在工程内留下 .trash 目录树，需人工清理。
- 「可重组」依赖启发式推荐，非语义保证 — assemble-topic-from-units.js 的 --auto 按标题与关键词推荐单元，docs/quickstart.md 也要求「自动推荐结果已经可以作为第一版装配稿，但正式对外输出前仍要人工复核」。
风险提醒：蓝色，知晓即可。判级对象为 skill 自身目录：其中自带 10 个 Node 脚本（仅 require("fs")/require("path")），对本地工程做建目录、复制、写文件、移动文件到 `.trash` 等读写；全目录零网络端点、零凭证读取、零子进程、零任意代码执行（危险 token 扫描 ZERO HITS），故落蓝色档（仅本地脚本与本地读写，无外发）。注意点：① 脚本会复制用户源目录到新工程并写大量文件，运行目录（cwd）与目标工程由用户/agent 决定，跑错目录会污染当前工作目录；② 清理重复单元用 rename 进 `.trash` 而非删除，文件仍在磁盘上；③ extract-sample-units.js 是语料特化启发式脚本，非通用语义抽取器，误抽需人工复核。
5第二遍独立确认
- [ok] 自包含声明与资产面一致 — SKILL.md 列出的 templates/（7）、scaffold/root/（4）、scaffold/rules/（6）、docs/（2）、tools/（10）与 find 清点结果逐项吻合，无缺失文件。
- [ok] 脚本仅本地读写、无网络无凭证 — 10 个脚本全部 `const fs = require("fs");` + `const path = require("path");`；grep https?://|fetch(|child_process|execSync|spawn|process.env|API_KEY 零命中。
- [ok] 写盘范围限定在目标工程 — init 脚本所有目标路径均由 skillRoot/targetRoot 派生；extract 脚本的清理用 `fs.renameSync(filePath, target)` 移入 `<root>/.trash/{日期}_{原因}/`（不删除）。
- [discrepancy] 抽取器非通用语义引擎（能力边界） — SKILL.md 声明「不是写一个虚假的全自动语义脚本批量乱拆」，但 extract-sample-units.js 内含大量作者语料特化正则（如 `if (/生产型兴趣/.test(context.conceptText) && /兴趣/.test(context.normalizedTitle) && /赚钱|变现/.test(context.normalizedTitle)) {`），换语料会退化到通用兜底分支；这不是「虚假」，但确属「对自有语料特化」，已在 risks 写明。
- [ok] 四档闸门与数量门槛 — 审计/样本/批量/全量四模式与各自闸门标题均在原文；50 文件/80000 字、≥15 单元、≥3 地图/≥2 装配稿、抽查 30 误判≤3 逐字命中。
- [ok] 源文件只读与副本制 — 「原目录里的原文件不碰。」+ 原则 3 标题「### 原则 3：原始素材不改写，只复制副本」逐字命中。
- [ok] description 与内容相符 — description（把本地文稿/推文/选题/案例/课程稿整理成可持续生长、可重组复用的内容工程）对应五类单元 + 主题地图 + 装配稿 + 四模式推进，无夸大；但「可重组复用」的可验证证据是 assemble-topic-from-units.js 的 --auto 跨主题推荐，属启发式实现。
- [ok] commit / license / 元数据 — HEAD = 8b8e33f1ecaed8cee606fe950c4426b525ead314；LICENSE = CC BY-NC 4.0（含 NonCommercial，非商业授权）；stars 10121、pushed_at 2026-09-07T03:48:59Z。
6结论
适合：适合已有大量本地内容资产（数十篇以上文稿/推文/课程稿/案例）、想把「库存」变成可复用工程的人：典型流程是审计规模与边界 → 初始化工程 → 复制素材与索引 → 样本抽取出 15+ 内容单元 → 主题地图与装配稿 → 用真实单元重组新选题；配套 Obsidian 的 [[文件名]] 链接可形成节点关系视图。
不适合：不适合零散素材或单篇润色（审计门槛会直接拦下并给降级路径）；不适合一口气想吃完整库的期待（skill 只承诺推到「系统能用了」，全量推进另有闸门）；不适合需要云端协作/多人并发的团队（纯本地 Markdown + Node 脚本）；也不适合把抽取结果当成品发布——docs/acceptance.md 与 quickstart 都要求人工复核。
安装 agent 直装可复制
① 本站镜像 更新 2026-09-15
方式 A · 人下载镜像包下载 dbs-content-system.tar.gz
sha256:
方式 B · JSON 格式安装指南，复制给 agentb0d6fde8b85e94cf…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库dontbesilent2025 / dontbesilent2025/dbskill
原始 GitHubdontbesilent2025/dbskill ↗
Stars10121
最近推送2026-09-07
本 skill commit
8b8e33f1ec许可CC BY-NC 4.0（Attribution-NonCommercial 4.0 International；仓库根 LICENSE 明文 NonCommercial — 非商业授权，不得商用；GitHub API license=NOASSERTION/Other，因 CC BY-NC 不在 SPDX 常见许可标识内；Copyright (c) 2026 dontbesilent）
本站信息
收录日期2026-09-06
分类内容创作
侦查报告AI 侦查 · 2 遍 · 2026-09-06
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。