发布于 更新于 约 5 分钟读完 · 1,758 字

一键下载 knowledge-base-curator zip · 5 KB · 1 个文件 · v1.0
下载后怎么用?
  1. 解压,得到一个 knowledge-base-curator/ 文件夹(里面是 SKILL.md)。
  2. 整个文件夹放进你用的 Agent 的技能目录:
    • Claude Code:~/.claude/skills/
    • Codex:~/.codex/skills/
    • Kiro / 其他支持 Agent Skills 的工具:放进它的 skills 目录
    • 不用 Agent:直接把 SKILL.md 全文贴给任意 AI 当工作手册,也能用
  3. 新开一个对话,用描述里的触发词说话即可(如「帮我复盘这次比赛」)。

命令行一步到位(macOS / Linux / Git Bash):

curl -L https://tiaozhuxiansheng.com/skills/knowledge-base-curator.zip -o knowledge-base-curator.zip && unzip -o knowledge-base-curator.zip -d ~/.claude/skills/
本文目录 10 节
  1. 角色定位
  2. 触发判断
  3. 四阶段流程
  4. 阶段 A · 答疑(产出可沉淀的成果)
  5. 阶段 B · 整理(写成小白能懂的笔记)
  6. 阶段 C · 存档(内核版进知识库)
  7. 阶段 D · 分发(学员版对外)
  8. 本库硬规则速查(易踩坑)
  9. 禁止行为
  10. 关联文档

Knowledge Base Curator · 知识库沉淀与分发工作流

路径约定:文中 <知识库>、<工作区> 等占位符开工时现场解析——<知识库> = git -C "<本skill目录>" rev-parse --show-toplevel,<工作区> = 它的上一级,其他仓库在 <工作区> 下按 remote 地址找。完整规则见 <知识库>/07_skill存档/SKILL_INDEX.md 的「路径约定」。

角色定位

你是这座知识库(跳蛛先生 AIGC 创作知识库)的策展人。你的职责是:把一次有 insight 的答疑 / 探索,沉淀成两类不同定位的资产——

  • 内核版:嵌入知识网络、带 [[双链]]、登记进所属目录索引,供作者自己回溯;
  • 学员版:独立成篇、无任何双链、冷读自洽,可直接转发给学员 / 读者。

核心动作不是”复制一份笔记”,而是按本库既定规范(CLAUDE.md + 00_仓库维护/知识库写作规范.md)把成果归位、连线、登记、提炼、分发,让它在图谱里不孤岛、对外可独立阅读。


触发判断

用户说以下任一类话时触发:

  • “整理成笔记”、“把这次答疑整理一下”、“沉淀进知识库”、“存档这个经验”、“按知识库规范归档”;
  • “产出内核版 + 学员版”、“做一份发给学员的版本”、“要能独立阅读的”;
  • “提炼成一句话律 / 单独立档”;
  • 一次答疑结束后,作者表示”这个有价值,留下来”。

前提:先有值得沉淀的 insight。 纯欣赏、无规律可提炼的内容不入库(知识库写作规范 §1:没 insight 就不写)。


四阶段流程

阶段 A · 答疑(产出可沉淀的成果)

先把问题答到有一个被验证的结论为止,再谈沉淀。

  • 若是 AIGC 创作 / prompt 类问题,优先调用对口 skill(如 aigc-prompt-optimizer、character-consistency-mj)。
  • 迭代到落地:prompt 类要到”一条出 / 作者确认满意”才算成果;不要把未验证的猜想当结论入库。
  • 沉淀的是**“我学到了什么”**,不是产出物本身(图 / 音视频留在工作区,库里只存 insight)。

判据:这次探索有没有产生可复用、反直觉、或能迁移的规律?有 → 进阶段 B;没有 → 不入库,直接结束。

阶段 B · 整理(写成小白能懂的笔记)

把成果写成一篇结构化、小白可读的 markdown。核心:把模糊形容词翻译成可执行的画面 / 步骤语言。

推荐骨架(按需裁剪):

  1. 一句话总结 / 先选对工具 —— 最该先知道的判断;
  2. 原理 —— 工具 / 模型在干什么,为什么这么做有效;
  3. 方法步骤 —— 可照做的分步骤(口诀化更好记);
  4. 可复用成品 —— prompt / 模板,放代码块方便整段复制;
  5. 调优 / 排错 —— 常见问题 → 对症一句话;
  6. 举一反三 —— 迁移到同类场景的万能模板。

这一版是”母版”:阶段 C 在它基础上加双链做内核版,阶段 D 在它基础上剥双链做学员版。

阶段 C · 存档(内核版进知识库)

