mcpField
J
johnnydecimal

johnnydecimal

github.com/johnnydecimal生产力16100 次安装4 天前更新
代码仓库

关于 johnnydecimal

用于处理 Johnny.Decimal 文档和 JDex 笔记的技能。它引导用户从 `jd` MCP 服务获取权威说明,并介绍编号表示法与笔记约定。

主要功能

  1. 01指导查询文档页面
  2. 02解释 SYS.AC.ID 编号表示法
  3. 03说明保留的零编号规则
  4. 04介绍 JDex 笔记结构与元数据

适用场景

  1. 01查阅 Johnny.Decimal 约定
  2. 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 来自文件名。

  1. 第一行可选的描述。以 > 开头,后接一个空行。
  2. 元数据键值对。先写键和冒号,再在下方以缩进的项目符号列出值。
  3. 一个空行、一条 Markdown ---,再加一个空行。
  4. 用户的自由格式笔记。可在此处书写。

有些用户更喜欢使用规范的 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.

评论

支持 Markdown