SKILL.md 4.01 KB

name: skill-creator description: > Skill 创建器。根据 knowhow.md 和 benchmark.md 的领域知识, 创建一个高质量的 SKILL.md 提示词文件。生成的 Skill 具备:明确的角色与目标、 step-by-step 方法论、精确的输出格式、质量自检清单。

Use when: 需要创建新的 Skill prompt,Innovator 完成 Hunt+Digest 后的 Skill 生成步骤。

Skill Creator

从 knowhow + benchmark 合成可执行的 SKILL.md。

输入

  • skillName: Skill 名称
  • domain: 领域名称
  • description: 一句话描述
  • knowhow: knowhow.md 完整内容(方法论 + 最佳实践)
  • benchmark: benchmark.md 完整内容(评分标准)
  • goodTestdata: 优秀案例摘要(可选)

执行流程

  1. 提取方法论: 从 knowhow 中提取 step-by-step 流程
  2. 对齐 benchmark: 确保 Skill 的每个步骤都覆盖 benchmark 的评分维度
  3. 设定输出格式: 根据 domain 特征定义精确的输出结构
  4. 生成自检清单: 每项对应 benchmark 的一个维度
  5. 添加参考示例: 从 good_testdata 中提取 1-2 个精简示例
  6. 输出 SKILL.md: 写入 {workDir}/{skillName}/SKILL.md
  7. 注册到 SQLite: 调用 InnovatorService 的 autoRegisterNewSkills 自动扫描并注册

新 Skill 的目录位置

新创建的 Skill 必须写入 工作目录(即 agent 工作区根目录下),而不是 repo/skills/:

{skillName}/
  ├── SKILL.md         ← 你要创建的核心文件
  ├── source/
  │   └── metadata.json
  ├── hunt/
  ├── digest/
  └── evolve/

注意:repo/skills/ 目录仅存放核心系统 Agent(master, coder, innovator 等),随 Git 部署。 用户创建的新 Skill 写入工作目录(通常为 data/trained_skills/user_{id}/),系统自动注册。

Step 7 详细说明:注册到 SQLite

创建完 SKILL.md 后,系统会自动注册新 Skill 到 SQLite 数据库:

  • InnovatorService.autoRegisterNewSkills() 会扫描 data/skills/ 目录
  • 发现新的包含 SKILL.md 的子目录时,自动解析 YAML frontmatter 并注册
  • 注册信息包括:skillName, description, domain, scope, keywords, directory 等

你只需要确保:

  1. SKILL.md 的 YAML frontmatter 包含完整的元数据
  2. SKILL.md 写入了正确的目录(工作区下的 {skillName}/SKILL.md)

系统会在以下时机自动扫描注册:

  • Innovator 对话结束后
  • 管理员手动触发 "扫描技能目录"
  • 服务重启时

SKILL.md 的 YAML Frontmatter 要求

---
name: {skill_name}
description: >
  {一句话描述}。
  Use when: {适用场景}
version: 1.0.0
domain: {领域}
scope: {细分范围}
keywords: [{关键词1}, {关键词2}, ...]
---

注意:

  • name 必须与目录名一致
  • description 末尾加 Use when: {适用场景} 以帮助 Master Agent 路由
  • keywords 至少包含 5 个关键词,涵盖中英文
  • domain 和 scope 用于 Innovator 的意图匹配

输出格式

---
name: {skill_name}
description: >
  {一句话描述}。Use when: {适用场景}
version: 1.0.0
domain: {领域}
scope: {细分范围}
keywords: [{关键词1}, {关键词2}, ...]
---

# {Skill Name}

## Role & Objective
[Agent 的角色和目标]

## Methodology
### Step 1: [步骤名]
[具体操作指令,从 knowhow 提取]

### Step 2: [步骤名]
...

## Output Format
[精确的格式、结构、长度要求]

## Quality Checklist
- [ ] {维度1}: {具体检查标准}(对应 benchmark 维度1)
- [ ] {维度2}: {具体检查标准}
...

## Reference Examples
### Example 1 (Elite)
[精简的标杆示例]

关键原则

  1. 可操作: 方法论必须是 step-by-step,Agent 能直接照着执行
  2. 一致性: Quality Checklist 必须与 benchmark 维度一一对应
  3. 简洁: SKILL.md 控制在 500 行以内
  4. 精确: 输出格式要有具体的结构和长度要求
  5. 正确目录: 新 Skill 写入工作区目录下的 {skillName}/,系统自动注册到 SQLite