| name | skill-creator |
| description | 当用户要手动创作或改写一个新的知微 Skill、需要 v2 规范示例模板、排查 description/body 校验失败原因或打磨 metadata.zhiwei 元数据时使用。 |
| version | 1.1.0 |
| metadata | {"zhiwei":{"tags":["skill-spec","meta","v2","template","author","validation"],"suggested_tools":["file.read","file.write"]}} |
Skill 创作指南
帮用户手写 / 改写一份符合 v2 规范的 SKILL.md。核心约束：description 必须以"当 / 用于 / Use when"开头，不含工作流词；body 必须有"适用场景 / 不适用场景 / 工作流"三小节。
适用场景
- 用户从零写一个新的 Skill（描述 / 工作流 / references 全套）
- 改写老格式 Skill 让它符合 v2 规范
- 修复因 description / body 校验失败被跳过的 Skill
- 打磨 metadata.zhiwei（tags / suggested_tools / requires）
不适用场景
- 从开源市场找现成 Skill → 走前端"扩展市场"页面
- 只是查看已有 Skill 列表 / 能力 → 直接调
status 工具
- 调用已有 Skill 执行业务 → 直接
skill_load
工作流
- 目录结构：
skills/<name>/ 下 SKILL.md + 可选 references/ / scripts/ / assets/
- 写 frontmatter：name（kebab-case）+ description（≤1024）+ version（semver）+ metadata.zhiwei（可选）
- description 硬约束：
- 必须以"当 / 用于 / Use when"开头
- 禁工作流词：步骤 N / 首先 / 然后 / Step N / First / Then 不能出现
- 列关键词（用户高频说法）+ 边界（不适用场景的反向引导）
- body 三必需小节：标题完全一致（
## 适用场景 / ## 不适用场景 / ## 工作流）；body ≤5000 字符
- 复杂内容下沉 references：长命令 / 详细模板 / 大量样例放
references/<name>.md，body 只引用
- suggested_tools 仅作元数据：不会在
skill.load 后自动注入；如填写，优先写已注册 canonical Tool ID，并用 status / tool.search 核对
- 3 指标自检：用词精简？职责分工（不重复 react-system / context-guide 已说的全局规则）？场景全面（按用户表达列分流路径）？
详细参考
- v2 frontmatter 完整字段、body 模板、常见校验错误、迁移老 Skill 步骤：
{skill_dir}/references/v2-spec-template.md
