Skills


Notedeep Skills

让 Codex 等 AI 正确读写 Notedeep 笔记和本地知识库，并在需要时通过 MCP 上传图片。

下载

请下载本页附件：

📎
notedeep.zip9.1 KB

解压后目录结构应为：
notedeep/
SKILL.md
agents/
openai.yaml
references/
markdown.md
workspace.md
mcp.md

安装

把 `notedeep/` 目录复制到你的项目：
.agents/skills/notedeep/

如果你希望所有项目都能使用，也可以复制到个人目录：
~/.agents/skills/notedeep/

使用

在 Codex 中可以直接提到：
$notedeep

例如：
使用 $notedeep 帮我把这份会议记录整理成 Notedeep Markdown。

也可以在项目 `AGENTS.md` 中加入：
当前目录是 Notedeep 知识库，里面的 Markdown 文件需要使用 Notedeep Markdown 格式。
读写 Notedeep 笔记、本地知识库文件或 Notedeep Markdown 时，优先使用 `notedeep` skill。

当前能力

  • 生成和编辑 Notedeep Markdown。
  • 理解 Notedeep 自定义 block：`table`、`mermaid`、`markmap`、`collapsible`、`info`、`video`、`attach`、`diagram`、`whiteboard`、`smart_table`。
  • 生成表格时优先使用 `:::table`，标准 Markdown pipe table 仅作为兼容输入。
  • 正确处理本地 workspace、目录页面 `_folder.md` 和 `.notedeep/manifest.json`。
  • 修改已有 `.md` 时保留无关内容，不改写同步状态。
  • 通过 Notedeep MCP 上传图片，并把返回的云端 URL 写入笔记。

Skill 与 MCP

Skill 负责告诉 AI 如何处理 Notedeep 内容；MCP 提供需要登录授权的在线能力。当前 MCP 仅支持图片上传，配置与限制见 Notedeep MCP。