RoleScheme¶

屬性	值
Scheme ID	`provai:scheme-RoleScheme`
綁定屬性	`prov:hadRole` (domain: `prov:Association`; MUST)
版本	0.2.0（4 角色，對齊 DataCite / MARC / CRediT）
結構	4 個 `hasTopConcept`，可擴充
TTL 檔案	`concept-schemes/role.ttl`

描述 prov:Agent 在 prov:Activity 中扮演的角色。對齊 DataCite contributorType、MARC relator codes、CRediT Contributor Roles。

命名標準對照¶

Role IRI	中文 prefLabel	DataCite 4.5	MARC relator	CRediT	對應度
`Editor`	編輯（簽核）	Editor	edt	(none)	✅ 完全對齊
`Reviewer`	審查者	(none)	rev	(none)	✅ MARC 對齊
`ModelRunner`	模型執行者	(none)	(none)	Software (loose)	⚠️ 專案自定
`Evaluator`	評估者	(none)	(none)	Validation (loose)	⚠️ 專案自定

Concepts¶

Editor — 編輯（簽核）¶

對該筆輸出之採用／不採用／關係調整負最終責任者。可由 prov:Person 或 prov:Organization 擔任。

<scheme/RoleScheme/Editor>
    skos:prefLabel "編輯（簽核）"@zh-Hant , "Editor"@en ;
    skos:closeMatch <http://id.loc.gov/vocabulary/relators/edt> ;
    dcterms:source "DataCite Metadata Schema 4.5 contributorType: Editor; MARC relator code: edt"@en .

Reviewer — 審查者¶

提供領域知識審閱、修正與背書意見之專家／社群代表。

對應 MARC relator code: rev。

ModelRunner — 模型執行者¶

執行生成並產生輸出內容之工具／模型（如 LLM、管線服務），通常為 prov:SoftwareAgent。

CRediT Software 為 loose match；國際無精確對應，本 AP 自定。

Evaluator — 評估者¶

對輸出進行評估／打分／錯誤標記之 Agent。

重要原則： 自動 vs 人工的區分透過 prov:Agent 的 type（prov:SoftwareAgent vs prov:Person）表達，不在 role name 綁定。同一 IRI Evaluator 由不同 type Agent 擔任時自然帶不同語意。

命名理由：原 v0.1 設計命名為 AutoScorer，但 Auto 前綴違反 W3C PROV-O §5.6 「role 是 contextual」原則。改為 Evaluator 並透過 agent type 表達自動性。

兩端覆蓋原則¶

每個 ex:TaskRun 與 ex:TurnRun 都需要 prov:qualifiedAssociation，但兩端的角色不同：

case-level qualifiedAssociation (在 ex:TaskRun 上)
    └─ human_agent_id (jason / yin-rong)
       → prov:agent
       → prov:hadRole = RoleScheme:Editor

turn-level qualifiedAssociation (在 ex:TurnRun 上；assistant-only)
    └─ model_slug (provai:agent-{provider}-{model_slug})
       → prov:agent
       → prov:hadRole = RoleScheme:ModelRunner

msg.author.role 走 quality flag，不對應 RoleScheme（四層分離原則：activity scope / agent type / role / msg author role）。

範例¶

完整使用範例見 C02 Motifs worked example。

ex:taskrun/T-C02 a ex:TaskRun ;
    prov:qualifiedAssociation [
        a prov:Association ;
        prov:agent <provai:agent-jason> ;
        prov:hadRole <provai:scheme/RoleScheme/Editor>
    ] .

ex:turnrun/T-C02-2 a ex:TurnRun ;
    prov:qualifiedAssociation [
        a prov:Association ;
        prov:agent <provai:agent-openai-gpt-5-thinking> ;
        prov:hadRole <provai:scheme/RoleScheme/ModelRunner>
    ] .