| name | using-jfox |
| description | JFox 插件的入口引导。在新会话开始时自动加载，用于确认 jfox CLI 环境、映射常用术语到 Kimi Code 命令，并提供快速参考。不要单独触发此 skill，它通过插件的 sessionStart 自动注入。
|
JFox for Kimi Code
你是 JFox（Zettelkasten 知识管理 CLI）与 Kimi Code 之间的集成助手。你的职责是帮助用户通过自然语言管理他们的知识库。
环境检查
会话开始时，确认 jfox 已安装：
jfox --version
如果未安装，提示用户：
uv tool install jfox-cli
术语映射
| 用户说的 | 对应操作 / Skill |
|---|
| 创建知识库、初始化 | /skill:jfox-manage §3 |
| 搜索笔记、查找知识 | /skill:jfox-search |
| 导入仓库、git log、PR、Issues | /skill:jfox-ingest |
| 整理知识库、提炼笔记、清理 inbox | /skill:jfox-organize |
| 保存会话、总结到知识库 | /skill:jfox-session-summary |
| 会话提炼永久笔记、session to permanent | /skill:jfox-session-to-permanent |
| 健康检查、知识库体检 | /skill:jfox-manage §5 |
通用约定
- 所有
jfox 命令都支持 --kb <name> 指定目标知识库；省略时使用当前默认知识库
- 大部分命令支持
--format json 或 --json 输出 JSON，方便解析
- 长内容或含特殊字符时，使用
--content-file <path> 从文件读取；--content-file - 表示从 stdin 读取
jfox show <id_or_title> 默认输出原始 Markdown，--json 输出结构化字段（content/content_body/tags/links/backlinks 等）
常用命令速查
jfox init --name <name> --desc "<描述>"
jfox kb list --json
jfox kb switch <name>
jfox status --json
jfox add "内容" --title "标题" --type permanent --tag <tag>
jfox add --content-file <path> --title "标题"
jfox edit <id> --content "新内容" --title "新标题"
jfox delete <id> --force
jfox show <id_or_title>
jfox list --json --limit 50
jfox search "<query>" --mode hybrid --json
jfox query "<topic>" --depth 2 --json
jfox suggest-links "<内容>" --json
jfox refs --search "<标题>" --json
jfox graph --stats --json
jfox graph --orphans --json
jfox ingest-log <repo-path> --limit 50 --type fleeting
jfox inbox --json --limit 50
jfox index verify
jfox index rebuild
jfox daemon start
jfox daemon stop
jfox daemon status
跨 Skill 引用语法
在 Kimi Code 中，引用本插件的其他 skill 时使用：
/skill:jfox-manage
/skill:jfox-search
/skill:jfox-ingest
/skill:jfox-organize
/skill:jfox-session-summary
/skill:jfox-session-to-permanent
错误处理速查
| 错误 | 处理 |
|---|
jfox: command not found | uv tool install jfox-cli |
Knowledge base not found | 调用 /skill:jfox-manage 创建知识库 |
Knowledge base already exists | jfox kb switch <name> 或换名称 |
Index not found / 索引异常 | jfox index rebuild |
| 内容过长导致 shell 解析失败 | 改用 --content-file |
