aqueduct
Skill2 starsChanged 32 days agoMITView on GitHub
Aqueduct 数据开发自动化框架调用入口。 DO trigger when 用户提到"数据开发"、"SQL开发"、"数仓开发"、"数据管道"、 "表结构设计"、"数据质量测试"、"DA设计"、"aqueduct"、"需求转SQL"、"ETL开发"。 默认路由到 /data-developer(插件直接生成模式),除非用户明确要求 CLI 管道模式。 Do NOT trigger for 仅查询数据血缘/上下游依赖、仅查询现有API/数据源/离线任务详情、 讨论非数仓相关的通用编程问题。
In this repository5 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- aqueduct-devSkill
- aqueduct-reviewSkill
- change-managementSkill
- data-developerSkill
The file
Files
Aqueduct 框架调用技能
用于调用 aqueduct Python 框架,执行数据仓库开发全流程。
本 Skill 是 Claude Code 与 aqueduct 框架的桥接层。 所有实际工作(线性管道编排、校验引擎、模板生成、数据模型)由 aqueduct Python 代码完成。 Claude Code 提供:LLM 智能、MCP 工具(查表结构)、文件读写能力。
参考文档
- 架构参考 — 分层架构、模块说明、CLI 命令
工作模式
| 模式 | 触发方式 | 流程 |
| 开发模式 | aqueduct dev 需求文档 | Phase 1→6 全流程 |
| 审查模式 | aqueduct review 线上.sql 变更.sql | Phase 4.5→6 |
| 单步校验 | aqueduct validate SQL文件 | 仅校验 SQL 规范 |
工作流概览
详细工作流请参考 /data-developer 技能,或直接执行:
# 开发模式 — 从需求文档到完整交付
aqueduct dev <requirement.md>
# 审查模式 — 校验 SQL 变更
aqueduct review <online.sql> <changed.sql>
# 单步校验 — 检查 SQL 规范
aqueduct validate <sql_file> [--strict]
# 项目状态
aqueduct status框架架构
| 组件 | 职责 | 文件 |
| LLM 层 | 多模型路由(Haiku/Sonnet/Opus 三档分工) | src/aqueduct/llm/ |
| Tools 层 | 9 个原子工具(校验、血缘、成本、DQC 等) | src/aqueduct/tools/ |
| Skills 层 | 7 大业务 Skill + Prompt 模板解耦 | src/aqueduct/skills/ |
| Engine 层 | 线性管道编排(开发/审查双模式 + 审查修复循环) | src/aqueduct/engine/ |
| Memory 层 | 本体模型知识库 + 自动召回 | src/aqueduct/memory/ |
| MCP 层 | 标准 MCP 接口(可对接任何数据平台) | src/aqueduct/mcp/ |
交付物清单
| 文件 | 用途 | 阶段 |
| Phase1-需求理解摘要.md | 需求解析与问题清单 | Phase 1 |
| Phase2-设计方案.md | 取数逻辑与字段映射 | Phase 2 |
| Phase3-表结构.sql | 目标表 DDL 定义 | Phase 3 |
| Phase4-{需求名}.sql | 核心 ETL 逻辑 | Phase 4 |
| Phase4-SQL校验报告.md | SQL 语法/逻辑/场景覆盖校验 | Phase 4 |
| Phase4-成本预警.md | 数据量预估与优化建议 | Phase 4 |
| Phase4-字段级血缘图.md | Mermaid 血缘拓扑图 | Phase 4 |
| Phase5-{需求名}_审查报告.md | 代码审查结果 | Phase 4.5 |
| Phase5-数据质量测试.sql | DQC 测试用例 | Phase 5 |
| Phase5-质量仪表盘.md | 数据质量测试结果看板 | Phase 5 |
| Phase5-DQC执行报告.md | DQC 测试执行结果报告 | Phase 5 |
| Phase6-Design.md | 完整设计文档 | Phase 6 |
| Phase6-交付总报告.md | 项目交付总报告 | Phase 6 |
| Phase6-知识沉淀.md | 业务规则与编码约定沉淀 | Phase 6 |
| knowledge/domains/{domain_id}.json | 语义模型(新业务域时创建) | Phase 6 |
用户通过 .mcp.json 配置自己的数据平台,无需修改代码。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

