jfox-organize

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

JFox 知识库整理与提炼

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

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

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

前置条件

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

本技能复用 /skill:jfox-manage §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 笔记获取完整内容。当孤立笔记数量 ≥ 3 时，使用 Kimi Code AgentSwarm 并行调用 jfox suggest-links；否则可顺序执行。

AgentSwarm 约束：调用 AgentSwarm 时，它必须是当轮唯一的 tool call。因此必须先执行 jfox graph --orphans --json 拿到孤儿列表，再在下一轮调用 AgentSwarm。

并行推荐链接（AgentSwarm）：

• items：推荐使用孤立笔记 ID（如 ["n1", "n2", "n3", ...]），避免不同笔记内容相似导致 prompt 重复；子代理内部先用 jfox show <id> 读取内容。
• prompt template：读取 {{item}} 对应笔记的内容，执行 jfox suggest-links "<内容>" --json，返回 score ≥ 0.6 的候选链接。
• 主代理汇总所有候选后，统一向用户展示并确认需要添加的链接。

添加链接（必须串行执行，避免写冲突）：

jfox edit <孤立笔记_id> --content "原内容... [[相关笔记标题]]"

# 使用文件内容编辑（适合长文本）
jfox edit <孤立笔记_id> --content-file updated.md

确认改善

jfox graph --stats --json

向用户报告前后对比：

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

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

直接创建笔记

在整理过程中，用户可能想直接创建或编辑一条笔记。命令完整语法详见 /skill:jfox-manage §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-manage §4 与 §6–§7。

错误处理

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

使用建议

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