跳轉到

Release Notes — v0.1.2 (2026-05-22)

L 系列首例 worked example milestone — L13 paiban 加入 + metaJSON 承載類型分類重設計 + acquisitionChannel deprecation + 5 處 antipattern 清理。

本版包含 R-060 ~ R-077 + R-068.1（含 2026-05-21 末批 R-060 ~ R-063 + 2026-05-22 本輪 + verification phase 後補 R-075 ~ R-077）。

重點摘要

新增 worked example：L13 Paiban（L 系列首例）

L13 Paiban — 在地化 × 同義詞辨識（R-064 + R-065）：

  • 3 strategies 平行對照（Version A: Direct / Version B: AAT-guided / Version C: SPO Triple）— 用 prov:Collection.hadMember（不同於 C02 motifs 的 prov:wasInformedBy 順序審查）
  • 6 類 evidence system（含領域專家證據；vs C02 的 4 類）
  • 10 candidate × 11 DecisionNote 多對多治理結構
  • 舂牘 vs 牘關鍵分流（同 relation_type=historical-related 但不同 outcome）— L 系列同義詞邊界治理關鍵案例
  • 2026-05-19 領域專家複審（採 SourceEvidence 模式不創 ExpertReview TaskRun）

Schema 變更

Deprecated（v0.1.2）： - ex:acquisitionChannel（R-072）— 走 R-008 sourceLocator 同樣 deprecation 路徑；理由：atLocation 已涵蓋多數 URL 來源 + 自由字串無 SKOS scheme + v0.1 設計即標 Provisional 未真正 settle + non-URL 情境走 rdfs:comment / dcterms:provenance + DCMI 替代詞彙存在

Refined： - ex:metaJSON definition + condition + usage_notes（R-068.1）— 從「Vendor-specific implementation metadata」擴為「Artifact 結構化補充 metadata 承載槽」；condition 列三層分流（核心 ModelConfig / 次要 4 類 / 反指引 3 條） - TaskTypeScheme/SynonymJudgement 補 skos:scopeNote（R-066）— L 系列多對多候選詞篩選 + relation_type 治理用法說明

對外文件擴充

usage.md 「Element-level Capture Guidance」章新增 4 段（R-067 / R-068 / R-068.1 / R-069）： - metaJSON 承載類型分類（核心 / 次要 / 反指引） - L 系列多對多 DecisionNote 表達邊界（舂牘 / 牘範例） - Expert reconfirmation capture pattern（不創 ExpertReview TaskRun） - Strategy structure patterns: 平行對照 vs 順序審查（兩種 PROV-O 模式對照）

清理 antipattern

  • R-073：5 處 metaJSON.acquisitionChannel antipattern 移除（usage.md L16/L26 + c02-motifs.ttl L109/L159/L262 + c02-motifs.md L206）
  • R-074：2 處 metaJSON.model_slugs_used antipattern 移除（c02-motifs.ttl L109/L262 + c02-motifs.md L110/L348）— 採輕量路徑（保留 rdfs:comment narrative + PROV graph TurnRun.qualifiedAssociation 隱含支援）

Fixed（v0.1.2 verification phase 後補）

  • R-075：L13 worked example 事實校正（基於 06_test_cases/在地化/L13_paiban/ 同義詞辨識 3 raw md frontmatter）— human_agent：jason→yin-rong；model_slug：抽象→具體 gpt-4o；3 TaskRun 補 share URL + timestamps + PromptVersion artifacts；L13 md 撤回「dossier-only SoT」誤推聲明 + 補 raw md 路徑引用；案例背景表 / §3-5 fragments / CQ Coverage 同步
  • R-076：c02-motifs.ttl 移除 @base <urn:prov-ai:>（rdflib 嚴格 parse fix；latent issue 自 v0.1.0 起，非本輪 R-073/R-074 引入）；新增 scripts/prov-ai-validate-examples.py 進 verification pipeline 防回歸
  • R-077：SOP _SOP_case-ap-review.md 4 處反向修正（撤回前一輪「L 系列為 dossier-only」誤推）；§1.1 註腳補 C/L 系列 raw md 路徑分流 + §2 三種來源型態 rebuild + §4.2 事實校驗清單合併 + §8 升 skill 條件補 Glob 工具陷阱防範

完整 R-XXX 清單

承襲自 2026-05-21 末批： - R-060 (release-cleanup) / R-061 (structural) / R-062 (doc-honesty) / R-063 (release-doc-section CQ 頁)

本輪 2026-05-22： - R-064 (worked-example-narrative-new) — L13 paiban md 新增 - R-065 (worked-example-ttl-new) — L13 paiban ttl 新增 - R-066 (scope-note-update) — TaskTypeScheme/SynonymJudgement scopeNote - R-067 (release-doc-section) — Expert reconfirmation capture pattern - R-068 (release-doc-section) — L 系列多對多 DecisionNote 表達邊界 - R-068.1 (definition-refine + usage-notes-update + release-doc-section) — metaJSON 重定義 + 三層分流 - R-069 (release-doc-section) — Strategy structure patterns - R-070 (release-navigation) — mkdocs.yml + examples/index.md L13 升 v0.1.2 - R-071 (version-bump) — v0.1.2 release bump + changelog 摺疊結構 - R-072 (status-deprecate) — ex:acquisitionChannel deprecation - R-073 (worked-example-fact-fix + release-cleanup) — acquisitionChannel antipattern 5 處清理 - R-074 (worked-example-fact-fix + release-cleanup) — model_slugs_used antipattern 2 處清理

Verification phase 後補（2026-05-22）： - R-075 (worked-example-fact-fix) — L13 worked example 基於 raw md frontmatter 事實校正 - R-076 (worked-example-fact-fix + tooling-add) — c02-motifs.ttl 移除 @base <urn:prov-ai:> + 新增 prov-ai-validate-examples.py - R-077 (sop-rollback + tooling-lesson) — SOP 4 處反向修正撤回「L 系列 dossier-only」誤推 + Glob 中文路徑陷阱固化

詳見 Changelog [0.1.2]。

新引入 change_type

本輪新引入 4 個 change_type： - worked-example-narrative-new（worked example md 新增；首次採納 2026-05-22 R-064） - worked-example-ttl-new（worked example ttl 新增；首次採納 2026-05-22 R-065） - release-navigation（release nav 變動；首次採納 2026-05-22 R-070） - version-bump（VERSION + changelog 升版整合；首次採納 2026-05-22 R-071）

v0.1.2 統計變動

  • Active Element 總計：54 → 53（acquisitionChannel deprecated）
  • Deprecated Element：1 → 2（含 acquisitionChannel）
  • Element 總計（含 deprecated）：55（不變；R-032 補登 wasGeneratedAtTime 之後維持）
  • Worked Examples：1 → 2（C02 motifs + L13 paiban）
  • usage.md 章節：4 段 Element-level Capture Guidance → 8 段（新增 metaJSON 承載分類 + L 系列多對多 DecisionNote + Expert reconfirmation + Strategy structure）

接下來

  • L08 bianzhong（範圍註撰寫）— Round 3 backlog 第二項；沿用 L13 已建立的 L 系列骨架
  • TaskTypeScheme 5 處對應缺口重設計 — 待 L08 + L13 + 2-3 案累積後評估升 ActivityTypeScheme/TaskRunType narrower（如 SynonymJudgement / ScopeNoteAuthoring / EvaluationReport）
  • candidate_role SKOS scheme 評估（per R-068.1 次要承載 interim）— 待 L08 累積後評估升 L2 CandidateRoleScheme