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: 优秀案例摘要(可选)
执行流程
- 提取方法论: 从 knowhow 中提取 step-by-step 流程
- 对齐 benchmark: 确保 Skill 的每个步骤都覆盖 benchmark 的评分维度
- 设定输出格式: 根据 domain 特征定义精确的输出结构
- 生成自检清单: 每项对应 benchmark 的一个维度
- 添加参考示例: 从 good_testdata 中提取 1-2 个精简示例
- 输出 SKILL.md: 写入
{workDir}/{skillName}/SKILL.md - 注册到 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 等
你只需要确保:
- SKILL.md 的 YAML frontmatter 包含完整的元数据
- 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)
[精简的标杆示例]
关键原则
- 可操作: 方法论必须是 step-by-step,Agent 能直接照着执行
- 一致性: Quality Checklist 必须与 benchmark 维度一一对应
- 简洁: SKILL.md 控制在 500 行以内
- 精确: 输出格式要有具体的结构和长度要求
- 正确目录: 新 Skill 写入工作区目录下的
{skillName}/,系统自动注册到 SQLite