资料核对日期:2026年11月16日。适用平台:OpenClaw。本文未做本地安装实测;当前稳定版本是否完整支持下述流程:待确认。发布或操作前,请对照当前版本的官方文档复核。
要完成的任务
创建一个名为 reading-note-splitter 的工作区 Skill,让它只依据用户提供的阅读材料,分别输出结论、依据和疑问。Skill 是带有 YAML frontmatter 和 Markdown 指令正文的 SKILL.md 文件,不要将它当作插件;插件应使用独立的插件管理方式。
本例需要的输入是一段原文。原文可以包含作者主张、支撑材料以及尚未说明的问题。若用户没有提供原文,Skill 应请求补充输入;若原文不足以形成某一部分,则填写“待确认”,不能自行补充事实。
创建阅读笔记 Skill
在当前 agent 的 OpenClaw 工作区中,进入 skills/ 目录,新建 reading-note-splitter 文件夹,并在其中创建 SKILL.md。name 只使用小写字母、数字和连字符;目录名应与 name 保持一致。description 必须是单行说明,并少于 160 个字符。
将以下内容写入 SKILL.md:
---
name: reading-note-splitter
description: 将阅读材料整理为结论、依据和疑问三部分。
---
# 阅读笔记整理
仅依据用户提供的阅读材料进行整理。
## 结论
概括原文明确表达或能够直接支持的核心结论。无法判断时写“待确认”。
## 依据
列出原文用于支持结论的事实、数据、例子或推理。原文未提供时写“待确认”。
## 疑问
列出原文尚未解释、证据不足或需要继续核对的问题。没有足够信息时写“待确认”。
不要添加原文中不存在的事实。未收到阅读材料时,请用户先补充原文。
保存后检查 OpenClaw 是否发现该 Skill:
openclaw skills list
如果仍在使用创建 Skill 之前已经开始的会话,可在聊天中启动新会话:
/new
也可以重启 Gateway:
openclaw gateway restart
调用并检查输出
在聊天中提供原文并直接提出整理要求;需要按名称显式调用时,使用 /skill reading-note-splitter。例如输入:“项目报告称方案 A 缩短了审核时间。试点组平均用时由 4 天降至 2 天,但报告没有说明样本量。”
预期输出应保持三个独立部分:
## 结论
方案 A 缩短了审核时间。
## 依据
试点组平均用时由 4 天降至 2 天。
## 疑问
试点样本量是多少?
验收时先确认名称出现在技能清单中,再检查回答是否严格分区、是否仅使用输入内容,以及材料不足时是否输出“待确认”。技能被列出只说明它进入了 inventory;是否满足前置条件以及是否对当前 agent 可见,还要分别核对 readiness 和 visibility。
缺失输入与失败检查
未提供原文时,预期结果是请求用户补充阅读材料,而不是生成结论。只提供结论而没有依据时,“依据”应为“待确认”;无法从原文提出明确疑问时,“疑问”也应为“待确认”。
若清单中找不到该 Skill,检查文件名是否为 SKILL.md、frontmatter 是否包含 name 和 description,以及目录名是否与 name 一致。刚修改文件但旧会话没有刷新时,启动新会话或重启 Gateway。若技能已被发现却无法使用,可运行 openclaw skills check,区分它是仅存在于 inventory、缺少 readiness 条件,还是没有对目标 agent 暴露。不要把“已列出”直接视为“能够运行”。