SuperAPI AI 工具集

skos-taxonomy

设计与创作

查看项目

更新于 10-16 09:57

技能介绍

用途:为 joelclaw(Panda 及其子智能体)设计、应用和维护 SKOS 受控词表,使分类一致、检索上下文更好,避免标签泛滥。适用于涉及 taxonomy、SKOS、受控词表、概念方案,以及对智能体交互、运行、文档、记忆、事件、任务进行分类,设计 concept_ids / primary_concept_id 契约,映射到其他词表,或判断是否需要 SKOS 的场景。

主要能力:产出带稳定概念 URI 的版本化 SKOS 概念方案;生成确定性的智能体分类规则;提供 Typesense 字段映射以支持词法、分面和混合检索;制定候选概念、别名漂移、弃用与映射的治理规则。

强制 SKOS 规则:skos:Concept 与 skos:ConceptScheme 为不同类;skos:broader 不具传递性,闭包查询用 skos:broaderTransitive;每语言每资源仅一个 skos:prefLabel;prefLabel、altLabel、hiddenLabel 在同一资源+语言形式下两两不相交;skos:related 与 skos:broaderTransitive 不相交;映射属性用于跨方案链接,exactMatch 传递且慎用,closeMatch 非传递;Collection/OrderedCollection 用于分组且与 Concept 不相交。违反需先修复数据再上线。

JoelClaw 工作负载方案 v1:方案 URI joelclaw:scheme:workload:v1,版本串 workload-v1,概念 URI 模式 joelclaw:concept:<top-level>[:<subconcept>]。顶层概念包括 PLATFORM、INTEGRATION、TOOLING、PIPELINE、BUILD、KNOWLEDGE、COMMS、OBSERVE、META。

使用方式:子智能体输出应包含 primary_concept_id、concept_ids、taxonomy_version、concept_source、classification_confidence。分类流程为规范化标签、按 prefLabel/altLabel/hiddenLabel 匹配、用 scopeNote 与相邻概念消歧、输出一个主概念与可选次概念、未解析则用受控回退概念并记录未映射标签,同时发出 OTEL 映射诊断元数据。

SKOS-XL:仅当标签对象需要元数据或关系时使用,如缩略语溯源、按标签来源、多语言审核、标签间关系;仅作同义词时用核心 SKOS 标签。跨词表映射用 exactMatch、closeMatch、broadMatch/narrowMatch、relatedMatch,内部跨方案示例见资料。分组用 Collection,层级用 broader/narrower。URI 与 notation 策略:本地部分用小写 kebab 或冒号分隔路径,notation 发布后不可变,不复用概念 URI,人类名称放入标签。

Typesense 集成:SKOS 为语义真源,Typesense 为检索运行时。字段映射包括 id、scheme_id、notation、pref_label、alt_labels、hidden_labels、definition、scope_note、broader_ids、narrower_ids、related_ids、映射字段、taxonomy_version、state;可检索实体另存 primary_concept_id、concept_ids、concept_source、taxonomy_version 等。查询示例:curl -s "http://localhost:8108/collections/taxonomy_concepts/documents/search?q=ingest+pipeline&query_by=pref_label,alt_labels,scope_note,definition&per_page=10" -H "X-TYPESENSE-API-KEY: panda-typesense-key";概念约束检索用 filter_by=concept_ids:=[joelclaw:concept:pipeline] && taxonomy_version:=workload-v1。无词法查询时用 q=*。传递层级检索需预计算 ancestor_concept_ids。本地不可达时执行 kubectl port-forward -n joelclaw svc/typesense 8108:8108。

质量门禁:标签完整性(每语言单 prefLabel、标签无重叠)、结构完整性(单方案归属、无环、broader/narrower 一致)、映射完整性(只指向外部方案、exactMatch 经评审)、运行时完整性(新记录 concept_ids 覆盖不低于 95%、未映射标签在 OTEL 可见)。探针示例:joelclaw otel search "concept_ids|primary_concept_id|taxonomy_version" --hours 24;joelclaw recall "<query>";joelclaw docs search "<query>" --concept <concept-uri>。

治理:候选概念需带 scopeNote,检查标签冲突,验证分类规则与检索过滤影响,经评审和使用观察后转正,弃用用状态转换加映射提示而非复用 URI,版本变更需迁移说明。

限制与反模式:不做自由标签泛滥、不把 exactMatch 当同义词、不把集合成员当层级、不建无检索用途的深树、不省略 scopeNote 而靠提示词补救。当稳定标签少于约30个、无层级/映射需求、无多语言与别名治理、标签不跨系统复用、检索质量不依赖概念语义时,SKOS 属于过度设计,可用简单标签或枚举;任一条件不再成立则应先迁移到 SKOS 再扩展。资料未提供官方收费、价格和平台支持等信息。