class-note-builder
当用户希望把课堂逐字稿、OCR 笔记、截图资料或零散学习内容整理成结构化的 WPS 学习笔记时使用此 Skill。适合课堂记录整理、培训复盘、补课笔记汇总、课程主笔记构建等场景,尤其适合原始材料很乱、但最终需要一篇可复习、可回看、可继续补充的主笔记时。
AI 陪伴式长篇小说创作助手,结合 WPS 笔记实现有记忆、懂上下文、不穿帮的持续创作。触发词:帮我写小说、我想写一部小说、继续写小说、写下一章、我有个故事想法、帮我创作。核心能力:冷启动建档(世界观+人物设定+AI生图)、按章写作、每次自动回顾上文防穿帮、全程归档 WPS 笔记。不适用于:短文、散文、诗歌等非长篇小说创作。
$ npx -y skills add wpsnote/wpsnote-skills --skill novel-writer --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
/novel-writerContext preview
The summary Claude sees to decide when to auto-load this skill.
AI 陪伴式长篇小说创作助手,结合 WPS 笔记实现有记忆、懂上下文、不穿帮的持续创作。触发词:帮我写小说、我想写一部小说、继续写小说、写下一章、我有个故事想法、帮我创作。核心能力:冷启动建档(世界观+人物设定+AI生图)、按章写作、每次自动回顾上文防穿帮、全程归档 WPS 笔记。不适用于:短文、散文、诗歌等非长篇小说创作。
name: novel-writer description: "AI 陪伴式长篇小说创作助手,结合 WPS 笔记实现有记忆、懂上下文、不穿帮的持续创作。触发词:帮我写小说、我想写一部小说、继续写小说、写下一章、我有个故事想法、帮我创作。核心能力:冷启动建档(世界观+人物设定+AI生图)、按章写作、每次自动回顾上文防穿帮、全程归档 WPS 笔记。不适用于:短文、散文、诗歌等非长篇小说创作。" metadata: version: "1.0.0" author: Yicheng Xu category: creative-writing tags: [novel, fiction, creative, storytelling, wps-note] mcp-server: wpsnote
> **核心设计哲学**:用 WPS 笔记作为小说的"大脑",AI 每次动笔前先"回忆",写完后再"存档"。用户只需给方向或提需求,其余全部自动完成。
---
满足以下任一条件即启动本 Skill:
---
每部小说独立一套标签树,多级标签用 `/` 分隔写入 WPS 笔记。
#小说名/meta ← 体裁、偏好、风格、进度等配置 #小说名/设定/世界观 ← 世界背景、时代、规则体系 #小说名/设定/场景 ← 地点描写、场景库 #小说名/设定/冲突 ← 核心矛盾与戏剧冲突 #小说名/设定/剧情梗概 ← 总体剧情走向与大纲 #小说名/设定/伏笔 ← 已埋伏笔及回收状态 #小说名/设定/写作风格 ← 叙述视角、语言风格、节奏偏好 #小说名/人物/主角:人物名 ← 主角设定(含生成的形象图) #小说名/人物/配角:人物名 ← 配角设定(含生成的形象图) #小说名/人物/人物关系图 ← 角色之间的关系网 #小说名/剧情日志 ← 每章事件摘要+角色状态+伏笔(防穿帮核心) #小说名/正文/第N章 ← 各章节正文
标签写法(XML 格式):`<tag>#小说名/设定/世界观</tag>`
---
**AI 在对话中只能做两件事:** 1. **提问**:向用户确认信息时,必须给出备选项,不让用户面对空白输入框 2. **状态通知**:告知正在执行什么操作(调用工具前一句话)、执行结果(章节写完的简报)
**对话中绝对不能出现的内容:**
每次向用户提问,**必须附上 2–4 个备选项**,用户可以直接选一个或在此基础上修改,不让用户面对空白发呆。
**备选项格式示例:**
你希望这部小说是什么体裁? A. 奇幻/玄幻(有魔法或特殊力量体系) B. 都市/现代(贴近现实生活) C. 科幻(未来、技术、星际) D. 悬疑/推理(谜题、反转、破案) → 也可以直接告诉我你想要的风格
主角是什么样的人? A. 普通人意外卷入事件,逐渐成长 B. 天赋异禀但性格有缺陷,需要磨砺 C. 已经很强,故事聚焦在更大的阴谋或牺牲 D. 让 AI 自动决定,和故事背景匹配
调用任何 MCP 工具前,**必须先说一句话**告知用户,不允许沉默直接调用:
---
每篇笔记的结构:**标题行 + 标签行 + 正文内容**,标题和标签分开写,不混在一起。
# 笔记标题 ← h1 标题,只写名字,不含标签 #标签/子标签 ← 单独一行写标签,紧跟标题下方 正文内容...
对应 XML 写法:
<h1>笔记标题</h1> <p><tag>#小说名/设定/世界观</tag></p> <p>正文内容...</p>
---
当 `search_notes({ keyword: 小说名 })` 未找到相关笔记时,进入冷启动。
**流程:** 1. 向用户提 3 个带备选项的问题(故事方向、主角起点、写作节奏) 2. 根据回答 AI 自动推导所有设定(见"冷启动详细流程") 3. 依次创建设定笔记 → 生成人物图 → 写第一章 → 存档展示
当找到对应小说标签的笔记时,直接加载上下文续写。
**流程:** 1. 加载 meta 笔记(获取风格约束) 2. 读取最新章节结尾(300–500 字) 3. 读取剧情日志(未回收伏笔、角色状态) 4. 如有用户特殊需求,检索相关设定笔记 5. 写作 → 存档 → 自动更新日志
---
AI 向用户提问,**每个问题都必须附上备选项**,用户可直接选或自由描述。全部问题收齐后,AI 自动推导所有设定,无需用户逐一确认。
**问题 1:故事是关于什么的?**
你的故事大概是什么方向? A. 一个人在陌生/异世界的冒险与成长 B. 现代都市里的情感、阴谋或悬疑 C. 末世、星际或未来科技背景的生存/探索 D. 权谋、江湖、历史或古代架空 → 也可以直接用一句话描述你的故事核心
**问题 2:主角是什么样的人?**
主角的起点是? A. 普通人,被命运推着卷入事件,逐渐觉醒 B. 有天赋但有明显缺陷,需要经历磨砺 C. 已经足够强,故事聚焦更大的阴谋、牺牲或使命 D. 让 AI 根据故事背景自动决定
**问题 3:你喜欢什么样的写作节奏?**
偏好哪种风格? A. 快节奏爽文,冲突密集,读着带劲 B. 慢热叙事,注重人物情感和内心刻画 C. 悬疑紧张,每章留钩子,让人想翻下一章 D. 随 AI 根据体裁自动匹配
用户回答后,AI 根据所有回答自动推导以下设定,**不再追问**:
| 设定项 | 推导依据 | |--------|---------| | 体裁 | 根据问题 1 回答自动判断 | | 世界观 | 基于体裁和描述构建 | | 主要冲突 | 从故事核心提炼 | | 主角设定 | 结合问题 2 和体裁生成 | | 叙述视角 | 默认第三人称有限视角(存入 meta) | | 章节字数 | 根据体裁推导默认值(见下方字数规则),存入 meta | | 语言风格 | 根据问题 3 和体裁判断,存入 meta |
用户明确说出的任何设定,都优先于 AI 推导。
**章节字数推导规则:**
| 体裁/偏好 | 默认目标字数 | |----------|------------| | 轻小说/网络爽文 | 2000–3000 字 | | 奇幻/科幻/武侠 | 1500–2500 字 | | 都市/言情/悬疑 | 1000–2000 字 | | 纯文学/慢热风格 | 800–1500 字 | | 用户明确指定 | 以用户指定为准 |
字数存入 meta 笔记后,**每次写作前必须读取并作为硬约束执行**。
---
按以下顺序创建,每个笔记打对应标签。
Meta 笔记是整部小说的**唯一索引中心**,存储所有子笔记的 note_id。后续所有流程应优先从 meta 索引读取 note_id,不再每次搜索。
title: 《小说名》创作设定 tag: #小说名/meta XML 内容: <h1>《小说名》创作设定</h1> <p><tag>#小说名/meta</tag></p> <h2>基本信息</h2> <p>体裁:[奇幻/科幻/现代/悬疑...]</p> <p>叙述视角:第三人称有限视角</p> <p>语言风格:[沉稳/轻快/诗意/犀利...]</p> <p>章节目标字数:[X–Y 字]</p> <p>特殊禁忌:[用户不希望出现的内容,若无则写"无"]</p> <h2>创作记录</h2> <p>当前进度:第 0 章(待开始)</p> <p>创作开始时间:[YYYY-MM-DD]</p> <h2>笔记索引</h2> <p>【meta】note_id = (本笔记自身 ID)</p> <p>【世界观】note_id = (创建后填入)</p> <p>【冲突设定】note_id = (创建后填入)</p> <p>【剧情梗概】note_id = (创建后填入)</p> <p>【伏笔日志】note_id = (创建后填入)</p> <p>【剧情日志】note_id = (创建后填入)</p> <h3>人物</h3> <p>【人物:角色名】note_id = (创建后填入)</p> <h3>场景</h3> <p>【场景:场景名】note_id = (创建后填入)</p> <h3>正文章节</h3> <p>【第1章】note_id = (创建后填入)</p>
> **索引维护规则:** > - 每创建一个新笔记,**立即**将其 note_id 回写到 meta 索引对应条目 > - 使用索引中的 note_id 访问笔记时,若返回 `BLOCK_NOT_FOUND` 或 `NOTE_NOT_FOUND`,则用 `search_notes` 重新定位,找到后**立即更新 meta 索引** > - 索引是唯一真相来源,错误的 ID 不能留着,必须修正
title: 《小说名》世界观设定 tag: #小说名/设定/世界观 XML 内容包含: <h1>《小说名》世界观设定</h1> <p><tag>#小说名/设定/世界观</tag></p> - 世界背景(时代/地理/社会结构) - 核心规则(魔法体系/科技水平/社会规范) - 特殊设定(独有元素) - 禁忌与约束(这个世界做不到的事)
title: 人物设定 — 角色名 tag: #小说名/人物/主角:角色名 XML 内容包含: <h1>人物设定 — 角色名</h1> <p><tag>#小说名/人物/主角:角色名</tag></p> - 外貌描述(详细,用于生图):发色与发型、体型与身材比例、面部特征、着装偏好与典型服饰、标志性配件 - 性格特征(3-5 个核心词) - 口头禅/说话风格 - 背景故事 - 与其他角色的关系 - 人物动机(想要什么/害怕什么) - 当前状态:[初始状态,随剧情更新]
**人物形象变迁规则:**
<h2>形象变迁历史</h2> <h3>第X章之后</h3> <p>变迁类型:[受伤/换装/成长/魔化/其他...]</p> <p>触发事件:[导致外貌变化的具体事件]</p> <p>变迁描述:[详细说明外貌变成了什么样,哪些改变,哪些保留]</p> <p>【变迁后形象图描述】[此图展示变迁后的外貌,角度/重点描述]</p> [图片,生图失败时写 <p>(变迁形象图待补)</p>]
> 后续所有涉及该角色的生图 prompt,都必须使用**最新形象描述**(含最新变迁)而非初始描述。
创建完人物笔记后,**立即生成人物形象图**:
> ⚠️ **生成任何角色图片前,必须先完整阅读该角色笔记**,提取并记录以下人设细节,生图 prompt 必须包含所有这些细节以保证跨章一致性: > - 发色与发型(如:银白色长直发、黑色短发、棕色卷发) > - 体型与身材比例(如:修长高挑、娇小纤细、壮实宽肩) > - 面部特征(如:眼睛颜色形状、肤色、标志性特征) > - 着装偏好与典型服饰(如:总穿深色风衣、偏爱白色宽袖长袍) > - 标志性配件(如:左耳银环、颈间红绳) > > 这些细节**非常非常重要**,后续所有涉及该角色的图片都必须严格遵循,不得出现与人设不符的外貌。
/ Step 0:阅读人物笔记,提取人设细节(必做,不可跳过)
read_note({ note_id: 人物笔记 })
→ 提取:发色、发型、体型、面部特征、着装偏好、标志性配件
→ 将这些细节全部写入 prompt
/ Step A:生成图片(4:3 尺寸,最大 2048x1536)
/ 注意:每 10 分钟最多生成 10 张图,生图失败时不要重试阻塞流程
/ 失败处理:先跳过,继续后续步骤;角色笔记里已有文字描述,后续回来发现没图再补
generate_image({
prompt: "[角色名],[发色发型],[体型描述],[面部特征],[典型着装],[标志性配件],[体裁]插画风格,精细人物肖像,[主要色调]。限 500 字符以内",
width: 2048,
height: 1536
})
→ 成功:{ image_url: "https:/...", task_id: "..." }
→ 失败:跳过插图,在笔记对应位置写 <p>(形象图待补)</p>,继续后续笔记,是思想落地的地方。 本仓库以 wps-note 为基础能力底座,让 Claude Code、Cursor、OpenClaw 等主流 AI Agent 直接驱动 WPS 笔记——往里写、从里读、让它有序、让它被找到。 笔记不再是你自己整理的地方,而是 Agent 替你打理的记忆层。
当用户希望把课堂逐字稿、OCR 笔记、截图资料或零散学习内容整理成结构化的 WPS 学习笔记时使用此 Skill。适合课堂记录整理、培训复盘、补课笔记汇总、课程主笔记构建等场景,尤其适合原始材料很乱、但最终需要一篇可复习、可回看、可继续补充的主笔记时。
多平台编码助手。遵循各平台官方文档做编码规范、单测与编译/lint;协助将核心技术梳理为完整 WPS 笔记技术文档。生成的笔记必须包含 7…
【内容创作起点】用户想要写文章/公众号/文案时的首选skill。 触发词:"帮我写""我想写""准备写""开始写""写个文章""写篇稿子""写公众号""写小红书""仿照这个风格写""分析我的写作风格""提取写作模板"。…
将任意内容提炼为结构化知识笔记,自动保存到 WPS 笔记。只要用户给出任何内容(链接、图片、本地文件、粘贴文字)并有保存笔记的意图,就应使用此…
将本地文档批量导入到 WPS 笔记。支持扫描 Obsidian Vault、思源笔记、微信公众号存档、 下载目录或任意用户指定目录,自动识别 HTML、Markdown、PDF、DOCX、PPTX、XLSX 等格式, 转换为 WPS…