wpsnote/wpsnote-skills/note-copilot
Claude Code and agent skill by wpsnote/wpsnote-skills
- community
Checking that the SKILL.md file is still in the repository.
笔记协作助手:帮用户打磨当前 WPS 笔记,识别并处理笔记中的 *** 和 /// 援助标记,同时在发现明显逻辑错误时以着色方式提醒。当用户说「帮我打磨笔记」「打磨一下」「帮我看看笔记」「处理一下标记」「定期帮我打磨」,或提到笔记中有 *** 或 /// 需要处理时使用此 skill。
Install
npx vskill@latest install wpsnote/wpsnote-skills/note-copilotSKILL.md
笔记协作助手
陪伴用户打磨笔记的 AI 助手。扫描当前笔记,处理用户留下的 ***(补全)和 ///(引用)标记,并在发现明显逻辑错误时轻提醒。
核心工作流
首次使用引导
判断方式:本次对话中是否已经输出过引导说明。若未输出过,则在开始打磨前先输出:
Step 1:获取当前笔记
若返回 NO_ACTIVE_EDITOR_WINDOW:提示用户打开笔记后重试,停止执行。
Step 2:读取笔记内容
笔记较短(大纲 block 数 ≤ 80):
笔记较长(block 数 > 80):
Step 3:识别援助标记
扫描笔记内容,找出所有 *** 和 ///。
识别规则:是援助请求还是占位符/代码?
| 场景 | 判断 | 处理 | |
|---|---|---|---|
block type 为 codeblock | 不处理 | 跳过 | |
*** / /// 出现在 ` `` 包裹的行内代码中 | 不处理 | 跳过 | |
*** 紧邻正则、公式等逻辑性符号(如 \d***、a***b) | 不处理 | 跳过 | |
/// 紧邻 URL 或路径(如 http:///、path///file) | 不处理 | 跳过 | |
普通段落 <p>、标题 <h1>~<h6>、列表项中的独立 *** 或 /// | 援助请求 | 处理 | |
<blockquote> 中的 *** 或 /// | 援助请求 | 处理 |
原则:优先保守判断。若不确定,跳过并在摘要中告知用户。
Step 4:处理 *** — 补全内容
获取上下文
分析文风
分析前后文的以下维度,生成时严格匹配:
| 维度 | 观察点 | |
|---|---|---|
| 语气 | 口语(「感觉」「其实」)vs 书面(「经分析」「综上」) | |
| 人称 | 第一人称 vs 客观陈述 | |
| 详略 | 每条字数,是否展开说明 | |
| 格式 | 所在 block 的 type(p/h/li),是否有加粗/斜体 | |
| 标点习惯 | 惯用标点,中英混写程度 |
生成补全
- 严格基于笔记上下文生成,不凭空发明信息
- 保持所在 block 的原始 type 和格式属性不变
- 不引入新的排版元素(不新增标题、色块、表格)
- 补全内容替换
***本身,其余文字保持不变
写回
注意:每次 edit_block 后 block_id 会变化,后续操作需重新 get_note_outline 或 search_note_content 获取新 ID。
Step 5:处理 /// — 引用外部内容
提取关键词
读取 /// 所在 block 及前后 5 个 block,分析:
///前的主题词/问题- 整体笔记的主题(来自标题和已有内容)
判断搜索范围(AI 自由决策)
优先搜索 WPS 笔记,必要时联网补充:
搜索笔记:
联网搜索(笔记中无相关内容,或需要补充外部资料时):
生成引用内容
引用格式(贴合前后文,不引入新视觉层级):
若搜索无结果:
写回
注意:batch_edit 执行顺序固定为 delete → insert,无需担心顺序问题。若 /// 是笔记第一个 block,用后面 block 作为 anchor,position 设为 "before"。
Step 6:逻辑标注(高阈值)
整理完标记后,通读笔记内容,仅在以下情况才标注:
触发标准(必须满足其一):
- 同一笔记中两处内容直接矛盾(如「A 导致 B」和「B 导致 A」)
- 数字/数据明显自相矛盾(如前文「共 5 项」,后文列了 7 项)
- 因果关系明显颠倒
不触发:
- 内容不够完整(让用户用
***补) - 表达不够清晰但没有逻辑错误
- 观点有争议但非错误
- 任何「可以更好」的建议
标注方式:在问题 block 之后插入一行提醒:
幂等检查:在插入前,先 search_note_content(note_id, query="⚠") 确认该处是否已有标注,避免重复。
Step 7:输出处理摘要
若无任何标记且无逻辑问题:
定期模式下追加:
幂等与防重原则
- 处理完的标记必须删除:
***通过 replace 替换,///通过 delete + insert 替换,原标记不保留 - 未处理的标记不动:本轮跳过的标记(代码块中等),保持原样,不添加任何内容
- 逻辑标注不重复:插入前先检查是否已标注
- 定期模式有上下文时不重复提示:同一处已处理内容,本对话内不再重复说明
定期模式
仅当用户明确说「定期帮我打磨」「每 5 分钟帮我打磨」时启动:
错误处理
| 错误 | 处理方式 | |
|---|---|---|
NO_ACTIVE_EDITOR_WINDOW | 提示用户打开笔记后重试,停止执行 | |
BLOCK_NOT_FOUND | 重新 get_note_outline 刷新 ID 后重试一次 | |
EDITOR_NOT_READY | 等待 2 秒后重试写入 | |
DOCUMENT_READ_ONLY | 告知用户笔记为只读,停止处理 | |
搜索(///)无结果 | 在该处插入灰色提示「未找到相关内容,请手动填写」 | |
read_note 内容被截断(truncated: true) | 改用 get_note_outline + search_note_content 定位标记,再 read_blocks 读取上下文 |
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/note-copilot/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/wpsnote/wpsnote-skills/note-copilot)