WPS 笔记 Skills

笔记，是思想落地的地方。

本仓库以 wps-note 为基础能力底座，让 Claude Code、Cursor、OpenClaw 等主流 AI Agent 直接驱动 WPS 笔记——往里写、从里读、让它有序、让它被找到。

笔记不再是你自己整理的地方，而是 Agent 替你打理的记忆层。

关于本仓库

本仓库包含 WPS 笔记场景下的完整 Skill 生态，覆盖笔记处理、内容创作、搜索阅读、信息捕获、灵感引擎、学习、长篇创作等场景。每个 Skill 独立在自己的文件夹中，包含一个 SKILL.md 定义文件。浏览这些 Skill 可以获取灵感，或了解不同的设计模式与实现方法。

Skill 分类

• ./skills: 全部 Skill，按功能分组如下
• ./comm_script: 公共脚本（跨 Skill 复用）

核心能力

Skill	说明
wps-note	基础能力层，通过 MCP / CLI 读取、编辑、搜索和管理 WPS 笔记，是所有场景 Skill 的依赖基础
wpsnote-beautifier	智能美化笔记，优化标题层级、用高亮块强调结论、用分栏展示对比内容，全文统一一种配色
note-copilot	笔记协作打磨，识别并处理 *** 和 /// 援助标记，发现逻辑错误时以着色提醒
tag-organize	清理混乱标签、重构标签体系、优化分类结构（MCP 版）
tag-organize-cli	与 tag-organize 功能相同，通过 CLI 驱动
skill-creator	Skill 创建、迭代与评估工具

内容创作

Skill	说明
content-creator	完整创作工作流：风格画像 → 需求确认 → 大纲 → 深度研究 → 文章 → 定稿
wechat-publisher	将笔记排版导出为微信公众号 HTML，支持多种模板风格
short-video-copywriter	将原稿改写为短视频口播文案，支持分镜脚本与 AI 配图
xiaohongshu-note-creator	将笔记 / 文章转化为小红书图文方案，含每页文案、AI 配图和话题标签
image-gen	AI 图像生成（文生图 + 图生图），对接 OpenRouter / 百炼 / 火山方舟 / Gemini

搜索与阅读

Skill	说明
content-digest	万能内容提炼：URL / 图片 / PDF / 粘贴文本 → 结构化知识笔记，支持多篇合并与图片视觉解读
news-to-note	新闻智能解读，搜索笔记库找关联内容，产出个性化 insight，也支持批量新闻简报
wps-note-intelligent-search	深度搜索，跨笔记关联挖掘与知识图谱构建
literature-reader	学术文献阅读与结构化概要，支持元信息提取、方法论梳理、多篇横向对比
paper-researcher	论文全流程：搜索（arXiv / OpenAlex）→ 下载 PDF → 精读分析 → 存入笔记

信息捕获

Skill	说明
live-transcript-summary	实时音频转写监听与自动总结，适用于会议、听课、播客、采访
doc-importer	批量导入本地文档（Obsidian / 思源 / PDF / Word 等）到 WPS 笔记
web-importer	网页无损导入：公众号 / 推文 / 通用网页 → WPS 笔记，保留格式与图片
coding-assistant	多平台编码助手，自动将核心技术梳理为标准化技术文档
note-calendar	WPS 笔记与 macOS 系统日历双向联动

灵感引擎

串联记忆检索、想法连接和洞见生成的完整流水线，按层拆分、可独立调用也可组合。

Skill	说明
ie-engine	统一入口，运行完整灵感生成流水线
ie-retrieve-memory	记忆层：从历史笔记中检索相关知识
ie-connect-dots	推理层：语义聚类、发现隐含关联与主题模式
ie-generate-insight	洞见层：将分析结果转化为可阅读的启发性内容
ie-recall-memory	选择性召回：当前最该想起哪些旧笔记

学习场景

覆盖从课堂记录到复习巩固的完整学习工作流。

Skill	说明
class-note-builder	把课堂逐字稿、OCR 笔记、零散材料整理成结构化主笔记
lecture-focus-extractor	从长篇笔记 / 转写中提取最值得复习的重点
misconception-finder	检查笔记中的理解错误、概念混淆或逻辑跳步
note-review-coach	基于已有笔记生成不提前泄题的自测题，作答后按原文证据批改并给出错因反馈与复习建议
notes-to-flashcards	将笔记转为可主动回忆的复习卡片
notes-to-lesson-plan	将笔记整理为可讲给别人听的 teach-back 提纲
prerequisite-gap-finder	找出学习卡点与缺失的前置知识
study-note-linker	将新笔记与旧笔记关联，构建知识网络

长篇创作

Skill	说明
novel-writer	AI 陪伴式长篇小说创作，有记忆、懂上下文、不穿帮（MCP 版）
novel-writer-cli	与 novel-writer 功能相同，通过 CLI 驱动

在 Claude Code、Cursor 和 MCP 中使用

Claude Code

在 Claude Code 中注册本仓库为插件市场：

/plugin marketplace add wpsnote/wpsnote-skills

然后安装需要的 Skill 组：

1. 选择 Browse and install plugins
2. 选择 wpsnote-skills
3. 选择 core-skills、content-skills、capture-skills、creative-skills 或 learning-skills
4. 点击 Install now

或直接安装：

/plugin install core-skills@wpsnote-skills
/plugin install content-skills@wpsnote-skills
/plugin install capture-skills@wpsnote-skills
/plugin install creative-skills@wpsnote-skills
/plugin install learning-skills@wpsnote-skills

