runtime-guide

name	runtime-guide
description	提供数据分析任务执行的强制性通用规范。在计划完成准备执行数据分析任务、或执行过程中涉及产物落盘、数据复用、异常处理、计划调整、质量自检时，必须优先调用此技能。

runtime-guide

---

1. 产物落盘规范

1.1 工作目录

每次执行都使用 QwenPaw Data runtime 指定的当前产物目录。本文用 <current_artifacts> 表示：

普通对话：       <workspace>/artifacts/<session_id>
TaskGraph 节点： <workspace>/artifacts/<session_id>/<graph_id>/<node_id>

当前执行目录内结构如下：

<current_artifacts>/
├── plan.yaml                 # 原始 plan（来自 planner，不修改）
├── plan_v1.yaml              # 第一次修改后的 plan（如有）
├── plan_v2.yaml              # 第二次修改后的 plan（如有）
├── steps/                    # 步骤结果（每步完成后写入）
├── data/                     # 数据产物
│   ├── raw/                  # 原始获取的数据（从数据源拉取的原始结果）
│   └── processed/            # 计算处理后的数据（衍生指标、数据清洗结果等）
└── result.yaml               # 最终结果（执行完成后写入）

• plan.yaml 是原始计划，始终保留不修改
• 执行过程中如需调整计划，生成 plan_v1.yaml、plan_v2.yaml... 按修改顺序递增
• 执行时始终以最新版本的 plan 为准
• session_id 必须使用 runtime 提供的当前值，不自行生成
• 仅当 runtime 明确提供当前 graph_id 和 node_id 时才使用节点子目录；普通 对话直接使用 session 目录
• 不在 workspace 根或未隔离的 artifacts/ 下创建任务目录

1.2 数据文件

类型	存放位置	命名
原始数据	<current_artifacts>/data/raw/	<数据描述>.<ext>
计算结果	<current_artifacts>/data/processed/	<分析内容>_<结果描述>.<ext>

• 文件命名应自描述，能看出内容是什么
• 列名/字段名须有业务含义（如 ），不使用