BigQuery 资产影响分析
评估 BigQuery 表或视图变更后的下游影响范围。
证据显示该技能主要执行只读的血缘查询，明确禁止绕过工具、避免猜测资产名称，并要求披露搜索参数；但未规定最小 IAM 权限、敏感数据处理、用户确认、远程数据流、失败后的恢复或回滚，因此扣分。
工作流从 FQN、位置发现到血缘遍历和输出格式基本一致，且说明权限或工具失败时应提示用户；但没有测试或执行证据，区域配置依赖外部 MCP 定义，并错误地要求将空响应立即解释为无依赖，边界和异常反馈不足，因此扣分。
描述、适用场景和不适用场景清晰，输入 FQN、搜索方向及深度参数也有说明；但依赖 Google Cloud Data Lineage MCP、bq 和可用凭据，未说明中文交互能力或中国大陆网络可达性，也未充分界定数据权限和支持范围，因此扣分。
文档结构清楚，包含前置条件、引用目录、参数说明、示例格式，仓库 README 提供 Apache-2.0、安装方式、官方组织来源和支持入口；但缺少技能版本、变更日志、明确维护责任人、更新路径、FAQ 和系统化故障排查，因此扣分。
目标输出包括执行摘要、关键路径、完整依赖表和分析元数据，能够直接支持影响评估；但静态材料没有验证实际结果，且结果依赖外部血缘覆盖范围、权限和区域配置，空结果解释也可能造成误判，因此未超过静态上限并扣分。
材料提供固定修订上下文、源文件、引用文档和明确参数，具备有限审计性；但没有提交的测试套件、CI 覆盖、运行记录或多来源实证，无法静态复现关键路径，因此扣分。
- 必须先验证 bq 和 MCP 的权限、项目计费/用户项目配置及区域一致性；技能未定义最小 IAM 权限。
- 不要把空的或权限受限的血缘响应直接当作“无依赖”，应区分无结果、权限不足、区域错误和服务失败。
- 该技能未提供敏感数据脱敏、远程 MCP 数据流说明、用户确认或回滚方案。
- 核心功能依赖 Google Cloud Data Lineage MCP、Google 凭据和外部服务；未证明中文支持或中国大陆网络可达性。
这个 Skill 能做什么，适合哪些场景？
此技能用于分析 BigQuery 表或视图损坏、过期、缺失或计划维护时的下游影响。它通过 Google Cloud Data Lineage MCP Server 查询资产关系，识别受影响的下游表、仪表板和流程。技能会区分直接与间接影响，并检查传播数据的 ETL 流程、视图或定时查询。它适合已经使用 Google Cloud 数据血缘服务、需要变更风险评估的团队。
它先确认 BigQuery 资产的完全限定名称，格式为 bigquery:{project_id}.{dataset_id}.{table_or_view_id}。随后运行 bq show --format=json {project_id}:{dataset_id} 获取数据集位置，并结合 MCP Server 的位置构造 Data Lineage API 的父路径。它调用 DataLineageServer:search_lineage，以 DOWNSTREAM 方向、最大深度 10、每条关系最多 5 个流程查询下游关系。最后整理受影响资产、转换流程、深度、影响类型、关键路径以及搜索参数。
- 数据工程师准备修改生产 BigQuery 表，需要确认哪些下游表和流程会受到影响。
- 数据平台团队发现 BigQuery 表数据过期，希望定位可能出现级联问题的仪表板和报表。
- 运维人员计划暂停某个 BigQuery 资产的更新，需要评估业务影响范围。
- 分析师或数据治理人员需要查看某个 BigQuery 表或视图的直接和间接下游依赖。
这个 Skill 有哪些优点和局限？
- 专门针对 BigQuery 表和视图的下游影响分析。
- 能够区分直接影响、间接影响和 EXACT_COPY 导致的直接陈旧副本。
- 输出包含资产、传播流程、深度和搜索边界，便于审查结果。
- 提供空响应、资产不存在和禁止绕过血缘查询等明确护栏。
- 依赖 Google Cloud Data Lineage API、Data Lineage MCP Server 和 bq CLI。
- 源材料没有提供 MCP Server 配置细节，也没有展示测试套件或验证结果。
- 不适用于一般 BigQuery 查询、非 BigQuery 资产或直接创建和修改血缘关系。
- 分析范围受查询位置、最大深度和每条关系流程数量限制。
如何安装这个 Skill？
该技能位于 skills/cloud/datalineage-bigquery-asset-impact-analysis/SKILL.md。安装整个仓库并在安装过程中选择具体技能：npx skills add google/skills。源材料没有提供单独安装此技能或配置 Data Lineage MCP Server 的完整命令；使用前还需要 Google Cloud Data Lineage API 访问权限和有效的 MCP Server 客户端连接。
如何使用这个 Skill？
向已加载该技能的代理提供 BigQuery 资产，例如：分析 bigquery:my-prod-project.analytics.orders 被修改后的下游影响范围。代理需要使用正确的项目、数据集和表或视图名称；如果无法通过 bq show 获取位置，应提供数据集位置。分析结果应包含受影响资产总数、最大影响深度、关键路径、完整依赖表和搜索元数据。