用途:这是 openclaw-superpowers 的元技能,用于把新技能引入仓库。任何贡献者要新增技能时按此流程操作。主要能力与流程如下。
定义技能:先回答若干问题——技能做什么(一句话)、代理何时使用(触发条件)、属于核心(core,通用代理方法论,任意运行时可用)还是 OpenClaw 原生(openclaw-native,依赖持久化、长时会话或记忆);是否已有技能覆盖、若有一律扩展而非新建;是否需要跨会话或唤醒间保持状态,若需要则设 stateful: true 并附 STATE_SCHEMA.yaml。
命名:使用 kebab-case,描述动作而非类别(如 retry-with-backoff 而非 error-handling-utils),保持简短,最多 2-4 个词。
脚手架:建立目录 skills/<core|openclaw-native>/<skill-name>/,含 SKILL.md,仅当 stateful: true 时再加 STATE_SCHEMA.yaml。SKILL.md 使用 frontmatter 模板,name 必填,description 必填,cron 与 stateful 为可选。完整内容结构参见 TEMPLATE.md。
内容撰写约定:直接,开篇即核心原则;命令式,逐步说明;简短,最佳技能不超过 50 行,过长则拆分;包含决策标准(何时用、何时不用);验证步骤用清单;跨会话工作加 checkpoint 指引;不要用散文描述状态,若涉及保存进度到 markdown 或记忆文件,应改用 stateful: true 与 STATE_SCHEMA.yaml。
验证(提交前):frontmatter 正确(name 与目录名一致,description 为一句话);文件路径正确;不与现有技能重叠,若重叠则合并或明确区分;遵循模板,含 When to Use、The Process、Key Principles 章节;不超过 80 行;可操作,每步都说明做什么;可测试,能通过输出判断代理是否正确执行;若 stateful: true,则 STATE_SCHEMA.yaml 含 version: 与 fields: 键;若设置 cron,须为合法的 5 字段 cron 表达式。
注册:无需手动注册,OpenClaw 从 extensions 目录自动发现。确保目录位于 skills/core/ 或 skills/openclaw-native/ 下,文件名恰为 SKILL.md,安装符号链接就位(由 install.sh 处理)。有状态技能由 install.sh 自动创建 ~/.openclaw/skill-state/<skill-name>/;带 cron 的技能在下次运行时注册到 OpenClaw 的 cron。
常见错误:过于抽象、过于宽泛、缺少触发条件、重复既有技能、用散文描述状态。检查已有技能(brainstorming、writing-plans、systematic-debugging、verification-before-completion)避免重复。具体命令与代码以原文为准,本资料未提供安装命令细节。