jfox-organize

name

jfox-organize

description

Organize, refine, and optimize a Zettelkasten knowledge base. Use when user wants to organize their knowledge base, process inbox, refine fleeting notes into permanent notes, add wiki links, merge notes, or optimize the knowledge graph. Triggers on: "整理知识库", "清理 inbox", "提炼笔记", "组织笔记", "看看有什么可以整理的", "合并笔记", "生成链接", "organize", "process inbox", "refine notes", "knowledge graph optimization", "clean up notes", "link notes".

JFox 知识库整理与提炼

JFox 的核心提炼技能。将原始 fleeting 笔记转化为结构良好、互相链接的 permanent 知识。

三步流程：收件箱分析 → 提炼（fleeting → permanent，自动生成 [[wiki links]]）→ 图谱优化。

此外支持在整理过程中直接创建和编辑笔记。

前置条件

知识库中已有笔记。如果知识库为空，建议先调用 ingest 技能（/skill:jfox-ingest）导入内容。

本技能复用 /skill:jfox-common §4.1 的共享约定（--kb / --json / --content-file），下文示例统一使用 --json 简写。

Step 1: Inbox 分析

jfox inbox --json --limit 50

列出所有 fleeting / session 未处理笔记（jfox inbox 涵盖两种类型）。对结果进行分组分析：

1. 按 source:* 标签分组：例如所有 source:git-log 的笔记归为一组
2. 组内识别可合并子组：主题相近、相关的 commits/issues 归入同一子组
3. 向用户展示提炼建议：

收件箱: N 条 fleeting 笔记

提炼建议:
1. [合并] 15 条 jfox git-log commits → "JFox 近期开发总结" (permanent)
2. [合并] 5 条 jfox PR → "JFox PR 技术决策汇总" (permanent)
3. [逐条] 3 条手动输入笔记 → 逐条处理
4. [删除] 2 条过时笔记 → 清理

等待用户确认要执行哪些建议。

Step 2: 提炼（fleeting → permanent）

这是本技能的核心能力。对用户确认的每条建议执行提炼：

提炼流程

1. 分析：阅读分组内的 fleeting 笔记，提取核心知识点

2. 查找关联：

   jfox suggest-links "<提炼后的内容摘要>" --json
   

   筛选 score >= 0.6 的关联笔记

3. 生成 permanent 笔记：将核心知识点整理为结构化内容，嵌入 [[wiki links]] 关联到已有笔记

4. 批量交叉链接：如果同一批正在创建多条 permanent 笔记，在它们之间也添加 [[links]]

5. 插入：

   jfox add "<包含 [[links]] 的内容>" --title "<标题>" --type permanent --tag <tag1> --tag <tag2> [--kb <name>]
   

6. 归档源 fleeting：

   jfox archive <原始-id>
   

   archive 是软删除（文件保留），jfox unarchive 可恢复；误判可回滚，清理源笔记统一用 archive 而非 delete --force。

提炼策略表

来源	策略	permanent 示例
git-log（多个 commits）	按时间段/主题合并，提取技术决策和变更摘要	"JFox v0.1.4 技术变更总结"
github-pr（多个 PRs）	提取核心设计决策、争议点、最终方案	"JFox PR#94 编辑命令的设计讨论"
github-issue（多个 issues）	提取问题本质、解决方案、经验教训	"JFox BM25 索引问题及修复方案"
手动输入	根据内容判断是否值得提炼，内容足够成熟则转为 permanent	—

Step 3: 图谱优化

查找孤立笔记

jfox graph --orphans --json

对每条孤立的 permanent 笔记：

1. 获取笔记内容

2. 查找关联：

   jfox suggest-links "<内容>" --json
   

3. 如果有匹配度 >= 0.6 的结果，建议添加链接：

   jfox edit <孤立笔记_id> --content "原内容... [[相关笔记标题]]"
   
   # 使用文件内容编辑（适合长文本）
   jfox edit <孤立笔记_id> --content-file updated.md
   

确认改善

jfox graph --stats --json

向用户报告前后对比：

指标	含义	健康目标
avg_degree	平均每条笔记的链接数	> 2.0
isolated_nodes	无链接的孤立笔记数	< 总数的 20%

展示整理前后的指标变化。

密度交接（MOC 触发点）

图谱优化发现某主题笔记数量多（靠搜索/双链找不全）或孤儿笔记密集时，说明该主题已达建 MOC 阈值——移交 /skill:jfox-moc（moc diagnose → create）。

职责边界：organize 管单条笔记加链接；jfox-moc 管主题簇地图。

直接创建笔记

在整理过程中，用户可能想直接创建或编辑一条笔记。命令完整语法详见 /skill:jfox-common §4。本技能的工作流约束：

• 对 permanent 笔记：先运行 jfox suggest-links "<内容摘要>" --json 取匹配度 ≥ 0.6 的结果作为 [[wiki links]] 候选，再以含链接的内容调用 jfox add --type permanent
• 对 fleeting 笔记：直接 jfox add（默认即 fleeting），链接留到后续提炼阶段
• 默认类型：fleeting（快速记录，后续用本技能提炼）；只有当内容已是成熟知识时才用 permanent

命令参考

整理工作流专属命令：

jfox inbox --json --limit <N>                 # 查看收件箱（fleeting + session 笔记）
jfox suggest-links "<content>" --json         # 推荐 [[wiki links]] 候选（按相似度排序）
jfox graph --orphans --json                   # 查找孤立笔记
jfox graph --stats --json                     # 图谱统计指标（avg_degree、isolated_nodes 等）

jfox add / edit / delete / list / show / daily 等通用命令以及 daemon 用法详见 /skill:jfox-common §4 与 §6–§7。

错误处理

• 收件箱为空 → 告知用户 "收件箱为空，无需整理"，可跳到 Step 3 图谱优化
• jfox suggest-links 返回低匹配度（score < 0.6）→ 跳过链接推荐，不强制添加
• jfox archive 目标 ID 不存在 → 报告错误，跳过继续处理其他笔记

使用建议

• 定期整理：建议每周处理一次收件箱，避免 fleeting 笔记堆积超过 30 条
• 大胆链接：Zettelkasten 的价值在于连接，而非数量。多使用 [[links]] 连接相关概念
• 用标签分组，用链接表达思想：--tag 按主题归类，[[links]] 按思维关联