Agent Skills
› MapleTechLabs/maple
MapleTechLabs/maple
GitHubClickHouse架构设计顾问，基于工作负载类型提供决策框架和最佳实践，明确区分官方文档、逻辑推导及经验建议的来源。
安装全部 Skills
npx skills add MapleTechLabs/maple --all -g -y
集合内 Skills (35)
ClickHouse架构设计顾问，基于工作负载类型提供决策框架和最佳实践，明确区分官方文档、逻辑推导及经验建议的来源。
设计ClickHouse架构
选择数据摄入或建模模式
根据特定工作负载生成系统设计方案
npx skills add MapleTechLabs/maple --skill clickhouse-architecture-advisor -g -y
提供ClickHouse模式、查询及配置的审查规则，涵盖28条最佳实践，指导用户优化表结构设计与数据摄入。
审查ClickHouse表结构
优化ClickHouse查询语句
检查ClickHouse配置
npx skills add MapleTechLabs/maple --skill clickhouse-best-practices -g -y
指导用户使用clickhousectl工具完成ClickHouse Cloud的部署全流程，包括账号注册、CLI认证（OAuth或API Key）、服务创建及连接应用，适用于从本地迁移至云端或首次搭建托管服务的场景。
将ClickHouse应用部署到生产环境
将本地ClickHouse迁移至ClickHouse Cloud
在云上创建托管ClickHouse服务
npx skills add MapleTechLabs/maple --skill clickhousectl-cloud-deploy -g -y
指导用户从零开始在本地搭建 ClickHouse 开发环境，涵盖工具安装、实例初始化、服务启动及表结构创建等全流程操作。
需要在本地运行 ClickHouse 进行开发或测试
需要安装和配置 ClickHouse 服务器
npx skills add MapleTechLabs/maple --skill clickhousectl-local-dev -g -y
提供COSS UI组件库的粒子示例索引，帮助用户快速查找并获取可复制粘贴的前端UI模式源码，加速界面功能开发。
需要实现特定UI组件时
寻找现成的前端代码片段
npx skills add MapleTechLabs/maple --skill coss-particles -g -y
指导Agent正确使用coss UI组件库，涵盖组件选择、代码编写、从shadcn/Radix迁移及样式配置。
使用coss基础UI组件构建界面
将现有UI从shadcn或Radix迁移至coss
解决coss组件相关的行为或样式问题
npx skills add MapleTechLabs/maple --skill coss -g -y
用于扫描React代码库的安全、性能、正确性及架构问题，生成健康评分。支持对比变更检测回归或全面清理，辅助开发者在提交前修复错误并提升代码质量。
完成功能开发后
修复Bug后
提交代码前检查
希望提升代码质量时
npx skills add MapleTechLabs/maple --skill react-doctor -g -y
提供Tinybird CLI的使用指南，涵盖本地开发、部署、数据操作及CI/CD配置。指导用户正确执行tb命令，管理环境工作流，处理数据与密钥，确保开发与发布流程规范。
运行 tb 相关命令
配置 Tinybird 本地或云端开发环境
构建和部署项目
设置 CI/CD 流水线
进行数据追加或替换操作
npx skills add MapleTechLabs/maple --skill tinybird-cli-guidelines -g -y
提供Tinybird Python SDK的使用指南，涵盖数据源、管道和查询的Python定义、客户端创建、连接配置及CLI命令（如dev/build/deploy），支持从旧格式迁移。
使用 tinybird-sdk 进行开发
在 Python 中定义 Tinybird 资源
运行 tinybird CLI 命令
将旧版配置文件迁移至 Python
npx skills add MapleTechLabs/maple --skill tinybird-python-sdk-guidelines -g -y
提供Tinybird TypeScript SDK的使用指南，涵盖数据源、管道定义及类型安全查询。指导安装配置、资源定义、客户端创建及CLI命令使用，支持从旧格式迁移，确保TypeScript项目中的类型推断与开发部署流程规范。
使用@tinybirdco/sdk进行开发
在TypeScript中定义Tinybird数据源或管道
执行Tinybird CLI构建或部署命令
迁移至TypeScript风格的Tinybird配置
npx skills add MapleTechLabs/maple --skill tinybird-typescript-sdk-guidelines -g -y
提供Tinybird数据源、管道、端点及物化视图的SQL规则、优化模式与最佳实践，辅助创建、编辑和重构相关资源文件。
创建或更新Tinybird资源文件
编写或优化SQL查询
设计端点Schema和数据模型
npx skills add MapleTechLabs/maple --skill tinybird -g -y
通过逐层追问引导用户压力测试计划或设计，构建决策树以澄清目标、约束、风险及架构细节，最终达成共识并总结剩余风险与下一步行动。
用户希望压力测试计划
用户要求对设计进行深度拷问
用户提及 'grill me'
npx skills add MapleTechLabs/maple --skill grill-me -g -y
用于为Effect公共API编写、插入或更新符合jsdocs oxlint规则的JSDoc注释，解决诊断问题并准备JSON提取所需的文档。
修复JSDoc诊断错误
为公共API添加或更新注释
npx skills add MapleTechLabs/maple --skill jsdocs -g -y
从源码 JSDoc 示例中提取代码至 scratchpad 文件，支持 IDE 光标定位、自动处理 Effect 运行器及冲突命名，便于快速验证和调试。
用户要求复制或打开源码中的 JSDoc 示例
用户希望将当前选中区域的示例导出到 scratchpad
npx skills add MapleTechLabs/maple --skill scratchpad -g -y
用于扫描 React 代码库的安全、性能、正确性和架构问题，输出健康评分。适用于提交前检查回归或整体代码清理优化。
完成功能开发后
修复 Bug 后
提交 React 代码前
需要提升代码质量时
npx skills add MapleTechLabs/maple --skill react-doctor -g -y
指导Agent构建Maple可观测性仪表板。要求先通过测试工具验证数据查询有效性，再添加统计、表格或图表组件，确保可视化内容基于真实数据并处理空数据情况。
用户请求创建或编辑仪表盘
用户需要添加或修复仪表板组件
npx skills add MapleTechLabs/maple --skill dashboard-builder -g -y
用于排查告警、故障或性能异常的技能。通过结合链路追踪、日志和指标数据，定位根因并评估影响范围，辅助值班工程师进行应急响应与决策。
收到系统告警通知
服务出现错误率飙升
查询某功能变慢或失败的原因
检测到流量或资源使用异常
npx skills add MapleTechLabs/maple --skill incident-investigation -g -y
审计已接入 OpenTelemetry 的项目，对照 Maple 规范检查遥测配置完整性与正确性，识别缺失或错误项并生成报告，指导修复以完善服务地图和数据质量。
audit my instrumentation
check my telemetry
review my OTel setup
why is my service map missing edges
is my Maple instrumentation correct
npx skills add MapleTechLabs/maple --skill maple-audit -g -y
提供.NET/C#项目中OpenTelemetry的标准化集成指南，涵盖Trace、Metric和Log的配置与Bootstrap代码示例。
需要为.NET项目配置OpenTelemetry
询问如何集成OTLP导出器
npx skills add MapleTechLabs/maple --skill maple-csharp-style -g -y
提供基于Effect-TS的Maple可观测性SDK集成指南，涵盖Server、Browser及Cloudflare Workers环境的Bootstrap配置、Tracer层搭建与Span日志记录。
在Effect应用中集成OpenTelemetry
配置Maple遥测数据导出
设置跨平台（Node/Browser/CF）的Trace上下文
npx skills add MapleTechLabs/maple --skill maple-effect-style -g -y
为Go项目提供基于OpenTelemetry的Maple可观测性SDK初始化方案，集成Trace、Log、Metric的HTTP导出器及资源属性配置。
需要配置Go服务监控指标
初始化OpenTelemetry SDK
设置日志和链路追踪导出
npx skills add MapleTechLabs/maple --skill maple-go-style -g -y
提供Maple平台Java应用集成OpenTelemetry的指南，支持零代码Agent和手动SDK两种方式，实现分布式追踪、日志与指标采集。
需要为Java应用添加可观测性
配置OpenTelemetry Java Agent或SDK
npx skills add MapleTechLabs/maple --skill maple-java-style -g -y
提供Kotlin应用集成OpenTelemetry的规范，涵盖零代码Java Agent自动插桩与手动SDK配置，支持OTLP导出及业务Span定义。
需要为Kotlin项目配置分布式追踪
集成OpenTelemetry Java Agent或SDK
设置OTLP指标、日志和链路数据
npx skills add MapleTechLabs/maple --skill maple-kotlin-style -g -y
提供Next.js/Vercel环境下Maple OpenTelemetry的可观测性配置指南，涵盖框架入口集成、LLM提供者自动插桩及Route Handlers手动埋点规范。
需要为Next.js应用配置OpenTelemetry监控
需要在Vercel环境中接入Maple可观测性平台
需要实现Anthropic等LLM调用的自动追踪
npx skills add MapleTechLabs/maple --skill maple-nextjs-style -g -y
提供Node.js应用接入Maple可观测平台的标准化配置，支持Express/Fastify等框架。通过OpenTelemetry SDK自动采集Trace、Log和Metric，并指导如何在代码中手动创建Span与指标。
需要为Node.js项目配置OpenTelemetry遥测数据
询问如何集成Maple平台进行监控
npx skills add MapleTechLabs/maple --skill maple-nodejs-style -g -y
自动将项目接入Maple可观测性平台，通过在各服务中内联OpenTelemetry配置（端点与密钥），实现全仓库应用和微服务的Trace、Log及Metrics数据采集。
install Maple
set up Maple
add Maple telemetry
onboard this repo to Maple
instrument with OpenTelemetry for Maple
npx skills add MapleTechLabs/maple --skill maple-onboard -g -y
定义Maple项目OpenTelemetry接入规范，涵盖API使用、命名约定、端点配置及VCS属性注入，确保可观测性数据质量与一致性。
需要集成OpenTelemetry监控
编写遥测相关代码
配置OTEL导出器
npx skills add MapleTechLabs/maple --skill maple-onboarding-style -g -y
定义Maple平台Python项目的OpenTelemetry集成规范，涵盖模块级实例化、装饰器/上下文管理器使用、异常记录、OTLP日志关联及内联配置初始化。
需要遵循Maple Python风格指南
配置或集成OpenTelemetry可观测性组件
处理分布式追踪和日志关联
npx skills add MapleTechLabs/maple --skill maple-python-style -g -y
为Maple项目配置Rust OpenTelemetry标准，集成tracing与OTLP HTTP导出器，实现日志、指标和追踪的统一上报。
需要配置Rust项目的可观测性基础设施
集成OpenTelemetry到现有Rust代码库
npx skills add MapleTechLabs/maple --skill maple-rust-style -g -y
提供基于ClickHouse的高性能Pandas替代方案，支持16+数据源连接与跨源Join。适用于需加速数据分析、统一API处理多源数据或进行复杂数据处理的场景，非SQL管理工具。
需要加速pandas代码执行
使用pandas语法分析文件数据库
跨不同数据源进行数据关联查询
npx skills add MapleTechLabs/maple --skill chdb-datastore -g -y
提供Python进程内ClickHouse SQL引擎，支持直接查询本地文件、远程数据库及云存储。适用于执行SQL分析、跨源连接及构建状态分析管道，无需部署服务器。
需要在Python中直接运行ClickHouse SQL查询
对Parquet/CSV等文件或S3等云存储进行数据分析
使用ClickHouse特有语法如窗口函数或表函数
npx skills add MapleTechLabs/maple --skill chdb-sql -g -y
提供Maple项目语言无关的OpenTelemetry遥测规范，涵盖自定义属性键、状态码格式及资源属性。用于指导多语言代码中的指标埋点编写与审查，确保与Tinybird数据管道兼容。
编写或审查涉及OpenTelemetry埋点的代码
配置OTLP导出器或Tracer Provider
新增或修改span属性以适配Tinybird MV列
npx skills add MapleTechLabs/maple --skill maple-telemetry-conventions -g -y
专注于优化新用户注册后的引导流程、激活率和首次体验，帮助用户快速达成核心价值时刻（Aha Moment）以提升留存。
优化注册后引导流程
提升用户激活率
改善首次运行体验
减少新用户流失
npx skills add MapleTechLabs/maple --skill onboarding-cro -g -y
指导通过MCP构建、修复和审查Maple仪表盘组件，涵盖QueryDraft结构、自定义whereClause语法及数据源差异，并新增支持组件独立时间范围配置的功能。
create_dashboard
add_dashboard_widget
update_dashboard_widget
dashboard widget JSON
QueryDraft
trace dashboard widget
npx skills add MapleTechLabs/maple --skill maple-dashboard-widgets -g -y
基于本地快照的OpenTelemetry规范，审查代码变更或PR是否符合OTel规范。通过路由表匹配代码触及面，引用规范原文判定MUST/SHOULD违规项，输出包含严重等级的合规性发现。
检查代码是否符合OTel规范
审查PR与OTel规范的兼容性
验证部分成功处理逻辑
确认重试状态码正确性
检查OTLP服务器表面变更
npx skills add MapleTechLabs/maple --skill maple-otel-spec-review -g -y
