impact-analysis

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Impact Analysis

影响分析

Assess the impact of modifying or removing a configuration on a Datex Studio branch. This skill analyzes dependencies only — it does not make changes.

评估修改或移除Datex Studio分支中配置所产生的影响。本技能仅分析依赖关系——不进行任何修改。

When to Use

适用场景

Before modifying input/output parameters of any config
Before removing a config from a branch
When a calling skill (e.g.,
```
function-creator
```
,
```
datasource-creator
```
) needs to verify that a contract change is safe

修改任何配置的输入/输出参数之前
从分支中移除配置之前
当调用技能（如
```
function-creator
```
、
```
datasource-creator
```
）需要验证契约变更是否安全时

Workflow

工作流程

Step 1: Find callers

步骤1：查找调用者

bash

dxs source explore reverse-trace <reference_name> --branch <branch_id>

This returns all configs that reference the target. Use

--type <type>

to speed up lookup if the config type is known (e.g.,

--type flow

--type datasource

bash

dxs source explore reverse-trace <reference_name> --branch <branch_id>

该命令会返回所有引用目标配置的配置项。若已知配置类型，可使用

--type <type>

参数加快查找速度（例如

--type flow

、

--type datasource

）。

Step 2: Interpret results

步骤2：解读结果

Categorize referencing configs by type:

Flows / Functions — call the target via
```
$flows.*
```
Datasources — reference via
```
$datasources.*
```
Forms / Grids / Editors — UI components that bind to the target
Reports — reference via
```
$reports.*
```

按类型对引用配置进行分类：

流程/函数 —— 通过
```
$flows.*
```
调用目标配置
数据源 —— 通过
```
$datasources.*
```
引用目标配置
表单/表格/编辑器 —— 绑定到目标配置的UI组件
报表 —— 通过
```
$reports.*
```
引用目标配置

Step 3: Decision gate

步骤3：决策检查

No callers found — safe to proceed. Inform the calling skill/user.
Callers exist — present the full list to the user with:
- Each caller's reference name and type
- What would break (e.g., "these 3 flows call fn_sum with 2 args — changing to 3 args will break them")
- Ask for explicit confirmation before proceeding

未找到调用者 —— 可安全执行操作。通知调用技能/用户。
存在调用者 —— 向用户展示完整列表，包含：
- 每个调用者的引用名称和类型
- 变更会导致的问题（例如：“这3个流程使用2个参数调用fn_sum——改为3个参数会导致它们失效”）
- 执行操作前需获取用户明确确认

Step 4: Return to caller

步骤4：反馈给调用者

Report the decision back to the calling skill:

Safe — no callers, proceed with changes
Approved — callers exist but user approved; the calling skill must update all affected callers as part of the change
Rejected — user decided not to proceed

将决策结果反馈给调用技能：

安全 —— 无调用者，可执行变更
已批准 —— 存在调用者但用户已批准；调用技能必须在变更过程中更新所有受影响的调用者
已拒绝 —— 用户决定不执行操作

Additional Commands

额外命令

Command	When to use
`dxs source explore trace <name> --branch <id>`	Understand what the target depends on (forward dependencies)
`dxs source explore graph <name> --branch <id>`	Visualize the full dependency chain (both directions)

命令	使用场景
`dxs source explore trace <name> --branch <id>`	了解目标配置依赖的对象（正向依赖）
`dxs source explore graph <name> --branch <id>`	可视化完整依赖链（双向）

Scope Boundaries

范围边界

This skill analyzes only — it never modifies configs
The calling skill is responsible for updating affected callers
Reference name changes are not covered — they require delete + recreate and should be flagged to the user as a manual operation

本技能仅负责分析——绝不修改配置
更新受影响调用者的责任由调用技能承担
引用名称变更不在本技能覆盖范围内——此类操作需要删除+重新创建，应向用户标记为手动操作