用途:将 Snowflake Quickstart 链接转化为引导式互动学习体验。触发条件:用户输入匹配 https://www.snowflake.com/en/developers/guides/<slug> 或旧版 https://quickstarts.snowflake.com/guide/<slug>,或说“带我走一遍某 Quickstart”。
主要能力与流程:1) 从 URL 提取 slug,并兼容连字符/下划线变体;2) 从 GitHub 仓库 Snowflake-Labs/sfquickstarts 的 site/sfguides/src/<folder>/ 获取 markdown,通过 GitHub API 列出目录、读取 download_url,校验 frontmatter 的 id 是否与 slug 一致,失败时回退抓取原 URL;3) 解析元数据、前置条件、阶段、代码块与最终产物,计划 4-8 个阶段;4) 检测配套仓库,让用户选择克隆或按需引用,含“等待选择”停止点;5) 运行轻量诊断,如 SELECT CURRENT_ORGANIZATION_NAME(), CURRENT_ACCOUNT_NAME(), CURRENT_ROLE(), CURRENT_WAREHOUSE(), CURRENT_DATABASE(), CURRENT_USER(); 和 SHOW GRANTS TO ROLE <current_role>; 对照需求给出缺口与修复语句;6) 介绍产物并让用户在 Learner 模式(逐步执行、阶段间暂停)或 Builder 模式(一次构建、末尾总结)中选择;7) 按执行面(/workspace/ 视为 Snowsight,否则 CLI)执行各阶段,遇过时语法提示现代做法,出错则诊断修复;8) 总结并询问保留或清理,清理用 DROP SCHEMA IF EXISTS LEARN_SNOWFLAKE_QUICKSTARTS.<slug_as_identifier> CASCADE;,不删除 LEARN_SNOWFLAKE_QUICKSTARTS 数据库本身,也不删除或修改 Snowflake 提供的数据库。
适用场景:需要按官方 Quickstart 动手学习 Snowflake 的开发者与学习者。限制:依赖 GitHub 与网络抓取,获取失败需用户提供本地内容或替代 URL;部分阶段涉及外部依赖(如 Kafka、S3、第三方 API)时标记为可选;需用户具备相应角色与权限。具体定价、平台支持范围与效果资料未提供。