alm-integration（DOORS / Polarion / Jira）

重要技能

alm-integration 是超大 skill，汽车行业需求追溯的主力技能。它采用 adapter 模式统一封装多种 ALM 后端，对 Agent 暴露一致的操作接口。

能力总览

维度	覆盖范围
支持后端	IBM DOORS Next（M1 级完整）、Polarion、禅道、Jira、飞书多维表
暴露工具	4 个 tool × 40+ action
操作对象	需求 / 架构 / 设计 / 测试 / 安全分析 / 变更 / 缺陷
典型任务	CRUD、追溯建立、ReqIF 导出、基线快照、变更影响分析
特色	文件夹原子操作、高吞吐 Reportable 拉取

4 个核心 Tool

Rendering diagram…

Tool	职责	典型 action
`alm_query`	查询	`list_items` / `get_item` / `describe_adapter` / `list_folders` / `get_baseline`
`alm_mutate`	修改	`create_item` / `update_item` / `delete_item` / `create_folder` / `create_baseline`
`alm_link`	追溯链接	`create_link(satisfies/derivedFrom/verifies)` / `list_links` / `batch_link`
`alm_export`	导出	`export_reqif` / `export_reportable_rest` / `export_docx`
`alm_bind_credential`	凭据绑定	`bind_doors` / `bind_jira` / `bind_polarion`

支持的 Item 类型

类型	示例
Stakeholder Requirement	利益相关方需求
System Requirement	系统需求
Software Requirement	软件需求
Architecture	架构元素（模块、接口、信号）
Design	详细设计元素
Test Case	测试用例
Test Procedure	测试过程
Safety Analysis	DFA / FMEA / HAZOP
Change Request	变更请求
Defect	缺陷单

追溯链接类型

链接	方向	ASPICE 含义
`satisfies`	下层 → 上层	下层对象满足上层需求
`derivedFrom`	下层 → 上层	派生自
`refines`	下层 → 上层	精化
`verifies`	测试 → 需求	验证
`validates`	测试 → 需求	确认
`implements`	代码 → 设计	实现

典型工作流

工作流 1：从需求拉取到 ReqIF 导出

alm_query(action="list_items", source="doors", folder_id="SWE.1")
   ↓ 拿到需求列表
alm_query(action="get_item", source="doors", item_id=...)
   ↓ 单条详情
alm_export(action="export_reqif", source="doors", folder_id="SWE.1")
   ↓ 输出 ReqIF 文件给供应商

工作流 2：批量建立追溯链接

alm_query(action="list_items", source="doors", type="Test Case")
   ↓ 测试用例列表
alm_link(action="batch_link",
    links=[{source_id, target_id, type: "verifies"}, ...])
   ↓ 一次性建立 N 条 verifies 关系

工作流 3：基线比对（配合 graft）

Rendering diagram…

见 ASPICE 案例场景二。

错误码对照

错误码	retryable	类型	处理
`auth_expired`	false	permanent	adapter 先尝试重登录，仍失败则报告用户
`not_configured`	false	permanent	指定 source 没有注册 adapter
`unsupported_action`	false	permanent	adapter 不支持该 action，看 `describe_adapter` 返回的 capabilities
`unsupported_item_type`	false	permanent	adapter 不支持该 item type

特色能力

文件夹原子操作

DOORS 的文件夹操作（移动、重排）在多用户并发时容易冲突。alm-integration 使用乐观锁 + 补偿事务保证原子性。

高吞吐 Reportable REST 拉取

DOORS 对大量 item 的拉取有性能瓶颈，alm-integration 通过 Reportable REST 接口做批量拉取，吞吐较单条查询高 10–50 倍。

ASPICE 合规保障

作为 automotive-process-analyzer 发现合规问题后的首选修复工具。

触发方式

/alm-integration 导出 SWE.1 文件夹下所有需求为 ReqIF

自然语言示例：

"写一个需求到 DOORS"
"建立从测试到需求的追溯矩阵"
"ReqIF 导出给供应商"
"变更影响分析"
"创建基线快照"
"批量建立 satisfies 链接"
"看 DOORS folder 树"

不适用：一般知识问答、与 ALM 无关的工单系统（如售后单）。