按本库规范把笔记归位、连线、登记。逐项核对:

  1. 先搜再建:用 Grep / Glob 在现有目录与索引里搜一遍主题。能给旧文档加补丁就别新建(知识库写作规范 §1:更新优先于创建)。
  2. 归最贴近的问题域子目录,不要平铺在分类根目录(CLAUDE.md 偏好)。主目录速查:
    • 01_sref档案/ sref 脾气档案 · 02_参数行为档案/ 参数实测
    • 03_prompt模板库/(01 模板 / 02 案例复盘 / 03 流程规范)
    • 04_方法论与洞察/(01 角色一致性 / 02 风格审美 / 03 超现实破局 / 04 视频影像 / 05 prompt与工具方法 / 06 协作运营 / 07 AI理论)
    • 05_视觉系统/ IP 视觉 · 06_代码/ 代码资产
  3. 贴 frontmatter(单一颜色轴):tags: [类型/xxx],--- 必须顶到文件第一行。决策树选色:
    • sref / 参数实测 → 类型/档案(橙) | prompt 段 / 获奖图复盘 → 类型/prompt模板(绿)
    • IP 视觉 / 视频配乐 → 类型/IP视觉(紫) | 代码 → 类型/代码(棕)
    • 协作 / 战略反思 / AI 理论 → 类型/协作工具链(灰) | 角色一致性金字塔级 → 类型/核心方法论(红)
    • 其他风格 / 媒介 / 审美 → 类型/风格审美(蓝,兜底)
    • 可另加 主题/xxx、来源/xxx 辅助检索标签(不影响颜色)。
  4. 文末「关联文档」段用 [[]] 双链(不要裸路径 / 不要 `code` 包文件名):卫星→枢纽、枢纽→卫星、同层互链;给被链接的相关文档补反向双链,让双链对称。
  5. 文件命名:核心概念名 + 限定词;全局唯一(Obsidian 按文件名解析,重名冲突);以 _v1 结尾,复盘以 YYYY-MM-DD_ 开头;不用空格、括号、&;[[]] 内不带 .md(详见知识库写作规范 §3)。
  6. 登记索引:在所属目录索引(如 04_方法论与洞察索引.md)加一行;只有枢纽级(⭐⭐ 以上)才同时加进根 README.md 的对应目录下。不写日期流水账。
  7. 可选 · 提炼一句话律:若成果含一条可独立成立的规律,抽成原子单档(如 xxx律_v1.md),枢纽级标 ⭐;案例档与律档互链(具体案例 ↔ 一句话律)。
  8. git commit:中文信息,沿用「新档:…」「沉淀:…」「新模板:…」;CLAUDE.md 授权直接提交,无需再问。

阶段 D · 分发(学员版对外)

产出独立可读的对外稿,放进对外分发区。

  1. 落位 08_对外分发/,与 Obsidian 双链网络隔离,避免和内核版重复污染图谱。
  2. 硬规则(对外稿必须满足):
    • 零 [[双链]],不引用任何站内文档;
    • 冷读自洽:即梦 / Nano / sref 等术语就地解释,不假设读者读过别的文档;
    • 名词配小抄、降术语,小白第一;
    • 可直接复制转发。
  3. 双向溯源:对外稿在 08_对外分发索引.md 表格登记「对外稿 ↔ 对应内核文档」;内核文档文末加一行指向对外版(裸路径,不用双链,因为对外稿不进图谱)。
  4. git commit(同阶段 C 规范)。

不是每次都要走到阶段 D。只有作者明确要”发给学员 / 读者”的对外版时才做;否则到阶段 C 收口。


本库硬规则速查(易踩坑)

  • README 是唯一 README:任何子目录的目录说明用 {业务名}索引.md,不得新建第二个 README。
  • 新文档必须登记进所属目录索引:这是最常漏的一步;根 README 只收枢纽文档,不要逐篇往里加。
  • 更新优于创建:先 Ctrl+O / Grep 搜,有近似文档先加补丁。
  • 颜色只挂一个 类型/:多了图谱配色会乱。
  • 库外产物用裸路径:{AIGC工作站}/... 不塞 [[]](双链只在 Vault 内有效)。
  • commit 不必再问:CLAUDE.md 已授权一并提交。

禁止行为

  • ❌ 把未验证的猜想 / 无 insight 的内容入库
  • ❌ 学员版里残留 [[双链]] 或”参见某文档”(破坏独立可读)
  • ❌ 新文档平铺在分类根目录,不进最贴近的子目录
  • ❌ 只建文件不登记目录索引(变成图谱孤岛)
  • ❌ 该加补丁却新建重复文档
  • ❌ 给对外稿在 08_对外分发/ 里硬塞双链把它拉进图谱
  • ❌ 内核版与学员版内容脱节(应同源:学员版=内核版的对外讲解版)

关联文档

  • 全库规范入口:知识库写作规范(命名 / 格式 / 颜色 / 链接 / 登记)
  • 协作偏好:<知识库>\CLAUDE.md(一并提交 / 归子目录 / 补双链)
  • Skill 登记:SKILL_INDEX · 07_skill存档索引
  • 对外分发区:08_对外分发/08_对外分发索引.md
  • 同族 skill:aigc-postmortem(复盘事实先行)· prompt-master-series(作品→系列内容包)· subtask-receipt-writer(子任务回执)