SuperAPI AI 工具集

hex-reference-architecture

设计与创作

查看项目

更新于 10-15 23:26

技能介绍

用途:该技能用于实现 Hex 参考架构,适用于设计新的 Hex 集成、审查项目结构或建立最佳实践项目布局。

主要能力:给出分层架构,包括编排层(Airflow、Dagster、GitHub Actions、Cron、自定义 API)、Hex API 客户端(Run、Poll、Cancel、List)以及 Hex 平台(Projects 与 Data Connections,如 Snowflake、BigQuery、Postgres)。提供项目结构示例 hex-orchestrator/,含 src/hex/client.ts、orchestrator.ts、scheduler.ts、types.ts,src/notify/slack.ts,tests/、config/pipelines.json 与 .env.example。列出集成模式:CI 触发刷新用 GitHub Actions,定时管道用 Cron/Airflow,按需运行用 API 端点,编排式管道用 Airflow/Dagster。

使用方式:先明确每个数据源的项目/数据负责人、环境允许列表、密钥管理器及每条执行边的负责人;分离 sandbox/staging/production 配置并支持回滚。映射每条触发到项目的边,包含负责人、数据分级、允许参数、授权范围、重试行为、可观测性与回滚。从 sandbox 项目开始,对未知项目、参数模式、目标或响应形状采取失败关闭。异步执行需幂等且有界,不确定时隔离而非重提交。先对一个项目做金丝雀并保留上一版本。输出架构记录,含负责人、不透明项目 ID、策略版本、幂等/重试行为、可观测性、测试证据与回滚版本,排除 SQL、输出、凭据与身份。

限制:资料未提供具体收费、价格、平台支持范围或效果数据;错误处理要求遇到未知范围/目标、脱敏失败、非幂等重试或授权漂移时停止并隔离事件,而非添加宽泛回退。