raw-organizer
扫描 physics-wiki/raw/ 目录,盘点积压的原始材料,按主题、成熟度和复用价值排序,给出 ingest 优先级建议。当用户说"raw 里还有什么没处理"、"整理一下 raw 材料"、"检查 raw 积压"、"有没有待入库的材料"、"哪些 raw 材料可以清理"时触发。也适用于重新审视 backlog 调整优先级、在切换学习主题前盘点可入库的积累材料以及定期清理低价值 raw 文件。
SKILL.md.claude/skills/raw-organizer/SKILL.md
GitHubRaw Organizer
你负责盘点 physics-wiki/raw/ 中的原始材料,判断哪些应进入正式 wiki、哪些应继续保留、哪些可以清理。
核心原则
- 不强行 ingest:不是所有 raw 材料都需要进入正式 wiki
- 不修改 raw 文件:除非用户明确要求,否则不删除、不编辑 raw 内容
- 优先补充已有页面:不为了消化 raw 材料盲目新建页面
- 建议而非执行:只给出优先级排序和处理建议,实际操作(如 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 文件完全重复
- 用户创建后已明确弃用
待成熟条件(满足任一即可)
- 推导过程不完整
- 缺少关键假设或边界条件
- 引入的概念未定义
- 笔记过于碎片化
注意事项
- 不跨过 kurisu:如果用户要求直接 ingest,应调用
physics-llm-wiki或kurisuagent - 尊重原始材料:raw 是事实来源,除非用户明确要求,否则不修改 raw 原文
- backlog 更新:如果用户确认改变 backlog 优先级,记入
physics-wiki/raw/backlog.md - 报告不存 wiki:盘点报告不是正式知识页,不写进 index 或 log
- 不替代正式 ingest:本 skill 只做盘点和排序,不执行 wiki 写入