CLI（推荐）

适合 Claude Code / Cursor / OpenClaw 等终端型 Agent。wpsnote-cli <command> 即可操作笔记，20+ 命令覆盖全部能力。

# 安装：在 WPS 笔记桌面端 MCP 设置页点击安装 CLI
wpsnote-cli status          # 检查连接
wpsnote-cli list            # 列出笔记
wpsnote-cli read --help     # 查看某命令用法

详细命令参考：CLI_REFERENCE.md

MCP Server

适合 Cherry Studio 等图形化 Agent，或需要工具调用协议的场景。图形化配置，开箱即用，20+ 工具与 CLI 命令一一对应。

---

两种方式底层能力完全一致，Agent 是操作者，笔记是落点。

创建 Skill

使用 下面的的模板快速开始：

---
name: my-skill-name
description: 一句话描述这个 Skill 做什么，以及何时触发它
---

# Skill 名称

[在此编写 Agent 执行时遵循的指令]

## 示例
- 使用场景 1
- 使用场景 2

## 规则
- 规则 1
- 规则 2

frontmatter 必需字段：

• name — Skill 唯一标识（小写，用连字符分隔）
• description — 完整描述 Skill 功能与触发时机（这是 Agent 判断何时使用的唯一依据，务必写清触发边界）

创建新 Skill 的完整指南，请参考 skill-creator 与 claude-skills-complete-guide.md。

Outcome-Only E2E 评测

仓库内置了一套 repo 级的 outcome-only 三态评测骨架，位置在 ./evals。

这套评测只看结果，不看工具调度链、不看 trace。每个 case 固定围绕三种状态：

• original_state：执行前的真实基线
• expected_state：期望达到的目标状态
• final_state：执行后的真实观测状态

首版覆盖 4 个重点 skill：

• doc-importer
• tag-organize
• web-importer
• wps-deep-search

快速使用：

# 校验全部 case schema
python3 evals/scripts/tri_state_eval.py validate evals/cases

# 用原始快照和最终快照对单个 case 判分
python3 evals/scripts/tri_state_eval.py grade \
  --case evals/cases/golden/doc-importer/create-rich-import.json \
  --original evals/fixtures/doc-importer/create-rich-import.original.json \
  --final evals/fixtures/doc-importer/create-rich-import.final.json

自动化测试：

python3 -m unittest evals.tests.test_tri_state_eval

完整说明、schema、state guide 和示例 fixture 见 ./evals/README.md。

命令速查

核心操作模式：先定位（outline / search）→ 再读取（read）→ 最后编辑（edit）

所有内容以语义 XML 格式交换，所有定位基于 block_id（10 位字母数字）。

分类	CLI 命令	MCP 工具	说明
读取	wpsnote-cli outline	get_note_outline	获取结构大纲与 block_id，超大文档自动分页
读取	wpsnote-cli read	read_note	读取笔记全文 XML
读取	wpsnote-cli section	read_section	按标题读取章节，支持 block_offset 续读
读取	wpsnote-cli read-blocks	read_blocks	按 ID 批量读取 block
读取	wpsnote-cli search	search_note_content	笔记内搜索，编辑前精确定位
读取	wpsnote-cli xml-ref	get_xml_reference	获取 XML 标签与写入示例
写入	wpsnote-cli edit	edit_block	单个编辑操作
写入	wpsnote-cli batch-edit	batch_edit	多个操作原子事务
写入	wpsnote-cli insert-image	insert_image	插入图片
写入	wpsnote-cli gen-image	generate_image	AI 文生图
管理	wpsnote-cli find	search_notes	搜索笔记
管理	wpsnote-cli list	list_notes	列出笔记
管理	wpsnote-cli create	create_note	创建空白笔记
管理	wpsnote-cli info	get_note_info	获取笔记元数据
管理	wpsnote-cli tags	find_tags	列出全部标签或按关键词搜索标签
管理	wpsnote-cli find --json-args '{"tags":["标签名"]}'	search_notes({ tags: ["标签名"] })	查看某个标签下的笔记
管理	wpsnote-cli manage-tags	manage_note_tags	管理笔记文件级标签（添加/移除/查询）
管理	wpsnote-cli import-web	import_web_page	导入支持域名的网页内容
管理	wpsnote-cli delete	delete_note	删除笔记（不可恢复，需确认）

社区与贡献

写了一段绝佳的 Skill，只留给自己用岂不是太可惜了。加入 WPS笔记 AI Skill 共创社区，让你的本地 Skill 直接跃入无数人的业务工作流。

贡献步骤

1. 用 skill-creator 创作：告诉 Agent 你想创建什么 Skill，它会调用 skill-creator 帮你走完完整流程
2. 在 SKILL.md 中注明作者：

   ---
   name: your-skill-name
   description: 一句话描述这个 Skill 做什么，以及何时触发它
   author: 你的名字 <your-github-username>
   version: 1.0.0
   ---

3. 检查冲突：确认触发描述不与已有 Skill 重叠，底层能力复用 wps-note
4. 提交 PR：在 skills/ 目录下新建子文件夹，确保包含完整的 SKILL.md

方式二：有想法但没时间写代码？直接开一个 Issue 抛出你的脑洞。

_{微信扫码加入交流群}

贡献者

每一个 Skill，都是有人把自己摸索出来的工作方式，提炼成了别人也能用的技巧。

---

所有内容，都值得等到被用到的那天。