跳轉到

字典

AIMO 字典是分類法內所有有效代碼的權威清單。它提供每個代碼的完整定義,包括標籤、說明和生命週期資訊。

什麼是字典

字典提供所有 AIMO 分類代碼的完整、機器可讀集合。它包含:

  • 8 個維度中的所有 91 個代碼
  • 標籤和定義(語言套件中有翻譯)
  • 生命週期中繼資料(狀態、引入版本、棄用、移除)
  • 代碼使用的範圍說明和範例

字典實現:

  1. 證據範本:代碼用於 EV 範本中分類 AI 系統
  2. 驗證器:驗證器檢查所有代碼是否存在於字典中
  3. 覆蓋範圍對應:代碼實現與外部框架和法規的對應

!!! 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 FSUCDT
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_namelabeldefinition 值。請參閱在地化指南了解詳情。

生命週期欄位(6)

# 欄位 必要 說明 範例
10 status activedeprecatedremoved 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 truefalse 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`(凍結,僅用於向後相容性)

更新政策

新增代碼

  1. 在維度內分配下一個可用號碼(例如 UC-030 之後是 UC-031
  2. status 設為 active
  3. introduced_in 設為目前版本
  4. backward_compatible 設為 true
  5. 提供標籤和定義(將翻譯新增到語言套件)

修改現有代碼

變更類型 允許 版本影響
定義澄清 PATCH
範圍說明更新 PATCH
標籤變更(含義保留) MINOR
含義變更 改為建立新代碼

棄用代碼

  1. status 設為 deprecated
  2. deprecated_in 設為目前版本
  3. replaced_by 設為新代碼(如適用)
  4. 代碼仍然可用以保持向後相容性
  5. 在 scope_notes 中記錄原因

移除代碼

  1. 首先至少棄用一個 MINOR 版本
  2. status 設為 removed
  3. removed_in 設為目前 MAJOR 版本
  4. 代碼對新證據不再有效

相容性政策

動作 版本影響 向後相容
新增代碼 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` | 請求記錄、審查/核准記錄 |

在驗證器中

驗證器檢查:

  1. 證據中參照的所有代碼都存在於字典中
  2. 代碼格式符合預期模式(PREFIX-###
  3. 已棄用的代碼觸發警告
  4. 已移除的代碼被拒絕

擴展指引

組織可以使用自訂代碼擴展字典:

擴展前綴:

X-<ORG>-<DIM>-<TOKEN>

範例:X-ACME-UC-901 用於 ACME 公司的自訂使用案例代碼。

擴展規則:

  1. 自訂代碼不得與標準代碼衝突
  2. 自訂代碼應記錄在本地擴展字典中
  3. 與外部方交換證據時,僅使用標準代碼

下載

請參閱發布了解包含字典和相關檔案的可下載套件。

相關頁面