knowledge-repo-workflow

name	knowledge-repo-workflow
description	Use when: organizing a markdown knowledge repository, importing sources into 原始资料, compiling 来源笔记/概念/主题, maintaining 索引, generating 派生内容, running knowledge base health checks, or consolidating fragmented notes from 原始资料/碎片记录. Trigger with: /knowledge-repo-workflow

知识库工作流 Skill

这个 skill 用于在当前仓库中执行一整套知识库整理流程。它假定仓库使用如下目录结构：

• 原始资料/
• 知识库/
• 派生内容/
• 检查/
• 工具/

其中：

• 原始资料/ 保存未整理的来源和碎片记录。
• 知识库/ 保存整理后的长期 Markdown 知识。
• 派生内容/ 保存针对任务生成的回答、报告、幻灯片和可视化。
• 检查/ 保存健康检查结果。

何时使用

在下面这些任务里优先使用这个 skill：

1. 你刚手动导入了一批资料，想整理进知识库。
2. 你想把来源材料编译成来源笔记、概念页或主题页。
3. 你想基于知识库生成回答、报告、幻灯片或总结。
4. 你想检查知识库中的重复、孤立页面、缺来源支撑和过期结论。
5. 你想把 原始资料/碎片记录/ 里的碎片知识聚类并沉淀为正式知识。

执行原则

1. 先判断输入属于原始资料、碎片记录、知识库更新还是派生输出。
2. 优先增量处理，不要无必要重写整库内容。
3. 优先在 知识库/ 中复用已有概念和主题，避免制造重复页面。
4. 生成内容时必须尽量保留到来源的可追溯性。
5. 如果信息不足以进入 知识库/，先停留在 原始资料/碎片记录/ 或 知识库/来源笔记/。
6. 当概念页或主题页由偏弱来源支撑时，优先显式写出“证据状态”，不要把整理性结论伪装成强结论。
7. 每次沉淀概念页或主题页后，把来源笔记状态回写和索引更新视为默认收尾动作。

推荐执行流程

模式一：导入后整理

当用户刚把资料放进 原始资料/ 后：

1. 扫描新增文件。
2. 判断哪些资料还没有对应的来源笔记。
3. 在 知识库/来源笔记/ 生成或更新来源笔记。
4. 更新 知识库/索引/ 中的待整理清单或来源索引。
5. 如果待整理清单已有旧积压，不要只覆盖“本次新增”，而是维护真实 backlog。

模式二：概念与主题编译

当用户希望从资料形成可复用知识时：

1. 读取相关 知识库/来源笔记/。
2. 先区分来源笔记中的“候选概念 / 候选主题”和“已编入概念 / 已编入主题”。
3. 抽取高频概念，合并到 知识库/概念/。
4. 将多个概念和来源串联为 知识库/主题/ 下的综述页。
5. 对新增或更新的概念页、主题页，补写或校正“证据状态”，至少说明条目性质、当前来源基础和使用边界。
6. 对已正式沉淀的概念页和主题页，回写到来源笔记的“已编入条目”中，尽量使用显式 Markdown 链接，并清理已经过期的后续整理建议。
7. 必要时更新 知识库/摘要/ 和 知识库/索引/，尤其检查是否要补进总索引或对应知识簇索引。

模式三：问答与报告输出

当用户提问或要求生成分析结果时：

1. 优先读取 知识库/。
2. 如证据不足，再回查 原始资料/。
3. 将结果写入 派生内容/回答/、派生内容/报告/、派生内容/幻灯片/ 或 派生内容/可视化/。
4. 如果结果具有长期复用价值，再建议沉淀回 知识库/。

模式四：碎片知识整理

当用户处理未成文的零散知识时：

1. 扫描 原始资料/碎片记录/。
2. 对碎片按主题聚类。
3. 去除明显重复项。
4. 尽量补充来源、时间、上下文。
5. 能形成稳定条目的，写入 知识库/概念/ 或 知识库/主题/。
6. 仍不稳定但有价值的，先写入 知识库/来源笔记/ 或保留在 原始资料/碎片记录/。

模式五：健康检查

当用户要求检查知识库质量时：

1. 查找重复概念页。
2. 查找孤立页面。
3. 查找缺少来源支撑的结论。
4. 查找可能过期的结论。
5. 查找来源笔记中的“已编入条目”“候选条目”“后续整理建议”是否互相冲突。
6. 将结果写入 检查/ 下的新报告。

输出要求

1. 除非用户明确要求只做分析，否则优先直接修改或生成文件。
2. 输出内容要尽量中文化，除非来源术语必须保留英文。
3. 文件名尽量清晰，优先使用日期加主题的命名方式。
4. 不要把一次性回答直接混入 知识库/，除非它已经适合长期复用。
5. 来源笔记中优先保留三层关系：候选概念 / 候选主题 / 已编入条目。
6. 对已经存在的概念页和主题页，优先使用显式链接而不是仅保留纯文本词项。
7. 更新 知识库/索引/待整理清单.md 时，默认把它当作 backlog 和补证清单，而不是“今日新增”流水账。
8. 知识库条目和派生内容的文风与排版遵循 工作流.md 中“输出可读性要求”一节，不要在本 skill 重复细节。

可直接触发的示例

/knowledge-repo-workflow 扫描 原始资料/文章/ 和 原始资料/论文/ 新增的文件，更新 知识库/来源笔记/，并维护 知识库/索引/待整理清单.md 的 backlog 状态

/knowledge-repo-workflow 基于 知识库/来源笔记/ 提炼新概念，并更新 知识库/概念/ 和 知识库/主题/

/knowledge-repo-workflow 基于 知识库/主题/ 回答一个问题，并把结果写入 派生内容/回答/

/knowledge-repo-workflow 整理 原始资料/碎片记录/ 中的碎片知识，聚类、去重、补全上下文，并沉淀到 知识库/