字典
AIMO 字典是分類法內所有有效代碼的權威清單。它提供每個代碼的完整定義,包括標籤、說明和生命週期資訊。
什麼是字典
字典提供所有 AIMO 分類代碼的完整、機器可讀集合。它包含:
- 8 個維度中的所有 91 個代碼
- 標籤和定義(語言套件中有翻譯)
- 生命週期中繼資料(狀態、引入版本、棄用、移除)
- 代碼使用的範圍說明和範例
字典實現:
- 證據範本:代碼用於 EV 範本中分類 AI 系統
- 驗證器:驗證器檢查所有代碼是否存在於字典中
- 覆蓋範圍對應:代碼實現與外部框架和法規的對應
!!! info "單一事實來源(SSOT)" 字典的 SSOT 是:
- **結構**:`data/taxonomy/canonical.yaml`(代碼、狀態、生命週期)
- **翻譯**:`data/taxonomy/i18n/*.yaml`(每種語言的標籤、定義)
CSV 檔案是用於發布的**產生的人工產物**。請參閱[發布](../../releases/index.md)了解下載。
欄位結構描述
規範字典使用 18 欄(語言中立結構):
識別欄位(5)
| # | 欄位 | 必要 | 說明 | 範例 |
|---|---|---|---|---|
| 1 | standard_id |
是 | 標準識別碼 | AIMO-STD |
| 2 | standard_version |
是 | SemVer 格式 | 0.1.0 |
| 3 | dimension_id |
是 | 兩字母維度 ID | FS、UC、DT |
| 4 | dimension_name |
是 | 維度名稱 | Functional Scope |
| 5 | code |
是 | 完整代碼 | UC-001 |
標籤和定義欄位(4)
| # | 欄位 | 必要 | 說明 | 範例 |
|---|---|---|---|---|
| 6 | label |
是 | 代碼標籤(最多 50 字元) | General Q&A |
| 7 | definition |
是 | 代碼定義(1-2 句) | General question answering... |
| 8 | scope_notes |
否 | 使用範圍澄清 | Low to medium risk... |
| 9 | examples |
否 | 管道分隔的範例 | chatbot\|recommendation |
!!! note "翻譯"
規範資料模型將翻譯分離到語言套件(data/taxonomy/i18n/*.yaml)。每個語言套件提供本地化的 dimension_name、label 和 definition 值。請參閱在地化指南了解詳情。
生命週期欄位(6)
| # | 欄位 | 必要 | 說明 | 範例 |
|---|---|---|---|---|
| 10 | status |
是 | active、deprecated、removed |
active |
| 11 | introduced_in |
是 | 新增時的版本 | 0.1.0 |
| 12 | deprecated_in |
否 | 棄用時的版本 | 1.2.0 |
| 13 | removed_in |
否 | 移除時的版本 | 2.0.0 |
| 14 | replaced_by |
否 | 替代代碼 | UC-015 |
| 15 | backward_compatible |
是 | true 或 false |
true |
治理欄位(3)
| # | 欄位 | 必要 | 說明 | 範例 |
|---|---|---|---|---|
| 16 | references |
否 | 外部參照 | ISO/IEC 42001 |
| 17 | owner |
否 | 負責方 | AIMO WG |
| 18 | last_reviewed_date |
否 | 最後審查(YYYY-MM-DD) | 2026-01-19 |
初始條目
目前字典版本是 v0.1.0,包含:
| 維度 | 名稱 | 啟用代碼 | 已棄用 | 總計 |
|---|---|---|---|---|
| FS | 功能範圍 | 6 | 0 | 6 |
| UC | 使用案例類別 | 30 | 0 | 30 |
| DT | 資料類型 | 10 | 0 | 10 |
| CH | 通道 | 8 | 0 | 8 |
| IM | 整合模式 | 7 | 0 | 7 |
| RS | 風險面 | 8 | 0 | 8 |
| OB | 成果 / 效益 | 7 | 0 | 7 |
| LG | 日誌/記錄類型 | 15 | 0 | 15 |
| 總計 | 91 | 0 | 91 |
!!! note "完整代碼清單" 完整的 91 個代碼清單可在產生的 CSV 人工產物中取得。本文件頁面提供欄位定義和使用指引。如需詳細的代碼定義:
- **下載**:請參閱[發布](../../releases/index.md)了解各語言 CSV 檔案
- **各語言 CSV**:`artifacts/taxonomy/current/{lang}/taxonomy_dictionary.csv`
- **舊版 EN/JA 混合 CSV**:`source_pack/03_taxonomy/legacy/taxonomy_dictionary_v0.1.csv`(凍結,僅用於向後相容性)
更新政策
新增代碼
- 在維度內分配下一個可用號碼(例如
UC-030之後是UC-031) - 將
status設為active - 將
introduced_in設為目前版本 - 將
backward_compatible設為true - 提供標籤和定義(將翻譯新增到語言套件)
修改現有代碼
| 變更類型 | 允許 | 版本影響 |
|---|---|---|
| 定義澄清 | 是 | PATCH |
| 範圍說明更新 | 是 | PATCH |
| 標籤變更(含義保留) | 是 | MINOR |
| 含義變更 | 否 | 改為建立新代碼 |
棄用代碼
- 將
status設為deprecated - 將
deprecated_in設為目前版本 - 將
replaced_by設為新代碼(如適用) - 代碼仍然可用以保持向後相容性
- 在 scope_notes 中記錄原因
移除代碼
- 首先至少棄用一個 MINOR 版本
- 將
status設為removed - 將
removed_in設為目前 MAJOR 版本 - 代碼對新證據不再有效
相容性政策
| 動作 | 版本影響 | 向後相容 |
|---|---|---|
| 新增代碼 | MINOR | 是 |
| 棄用代碼 | MINOR | 是 |
| 澄清定義 | PATCH | 是 |
| 移除代碼 | MAJOR | 否 |
| 變更代碼含義 | 不允許 | - |
如何使用
在證據範本中
每個 EV 範本包含一個 8 維度代碼表:
## AIMO 代碼(8 維度)
| 維度 | 代碼 | 標籤 |
| --- | --- | --- |
| **FS** | `FS-001` | 終端使用者生產力 |
| **UC** | `UC-001`、`UC-002` | 一般問答、摘要 |
| **DT** | `DT-002`、`DT-004` | 內部、個人資料 |
| **CH** | `CH-001` | Web UI |
| **IM** | `IM-002` | SaaS 整合 |
| **RS** | `RS-001`、`RS-003` | 資料洩漏、合規違反 |
| **OB** | `OB-001` | 效率 |
| **LG** | `LG-001`、`LG-002` | 請求記錄、審查/核准記錄 |
在驗證器中
驗證器檢查:
- 證據中參照的所有代碼都存在於字典中
- 代碼格式符合預期模式(
PREFIX-###) - 已棄用的代碼觸發警告
- 已移除的代碼被拒絕
擴展指引
組織可以使用自訂代碼擴展字典:
擴展前綴:
X-<ORG>-<DIM>-<TOKEN>
範例:X-ACME-UC-901 用於 ACME 公司的自訂使用案例代碼。
擴展規則:
- 自訂代碼不得與標準代碼衝突
- 自訂代碼應記錄在本地擴展字典中
- 與外部方交換證據時,僅使用標準代碼
下載
請參閱發布了解包含字典和相關檔案的可下載套件。