import sys; sys.path.append('../memory/skill_search')
from skill_search import search

results = search("python send email")  # ⚠️ 必须用英文查询，中文匹配效果极差
for r in results:
    s = r.skill
    print(f"[{r.final_score:.2f}] {s.name} — {s.one_line_summary}")
    print(f"  key: {s.key}  category: {s.category}  tags: {s.tags[:3]}")

search(query, env=None, category=None, top_k=10) -> list[SearchResult]
#  env: 自动检测，一般不传
#  category: 可选过滤，如 "devops"
#  top_k: 返回数量，默认10

SearchResult
  .final_score    float     综合评分 (0~1)
  .relevance      float     语义相关度
  .quality        float     质量分
  .match_reasons  list[str] 匹配原因
  .warnings       list[str] 警告
  .skill          SkillIndex ↓

SkillIndex (常用字段)
  .key              str       唯一标识/路径
  .name             str       名称
  .one_line_summary str       一句话摘要
  .description      str       详细描述
  .category         str       类别
  .tags             list[str] 标签
  .form             str       形式(sop/script/...)
  .autonomous_safe  bool      是否自主安全

python -m skill_search "python testing"
python -m skill_search "docker deployment" --category devops --top 5
python -m skill_search "git" --json
python -m skill_search --stats
python -m skill_search --env