---
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 要求

```yaml
---
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 的意图匹配

## 输出格式

```markdown
---
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