Agent Skills
› MapleTechLabs/maple
MapleTechLabs/maple
GitHub提供ClickHouse架构设计决策支持，根据工作负载类型选择数据摄入或建模模式，并附带官方文档引用和建议溯源分类。
Install All Skills
npx skills add MapleTechLabs/maple --all -g -y
Skills in Collection (35)
提供ClickHouse架构设计决策支持，根据工作负载类型选择数据摄入或建模模式，并附带官方文档引用和建议溯源分类。
需要设计ClickHouse系统架构
选择数据摄入或建模策略
基于特定工作负载进行系统优化
npx skills add MapleTechLabs/maple --skill clickhouse-architecture-advisor -g -y
提供ClickHouse模式、查询和配置的28条最佳实践规则，用于审查和优化数据库设计。
审查ClickHouse表结构或配置
优化ClickHouse查询性能
npx skills add MapleTechLabs/maple --skill clickhouse-best-practices -g -y
指导用户通过 clickhousectl CLI 将 ClickHouse 部署至 ClickHouse Cloud，涵盖账户注册、CLI 认证（OAuth/API Key）、服务创建及连接应用等全流程。
部署 ClickHouse 到云环境
迁移本地 ClickHouse 到 Cloud
创建托管 ClickHouse 服务
npx skills add MapleTechLabs/maple --skill clickhousectl-cloud-deploy -g -y
指导用户通过 clickhousectl 工具从零搭建本地 ClickHouse 开发环境，涵盖安装 CLI、初始化项目结构、启动服务及创建表结构等全流程。
需要搭建本地 ClickHouse 开发环境
安装和配置 ClickHouse 服务器
npx skills add MapleTechLabs/maple --skill clickhousectl-local-dev -g -y
提供COSS UI组件库的粒子示例索引，辅助开发者快速查找并复制粘贴可用的UI模式，加速前端界面开发。
需要实现特定UI组件
寻找现成的UI代码片段
npx skills add MapleTechLabs/maple --skill coss-particles -g -y
辅助正确实现 coss UI 组件，涵盖选择基元、编写代码、迁移及故障排除，确保符合文档规范与无障碍标准。
构建 coss UI 组件
从 shadcn/Radix 迁移到 coss
解决 coss 组件行为问题
npx skills add MapleTechLabs/maple --skill coss -g -y
React代码质量检查工具，扫描安全、性能及架构问题并输出健康评分。适用于提交前回归检测或全量代码清理，辅助开发者修复错误与警告。
完成功能开发后
修复Bug后
提交React代码前
需要提升代码质量时
npx skills add MapleTechLabs/maple --skill react-doctor -g -y
提供Tinybird CLI工具的使用指南，涵盖本地开发、分支管理、构建部署、CI/CD配置及数据操作等全流程规范，辅助开发者高效使用tb命令。
运行 tb 相关命令
配置或执行 CI/CD 流水线
进行 Tinybird 项目的本地或云端部署
管理 Tinybird 数据源与令牌
npx skills add MapleTechLabs/maple --skill tinybird-cli-guidelines -g -y
提供Tinybird Python SDK的使用指南，涵盖数据源、管道和查询的定义、客户端创建、连接配置及CLI命令（dev/build/deploy/migrate）的应用场景与最佳实践。
使用tinybird-sdk定义数据资源
运行tinybird CLI命令
Python项目中的数据摄入或查询开发
npx skills add MapleTechLabs/maple --skill tinybird-python-sdk-guidelines -g -y
提供Tinybird TypeScript SDK的使用指南，涵盖数据源、管道定义及类型安全查询。指导安装配置、CLI命令运行及资源迁移，确保在TypeScript项目中实现完整类型推断与规范开发。
使用@tinybirdco/sdk进行开发
定义Tinybird数据源或管道
运行Tinybird CLI构建部署
npx skills add MapleTechLabs/maple --skill tinybird-typescript-sdk-guidelines -g -y
提供Tinybird开发最佳实践，涵盖数据源、管道、端点及物化视图的SQL编写、优化模式与文件规范。指导资源创建、查询优化、数据建模及项目结构组织，适用于Tinybird项目的开发与重构。
创建或更新Tinybird资源文件
编写或优化SQL查询
设计端点架构和数据模型
审查或重构Tinybird项目
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提取文档及审查公共API文档。
添加或修复JSDoc注释
解决jsdocs诊断问题
准备JSON提取的文档
审查公共API文档
npx skills add MapleTechLabs/maple --skill jsdocs -g -y
从源码 JSDoc 示例中提取代码并生成 TypeScript 文件至 scratchpad，支持自动适配 Effect 运行器。适用于用户需要快速复制、尝试或调试特定代码片段时。
用户要求提取或复制源码中的 JSDoc 示例
用户希望将当前光标位置的代码示例保存为可运行的 TS 文件
npx skills add MapleTechLabs/maple --skill scratchpad -g -y
用于扫描 React 代码库的安全性、性能、正确性和架构问题，生成健康评分。适用于提交前检查回归或整体代码清理优化，辅助提升代码质量。
完成功能开发后
修复 Bug 后
提交 React 代码前
需要提升代码质量时
npx skills add MapleTechLabs/maple --skill react-doctor -g -y
用于构建和编辑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
npx skills add MapleTechLabs/maple --skill maple-audit -g -y
提供 .NET/C# 项目中集成 OpenTelemetry 的标准配置模板，支持通过 OTLP HTTP 协议将 Trace、Metric 和 Log 数据导出至 Maple 平台。
需要为 .NET 应用添加可观测性
配置 OpenTelemetry 导出器
初始化 ASP.NET Core 遥测
npx skills add MapleTechLabs/maple --skill maple-csharp-style -g -y
为 Effect-TS 应用提供 Maple OpenTelemetry 集成，支持 Server、Browser 及 Cloudflare 环境的自动配置与日志追踪。
Effect-TS 项目需要接入 OpenTelemetry 追踪
配置不同运行时的遥测数据导出
npx skills add MapleTechLabs/maple --skill maple-effect-style -g -y
提供Go语言OpenTelemetry集成配置，自动初始化Traces、Logs和Metrics的HTTP导出器，支持Maple平台端点与密钥内联，并注入VCS资源属性。
需要为Go应用配置OpenTelemetry遥测数据
需将Trace/Log/Metric发送至Maple平台
npx skills add MapleTechLabs/maple --skill maple-go-style -g -y
提供基于 OpenTelemetry 的 Java 可观测性集成指南，支持零代码 Agent 自动插桩和手动 SDK 配置，涵盖 Traces、Logs 和 Metrics 向 Maple 平台发送及资源属性设置。
Java 应用集成 OpenTelemetry
配置 JVM Agent 进行零代码监控
手动添加 OTLP Exporter SDK
Java 日志与链路追踪桥接
npx skills add MapleTechLabs/maple --skill maple-java-style -g -y
提供Kotlin应用集成OpenTelemetry的零代码Java Agent和手动SDK方案，支持自动插桩与OTLP导出。
需要为Kotlin/Spring Boot/Ktor项目添加可观测性
配置OpenTelemetry Java Agent或SDK
npx skills add MapleTechLabs/maple --skill maple-kotlin-style -g -y
提供Next.js/Vercel应用接入Maple可观测性的标准配置，涵盖OTel引导、Anthropic LLM集成及原生API使用，修复EU区域及LLM成本统计缺陷。
需要为Next.js应用配置OpenTelemetry
集成Maple可观测性服务
处理EU区域或LLM相关的遥测数据
npx skills add MapleTechLabs/maple --skill maple-nextjs-style -g -y
提供 Node.js 应用集成 OpenTelemetry 的标准配置模板，支持 Trace、Log、Metric 自动采集与 OTLP 导出。
需要为 Node.js 项目添加可观测性
配置 OpenTelemetry SDK 和导出器
设置服务资源属性和自动插桩
npx skills add MapleTechLabs/maple --skill maple-nodejs-style -g -y
将项目接入Maple遥测平台，通过OpenTelemetry集成全仓库应用的Trace、Log和Metric。支持多语言栈及EU/US区域配置，自动处理密钥内联与引导代码生成。
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 创建业务 Span、命名及配置端点密钥。修复 EU 区域支持、LLM 指标及安装流程缺陷。
OpenTelemetry 监控接入
Trace/Span 代码生成
可观测性配置
npx skills add MapleTechLabs/maple --skill maple-onboarding-style -g -y
定义 Maple Python 项目中使用 OpenTelemetry 进行分布式追踪、指标收集和日志关联的编码规范，涵盖模块级初始化、装饰器/上下文管理器使用及错误处理。
需要为 Python 代码添加 OpenTelemetry 监控支持
询问如何正确配置 Trace、Meter 和 Logger
npx skills add MapleTechLabs/maple --skill maple-python-style -g -y
提供 Maple Rust 项目的基础设施配置，集成 OpenTelemetry 进行链路追踪、日志和指标采集，支持 HTTP 导出及 tracing 桥接。
Rust 项目初始化
需要添加 OpenTelemetry 监控
npx skills add MapleTechLabs/maple --skill maple-rust-style -g -y
提供兼容 Pandas API 的高性能数据操作能力，支持连接多种数据库和云存储，加速数据分析与跨源查询。
需要加速 Pandas 数据处理
分析本地文件或远程数据库
执行跨源数据关联查询
npx skills add MapleTechLabs/maple --skill chdb-datastore -g -y
提供Python进程内ClickHouse SQL引擎，支持直接查询本地文件、远程数据库及云存储。无需服务器即可执行SQL查询、跨源连接及高级分析功能，适用于数据探索与轻量级ETL场景。
需要直接在Python中运行ClickHouse SQL语法
对Parquet/CSV等文件进行SQL查询
通过SQL连接MySQL/S3/PostgreSQL等外部数据源
构建无服务器的状态分析管道
npx skills add MapleTechLabs/maple --skill chdb-sql -g -y
定义Maple项目跨语言的OpenTelemetry规范，涵盖自定义属性键、状态码格式及资源属性。用于指导代码编写、审查及OTLP配置，确保遥测数据兼容Tinybird MV和仪表盘。
编写或审查涉及OpenTelemetry插桩的代码
配置OTLP导出器或Tracer Provider
添加新的span属性或设置span状态
npx skills add MapleTechLabs/maple --skill maple-telemetry-conventions -g -y
专注于优化新用户注册后的激活流程，帮助用户快速体验核心价值（Aha Moment）。涵盖首次运行体验设计、空状态处理、引导清单及进度展示，旨在降低流失率并提升长期留存。
优化注册后引导流程
提升用户激活率
改善首次使用体验
缩短价值实现时间
解决用户注册后不活跃问题
npx skills add MapleTechLabs/maple --skill onboarding-cro -g -y
指导Agent通过MCP构建、修复或审查Maple仪表盘组件。涵盖面板类型、数据源结构、单位规则及验证流程，确保Widget JSON正确生成与渲染。
create_dashboard
add_dashboard_widget
update_dashboard_widget
dashboard widget JSON
panel_type
npx skills add MapleTechLabs/maple --skill maple-dashboard-widgets -g -y
基于 OpenTelemetry 规范 v1.58.0，审查代码差异、PR 或文件是否符合 OTel 规范。识别 MUST/SHOULD 违规项并提供引用，覆盖 OTLP 服务端、SDK 自监控及数据消费场景。
检查 PR 或 diff 的 OTel 规范合规性
验证部分成功处理逻辑
确认重试状态码配置
审查 OTLP 服务端表面变更
检查自 instrumentation 实现
npx skills add MapleTechLabs/maple --skill maple-otel-spec-review -g -y
