CMDCSkillEngine.Types.SkillRecord (cmdc_skill_engine v0.3.0)

Copy Markdown View Source

Skill 完整档案:身份 + 血统 + 依赖 + 质量统计 + 多租户切片。

质量指标

  • applied_rate — 选中后被实际应用的比率
  • completion_rate — 应用后任务完成的比率
  • effective_rate — 端到端效率:选中 → 应用 → 完成
  • fallback_rate — 选中但未应用的比率(Skill 不可用信号)

多租户切片(v0.3 起)

  • scope — 数据切片维度(默认 "global",向后兼容 v0.2.x 老数据)。 SaaS 多租户场景下建议传 tenant_id;单租户私有化部署保持默认即可。 本字段由 Store 在写入时维护,调用方一般不需要手动设置。
  • metadata — 集成方自由扩展字段(如 %{"studio.tenant_name" => "..."})。 建议用 "<namespace>.<field>" 命名空间约定避免跨集成方撞名;本 v0.3 未强制校验,留后续按需收紧。

Summary

Types

t()

@type t() :: %CMDCSkillEngine.Types.SkillRecord{
  category: CMDCSkillEngine.Types.SkillCategory.t(),
  critical_tools: [String.t()],
  description: String.t(),
  first_seen: DateTime.t() | nil,
  is_active: boolean(),
  last_updated: DateTime.t() | nil,
  lineage: CMDCSkillEngine.Types.SkillLineage.t(),
  metadata: %{optional(String.t()) => term()},
  name: String.t(),
  path: String.t(),
  recent_analyses: [CMDCSkillEngine.Types.ExecutionAnalysis.t()],
  scope: String.t(),
  skill_id: String.t(),
  tags: [String.t()],
  tool_dependencies: [String.t()],
  total_applied: non_neg_integer(),
  total_completions: non_neg_integer(),
  total_fallbacks: non_neg_integer(),
  total_selections: non_neg_integer()
}

Functions

applied_rate(map)

@spec applied_rate(t()) :: float()

completion_rate(map)

@spec completion_rate(t()) :: float()

effective_rate(map)

@spec effective_rate(t()) :: float()

fallback_rate(map)

@spec fallback_rate(t()) :: float()