knowledge repo workflow

Writing Community
Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
Writing
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
88 / 100 · heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@0-Avalon-0 · no license declared
Token usage
Lean
Setup complexity
Plug-and-play
External API key
Not required
Operating systems
Unspecified (assume cross-platform)
Runtime requirements
No explicit requirements detected
Detected file/system behavior
  • Read-only
Network behavior
Local-only
Install commands
None (reference only)

Heads up: Tool permissions are not declared; actual access depends on the runtime.

Author source file SKILL.md

# 知识库工作流 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 重复细节。

## 可直接触发的示例

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

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

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

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

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.