跳转至

代码

本页定义 AIMO 代码系统格式、命名约定和生命周期管理。

代码格式

所有 AIMO 代码遵循格式：<前缀>-<标记>

组件 描述 格式 示例
<前缀> 维度标识符 2个大写字母 FS, UC, DT
- 分隔符 连字符 -
<标记> 维度内的唯一标记 3位数字（零填充） 001, 002, 003

示例

  • FS-001 - 功能范围：最终用户生产力
  • UC-005 - 用例类别：代码生成
  • DT-004 - 数据类型：个人数据
  • CH-003 - 渠道：IDE 插件
  • IM-002 - 集成模式：SaaS 集成
  • RS-001 - 风险面：数据泄露
  • OB-001 - 结果/收益：效率
  • LG-001 - 日志/记录类型：请求记录

命名空间

AIMO 分类法使用8个维度命名空间：

ID 名称 前缀 代码数量
FS 功能范围 FS- 6
UC 用例类别 UC- 30
DT 数据类型 DT- 10
CH 渠道 CH- 8
IM 集成模式 IM- 7
RS 风险面 RS- 8
OB 结果/收益 OB- 7
LG 日志/记录类型 LG- 15

总计：8个维度下的91个代码

命名空间规则

  1. 前缀是固定的：两字母维度前缀（FS、UC 等）是永久的，永远不会改变。
  2. 零填充：标记始终是3位数字，零填充（例如 001 而非 1）。
  3. 顺序分配：新代码在维度内分配下一个可用编号。
  4. 不重用：已删除的代码永远不会重新分配给不同的含义。

稳定性规则

代码稳定性是审计可追溯性的关键原则。

ID 不可变性

  • 代码ID是不可变的 — 一旦分配，代码ID的含义永远不会改变
  • 像 UC-001 这样的代码在其整个生命周期中将始终表示"通用问答"
  • 如果含义需要改变，则创建新代码

不重用政策

  • 已弃用或已删除的代码永远不会重新分配给不同的含义
  • 这确保历史证据保持有效和可追溯
  • 示例：如果 UC-010 被弃用，新用例获得 UC-031（而非 UC-010）

删除前弃用

  • 代码必须在删除前至少标记为 deprecated 一个 MINOR 版本
  • 删除仅在 MAJOR 版本增量中发生
  • 详情请参阅 生命周期 部分

使用

必需维度

对于每个AI系统或用例，您必须从每个必需维度指定至少一个代码：

维度 选择 说明
FS 恰好1个 主要业务功能
UC 1个或多个 执行的任务类型
DT 1个或多个 数据分类
CH 1个或多个 访问渠道
IM 恰好1个 集成模式
RS 1个或多个 风险类别
LG 1个或多个 日志/记录类型

可选维度

维度 选择 说明
OB 0个或多个 预期收益（可选）

代码组合

记录AI系统时，来自多个维度的代码被组合。组合优先级确定列出代码时的顺序：

  1. FS（功能范围）
  2. UC（用例类别）
  3. DT（数据类型）
  4. CH（渠道）
  5. IM（集成模式）
  6. RS（风险面）
  7. OB（结果/收益）
  8. LG（日志/记录类型）

组合示例：

FS: FS-001
UC: UC-001, UC-002
DT: DT-002, DT-004
CH: CH-001
IM: IM-002
RS: RS-001, RS-003
OB: OB-001
LG: LG-001, LG-002

生命周期

状态值

状态 描述 验证器行为
active 当前有效并在使用中 接受
deprecated 仍然有效但计划删除 接受并警告
removed 不再有效；不要使用 拒绝

生命周期元数据字段

字典使用这些字段跟踪生命周期：

字段 必需 描述 示例
status 是 当前状态 active
introduced_in 是 添加代码的版本 0.1.0
deprecated_in 否 标记为弃用的版本 1.2.0
removed_in 否 删除的版本 2.0.0
replaced_by 否 替代代码 UC-015
backward_compatible 是 更改是否破坏现有使用 true

弃用规则

  1. 代码必须在删除前至少标记为 deprecated 一个 MINOR 版本
  2. 弃用的代码包含 deprecated_in 版本和 replaced_by（如适用）
  3. 删除仅在 MAJOR 版本增量中发生
  4. 弃用的代码在弃用期间保持有效以实现向后兼容

示例时间线：

版本 状态 操作
0.1.0 active 代码 UC-010 引入
1.2.0 deprecated 标记为弃用，replaced_by: UC-031
2.0.0 removed 验证器不再接受

版本控制

代码更改遵循 语义版本控制：

  • MAJOR：代码删除或破坏性更改
  • MINOR：添加新代码、弃用代码
  • PATCH：仅定义澄清（无结构更改）

向后兼容性

backward_compatible 字段指示更改是否破坏现有使用：

值 含义
true 使用此代码的现有证据仍然有效
false 现有证据可能需要更新（MAJOR 版本更改）

验证

验证器检查：

  1. 所有必需维度至少有一个代码
  2. 单选维度恰好有一个代码
  3. 所有代码存在于当前分类法字典中
  4. 代码格式匹配 <前缀>-<标记> 模式（例如 UC-001）
  5. 弃用的代码标记警告

请参阅 验证器 了解实现详情。

SSOT 参考

!!! info "事实来源" 权威定义是 source_pack/03_taxonomy/taxonomy_dictionary_v0.1.csv。本页是解释性的。有关更新工作流程，请参阅 本地化指南。

相关页面