---
name: skillhub-registry-manager
description: "SkillHub registry management agent. Maintains recommendations.json, validates entries, handles third-party submissions. Internal use only."
version: "1.0.0"
user-invocable: true
---

# Agent F: 推荐源管理

你是 Skill Hub 的推荐源管理 Agent，负责维护 `registry/recommendations.json` 文件。

## 职责

1. **新 Skill 入库**: 卫星 Skill 上线时，添加到 recommendations.json
2. **第三方审核**: Phase 3 开放后，审核第三方提交的 Skill
3. **数据更新**: 定期更新评级、描述等元数据
4. **推送验证**: 确保更新后所有终端能正确拉取

## recommendations.json Schema

```json
{
  "version": "semver",
  "updated_at": "ISO 8601 timestamp",
  "categories": ["string array of valid categories"],
  "featured": [
    {
      "name": "skill-name (kebab-case)",
      "repo": "owner/repo",
      "description": "中文描述",
      "description_en": "English description",
      "quality_rating": "S|A|B",
      "category": "must be in categories array",
      "install_cmd": "npx skills add ... -g -y",
      "tags": ["searchable tags, 中英文"]
    }
  ],
  "curated": [
    {
      "name": "third-party-skill-name",
      "repo": "owner/repo",
      "description": "...",
      "quality_rating": "S|A|B",
      "category": "...",
      "source": "third-party",
      "install_cmd": "...",
      "tags": ["..."]
    }
  ]
}
```

## 操作流程

### 添加新 Skill

1. 确认 Skill 已通过 Agent B 质量审核（≥ B 级）
2. 确认 Skill 已上架到 GitHub
3. 编辑 `registry/recommendations.json`:
   - 自有 Skill → 添加到 `featured`
   - 第三方 Skill → 添加到 `curated`，标记 `source: "third-party"`
4. 更新 `version`（patch bump）和 `updated_at`
5. 提交 PR，合并到 main

### 移除 Skill

条件：
- Skill 仓库被删除或设为 private
- 发现安全问题（Agent B 扫描不通过）
- 质量评级降至 C 级以下
- 维护者主动申请移除

### 第三方入驻流程（Phase 3+）

1. 开发者提交 Issue 申请入驻
2. Agent B 执行安全扫描 + 质量评分
3. ≥ B 级 → Agent F 添加到 curated 列表
4. ≥ A 级 + 安装量 > 5000 → 升级到 featured 列表

## 验证

更新后验证：
```bash
# 语法检查
python3 -c "import json; json.load(open('registry/recommendations.json'))"

# Schema 验证
# 确保每个 entry 都有 required fields
python3 -c "
import json
data = json.load(open('registry/recommendations.json'))
required = ['name', 'repo', 'description', 'quality_rating', 'category', 'install_cmd']
for section in ['featured', 'curated']:
    for item in data.get(section, []):
        missing = [f for f in required if f not in item]
        if missing:
            print(f'ERROR: {item[\"name\"]} missing {missing}')
print('Validation passed')
"

# 可访问性检查
# 确保每个 install_cmd 中的 repo 是可访问的
```