关于 johnnydecimal
用于处理 Johnny.Decimal 文档和 JDex 笔记的技能。它引导用户从 `jd` MCP 服务获取权威说明,并介绍编号表示法与笔记约定。
主要功能
- 01指导查询文档页面
- 02解释 SYS.AC.ID 编号表示法
- 03说明保留的零编号规则
- 04介绍 JDex 笔记结构与元数据
适用场景
- 01查阅 Johnny.Decimal 约定
- 02创建或解读 JDex 条目
MCP 相关
该技能通过 `jd` MCP 服务获取 Johnny.Decimal 文档,并要求先调用 `list_documentation`,再使用相关 slug 调用 `get_documentation`。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ johnnydecimal/ skills --skill johnnydecimal安装后在 Claude Code 中输入/johnnydecimal确认已加载。
附带文件agents/openai.yaml
详细介绍
知识所在的位置
Johnny.Decimal 文档存放在 jd MCP 服务上,不在此文件中。此文件只包含两项内容:读懂数字所需的基本词汇,以及服务未发布的 JDex 笔记约定。
不要凭记忆回答有关 Johnny.Decimal 工作方式的问题。调用一次 list_documentation 查看所有页面,然后使用所需的 slug 调用 get_documentation。这些页面涵盖区域和类别、ID、标题、AC.ID 表示法、标准零值、JDex、文件命名、子文件夹模式、收件箱和归档、多套系统,以及扩展末尾。
如果服务未连接,只需说明一次,然后根据以下内容作答,并将超出这些内容的部分标记为不确定。
读懂一个数字
SYS.AC.ID,例如D25.11.11。SYS是系统标识符,通常省略。AC是区域-类别组合。11是一个类别,位于一个区域中;区域范围为十个数字,即10-19。ID是小数点后的两位数字。11.11是一个 ID。内容存放在 ID 中。- 抽象来说,
AC.ID表示任意 ID,11.ID表示类别11中的任意 ID,1C.ID表示区域10-19中的任意 ID,而A0表示以0结尾的任意类别。
以零结尾的数字保留用于系统管理。00-09、A0 以及 AC.00 到 AC.09 都不是文件归档目标。这就是 ID 从 11.11 开始的原因。
ID 可以用 + 扩展,例如 12.34+ Child's health。将其理解为 12.34 的子项,或理解为在整个系统中重复出现的条目。
JDex
JDex 是索引:每个 ID 对应一条笔记,也是系统中所有 ID 的主记录。它通常是一个 Obsidian 或 Bear 知识库。创建笔记即创建 ID。
笔记结构
这是用户自己的约定。服务未发布该约定。假设使用一种 Markdown 工具,其中笔记的 H1 来自文件名。
- 第一行可选的描述。以
>开头,后接一个空行。 - 元数据键值对。先写键和冒号,再在下方以缩进的项目符号列出值。
- 一个空行、一条 Markdown
---,再加一个空行。 - 用户的自由格式笔记。可在此处书写。
有些用户更喜欢使用规范的 YAML frontmatter 来记录元数据。遵循相邻笔记的做法。
标准元数据属性
Data:— 自由文本,说明此 ID 的数据存放在哪里。Related:— 指向其他笔记的 wiki 链接。从较小的数字链接到较大的数字,例如从11.11链接到99.99。JDex 软件会提供反向链接,因此切勿手动编写反向链接。URL:— 一个 URL。
条目示例
> A short description of what this ID represents.
- Data:
- Folder in Dropbox.
- Related:
- [[56.78 Another relevant ID]]
- URL:
- https://example.com
---
## My notes
- Freeform notes go here. This is the main body of the entry.
- Any format the user likes.
- Typically bullet points.