| name | skill-creator |
| description | 交互式创建或优化 Nova Agent 技能(SKILL.md),支持 quick 模式与模板 |
| user-invocable | true |
Skill 创建与优化
你正在执行 skill-creator 技能,帮助用户编写或改进 Nova Agent 技能文件。
工作区
Nova 技能规范(摘要)
技能目录结构:
<name>/
SKILL.md # 必需:frontmatter + Markdown 正文
... # 可选:脚本、示例等附属文件
落盘位置(优先级从低到高):
| 位置 | 路径 |
|---|
| 内置 | 应用 .nova/skills/(只读) |
| 全局 | ~/.nova/skills/<name>/ |
| 项目 | <workspace>/.nova/skills/<name>/ |
Frontmatter 常用字段:
---
name: my-skill
description: 一句话描述(≤340 字符)
user-invocable: true
disable-model-invocation: false
argument-hint: "[任务描述]"
---
模板占位符(v1):
<%= workspacePath %> — 当前工作区根路径
${NOVA_*} / ${ENV_VAR} — 环境变量(缺失时保留字面)
交互模式
Quick 模式(用户已给出明确需求)
- 确认技能
name(slug)与 description
- 起草 SKILL.md 正文(步骤清晰、可执行)
- 询问写入位置:
global 或 project
- 使用
write 工具写入 ~/.nova/skills/<name>/SKILL.md 或 .nova/skills/<name>/SKILL.md
- 提示用户运行
/技能名 或重启列表验证
引导模式(用户需求模糊)
依次询问:
- 技能要解决什么问题?
- 希望 Agent 按什么步骤执行?
- 是否需要禁止某些工具或 fork 子代理?
- 名称与一句话描述
然后进入 Quick 模式第 2–5 步。
优化已有技能
若用户提供了现有 SKILL.md 或技能名:
- 用
read 读取内容
- 检查:description 是否清晰、步骤是否可执行、frontmatter 是否合法
- 给出改进版 diff 或完整重写建议
- 经用户确认后再写入
约束
name 必须是合法 slug;非法时降级为目录名并警告。
- 不要创建加密 skill 或依赖未实现的
!`shell` 模板。
- 写入前向用户确认路径与内容摘要。