Skill
jsmind skill 位于本仓库的 skills/jsmind/。它是一套禁令和检查清单,用来指导 agent 通过 jsmind CLI 生成或修改思维导图。
它不是 CLI 手册,也不能代替 jsmind --help 或 CLI 页面。当 agent 需要生成或修改思维导图时,请让它按这份 skill 的检查点做;具体的命令和参数,请查阅 CLI 帮助或本站的 CLI 页面。
技能目录也随本站发布,不克隆仓库也能读:skills/jsmind/SKILL.md 与仓库里的那份是同一个文件,skills/jsmind/ 的其余内容就在它旁边。
安装
以下两种方式任选其一,不是先后步骤。
自动安装
你可以把下面的 prompt 直接交给自己的 agent。
请从 https://hizzgdev.github.io/jsmind-v2/skills/jsmind/INSTALL.md 安装 jsMind skill:读这份文件并照做。手动安装
把 skill 交给 agent 即可。例如:
- 如果正在本仓库的克隆里工作,告诉 agent:生成或修改思维导图时按
skills/jsmind/SKILL.md里的检查点做。 - 如果在别处工作,把整个
skills/jsmind/目录复制到 agent 会加载 skill 的位置,保留jsmind/这一层。
两个文件各管什么
INSTALL.md 面向安装者,就是上面的安装流程。SKILL.md 是 agent 生成或修改导图时读的那份。两者在同一目录,但没有任何 harness 会注入 INSTALL.md——所谓“装上 skill”,是 harness 读 SKILL.md,到此为止。改 INSTALL.md、把它翻成别的语言,都不影响运行期。
使用
Skill 规定了哪些事不能做、哪些步骤不能跳过,以及该如何检查导出的图片。导图的结构仍由使用者(或 agent)自己决定。
skill 只有英文版一份。它是给 agent 读的、不是给人读的,导图的文字语言由你的 prompt 决定,再存一份中文译文只会和这一份越走越远。
你可以把下面的 prompt 直接交给自己的 agent。
示例:生成一张导图并导出 PNG
请使用 jsMind skill,围绕「太阳系」生成一张思维导图,导出为 PNG。
- 如果本会话已经加载过 jsMind skill,不要重复加载,直接用。
- 输出到当前工作目录,文件名按主题取(solar-system.json / solar-system.png)。不要用系统临时目录,也不要先问要不要移动。
- 如果同名文件已存在,换个名字,不要覆盖。
- 内容:太阳作为根节点,八大行星各一个一级分支,每个行星下至少两个二级分支。
- 完成的标准:两个文件都在;PNG 里层级分得清、左右不一边倒;完成后给出两个文件的绝对路径。它覆盖什么
以下是简要概括,不能代替 skill 原文:
- 输入。 一个 JSON 路径和对应的 PNG 路径,再加上意图:新建用
BUILD,修改已有导图用CHANGE。 - 禁令。 不要手写 JSON 文件;不要绕过
jsmindCLI;validate不通过就必须停,不要继续改、也不要导出。 - 检查点(按顺序)。 改动前先运行
context并读懂其中的 id;一轮修改之后运行validate,再检查一次树结构;结构完成后export出图并查看。
完整的检查清单和示例见下面的 skill 文件。命令和参数请使用 jsmind --help,或查阅 CLI 页面。
在哪里找到它
master 上的文件。每一个都给两次:先 GitHub,再同一路径的 Gitee 镜像。
| GitHub | Gitee 镜像 | |
|---|---|---|
| 目录 | skills/jsmind/ | skills/jsmind/ |
| Skill 文件 | SKILL.md | SKILL.md |
| 安装说明 | INSTALL.md | INSTALL.md |
两条目录链接是给浏览器翻看用的。四条文件链接都是 raw,交给 agent 的就是这个形式:tree 或 blob 页面返回的是 HTML,照它复制,拿到的是一张网页而不是 skill 文件。
本站也在自己的根目录下发布同一份目录,所以 skills/jsmind/SKILL.md 不依赖上面任何一个仓库。
在本地克隆中,同样的文件位于 skills/jsmind/SKILL.md 和 skills/jsmind/INSTALL.md。