raw-organizer

扫描 physics-wiki/raw/ 目录,盘点积压的原始材料,按主题、成熟度和复用价值排序,给出 ingest 优先级建议。当用户说"raw 里还有什么没处理"、"整理一下 raw 材料"、"检查 raw 积压"、"有没有待入库的材料"、"哪些 raw 材料可以清理"时触发。也适用于重新审视 backlog 调整优先级、在切换学习主题前盘点可入库的积累材料以及定期清理低价值 raw 文件。

SKILL.md

GitHub

Raw Organizer

你负责盘点 physics-wiki/raw/ 中的原始材料,判断哪些应进入正式 wiki、哪些应继续保留、哪些可以清理。

核心原则

  1. 不强行 ingest:不是所有 raw 材料都需要进入正式 wiki
  2. 不修改 raw 文件:除非用户明确要求,否则不删除、不编辑 raw 内容
  3. 优先补充已有页面:不为了消化 raw 材料盲目新建页面
  4. 建议而非执行:只给出优先级排序和处理建议,实际操作(如 ingest)需用户确认或交给 kurisu

raw 目录结构

raw/ 包含以下子目录:

  • backlog.md — 全局 backlog 清单
  • notes/ — 笔记类材料
  • papers/ — 论文原文或摘录
  • problems/ — 题目草稿
  • conversations/ — 对话记录
  • lectures/ — 讲义材料
  • books/ — 教材摘录
  • 根目录 — 散落的原始文件

工作流程

第一步:扫描 raw 目录

# 列出所有文件(递归)
ls -R physics-wiki/raw/
# 或按类型逐个目录检查

对每个文件记录:文件名、大小、最后修改时间、所在目录。

第二步:读取 backlog

如果 physics-wiki/raw/backlog.md 存在,读取其中记录,了解哪些材料已有处理计划。

第三步:交叉检查 wiki

对每个文件粗略判断:

  • 对应的概念/推导/方法是否已在 wiki 中有正式页面
  • 已有页面是否已充分覆盖该 raw 材料的内容
  • 该 raw 材料是否还包含 wiki 没有的新内容

第四步:分类

将每个 raw 材料归入以下类别:

类别 说明 建议动作
高优先级 内容成熟、与当前学习主线相关、wiki 尚未覆盖或有补充价值 建议尽快 ingest
中优先级 内容基本可用但与当前主线关系不大,或 wiki 已有粗略覆盖 建议后续处理
低优先级 零散想法、未完成草稿、与 wiki 重复 继续保留 raw
可清理 明确不再需要的内容(过时草稿、重复文件、空文件) 建议清理(需用户确认)
待成熟 有价值但尚未成熟的推导/笔记 继续保留 raw 等成熟后再处理

第五步:生成报告

输出格式

## Raw 材料盘点报告

### 概览
- raw 目录文件总数:N
- 高优先级:N(建议本周处理)
- 中优先级:N
- 低优先级:N
- 可清理:N
- 待成熟:N

### 高优先级材料
| 文件 | 大小 | 主题 | wiki 覆盖 | 建议处理 |
|---|---|---|---|---|
| `raw/path` | XX KB | 简述 | 已/未覆盖 | 建议 ingest 到 [[某页面]] |

### 中优先级材料
(同上表格)

### 低优先级材料
(简要列出)

### 待成熟材料
(列出需要哪些条件才能成熟)

### 可清理材料
(列出建议清理的文件)

### 与本轮学习主线相关
- 当前主线:根据 hot-cache 判断
- 相关 raw 材料:
- 建议优先处理:

### 后续建议
- 建议优先 ingest:
- 建议 kurisu 处理:
- 可暂时不管:

判断标准

高优先级条件(满足任一即可)

  • 与当前学习主线直接相关(参考 hot-cache.md)
  • 内容已经成熟(有完整推导/完整笔记)
  • wiki 中完全没有覆盖
  • 用户明确要求重点处理

中优先级条件(满足任一即可)

  • 内容基本完整但与当前主线关系不大
  • wiki 已有粗略覆盖但 raw 材料有新的补充
  • 跨学科内容但暂时不急需

低优先级条件(满足任一即可)

  • 零散想法未成形
  • 内容已被 wiki 完全覆盖
  • 不可靠的推导或未验证结论
  • 聊天记录中没有实质知识内容

可清理条件(满足任一即可)

  • 空文件
  • 实验性草稿已无参考价值
  • 与 wiki 或其它 raw 文件完全重复
  • 用户创建后已明确弃用

待成熟条件(满足任一即可)

  • 推导过程不完整
  • 缺少关键假设或边界条件
  • 引入的概念未定义
  • 笔记过于碎片化

注意事项

  1. 不跨过 kurisu:如果用户要求直接 ingest,应调用 physics-llm-wiki 或 kurisu agent
  2. 尊重原始材料:raw 是事实来源,除非用户明确要求,否则不修改 raw 原文
  3. backlog 更新:如果用户确认改变 backlog 优先级,记入 physics-wiki/raw/backlog.md
  4. 报告不存 wiki:盘点报告不是正式知识页,不写进 index 或 log
  5. 不替代正式 ingest:本 skill 只做盘点和排序,不执行 wiki 写入