| name | skill-registry-scan |
| description | 小能核心技能 — 扫描所有workspace的skills/目录,自动生成/更新skill-registry.json。多信号成熟度推断+异常检测+批量模式。触发词:扫描registry/更新技能目录/小能巡检/scan skills |
| version | v2.0 |
Skill Registry Scan
v2.0 | 升级:多信号成熟度推断+异常检测+批量扫描
触发词
- "扫描 registry" / "更新技能目录" / "小能巡检" / "scan skills"
流程
Step 1:扫描目录
扫描范围(默认当前workspace,--all扫描所有workspace):
/root/.openclaw/workspace/skills/*/SKILL.md
/root/.openclaw/workspace-lengjing/skills/*/SKILL.md
/root/.openclaw/workspace-xiaokai/skills/*/SKILL.md
/root/.openclaw/shared-skills/*/SKILL.md
对每个SKILL.md提取:
name(frontmatter)
description(frontmatter)
version(如有)
- 是否有
references/ 目录
- 是否有
memory/ 目录
- 是否有
scripts/ 目录
- 是否有
evals/ 目录
- SKILL.md 行数
- frontmatter完整性(name+description是否齐全)
Step 2:对比现有 registry
读取 memory/skill-registry.json,对比:
- 新增:目录中有但registry中没有的
- 修改:SKILL.md最后修改时间比registry的last_scan新的
- 删除:registry中有但目录中已不存在的
Step 3:多信号成熟度推断
不再只看行数,综合5个信号:
| 信号 | 权重 | 评分规则 |
|---|
| SKILL.md行数 | 20% | >500行=5, 300-500=4, 200-300=3, 100-200=2, <100=1 |
| references数量 | 25% | ≥3个=5, 2个=4, 1个=3, 0个=1 |
| memory数量 | 15% | ≥5个=5, 3-4个=4, 1-2个=3, 0个=1 |
| frontmatter完整性 | 20% | name+description+version=5, name+description=4, 只有name=2, 缺失=1 |
| 辅助目录 | 20% | scripts+evals都有=5, 有其一=3, 都没有=1 |
成熟度映射:
- 综合分4.5-5.0 → L4(生产级)
- 综合分3.5-4.4 → L3(可用)
- 综合分2.5-3.4 → L2(实验)
- 综合分1.0-2.4 → L1(概念)
Step 4:异常检测
自动标记以下异常:
| 异常类型 | 检测规则 | 严重度 |
|---|
| 空SKILL.md | 行数<10或内容为空 | 🔴 严重 |
| frontmatter缺失 | 没有name或description | 🔴 严重 |
| description过短 | description<20字符 | 🟡 警告 |
| 无references的大型Skill | >300行且无references/ | 🟡 警告 |
| 无触发词 | description中无明确触发场景 | 🟡 警告 |
| 孤立Skill | 与其他Skill无任何关系 | 🟢 提示 |
Step 5:更新 registry.json
增量更新 memory/skill-registry.json:
{
"name": "skill-name",
"path": "skills/skill-name/",
"agent": "小能",
"version": "v2.0",
"status": "active",
"maturity": "L3",
"maturity_signals": {
"lines": 115,
"refs_count": 2,
"mem_count": 1,
"frontmatter": "complete",
"aux_dirs": ["scripts"]
},
"maturity_score": 4.2,
"type_primary": "管理类",
"anomalies": [],
"last_scan": "2026-05-01T16:00:00+08:00"
}
Step 6:输出变更摘要
📊 Skill Registry 扫描完成
━━━━━━━━━━━━━━━━━━━━
扫描范围:{workspace-list}
总计:XX 个 Skill(active XX | deprecated XX)
🆕 新增:X 个
- skill-name — description [L2]
✏️ 修改:X 个
- skill-name — 变更说明
🗑️ 删除:X 个
- skill-name
⚠️ 异常:X 个
- skill-name — 🔴 空SKILL.md
- skill-name — 🟡 无触发词
📈 成熟度分布:L4:{N} | L3:{N} | L2:{N} | L1:{N}
输出文件
memory/skill-registry.json — 更新后的完整registry
memory/scan-log.md — 追加本次扫描记录
注意事项
- 只追加/修改,不从头重建registry
- 新Skill自动标记status: "active",成熟度为推断值
- 异常Skill(空SKILL.md/frontmatter缺失)标为"needs_review"
- 扫描结果喂给skill-audit(深度评估)、skill-graph(关系推断)、agent-capability-map(能力地图)