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条具体检查项。用于在Schema设计、SQL优化和数据摄入阶段进行规范性审查与优化建议。
审查ClickHouse表结构或分区策略
优化ClickHouse SQL查询性能
评估ClickHouse数据导入配置
npx skills add MapleTechLabs/maple --skill clickhouse-best-practices -g -y
指导用户通过 clickhousectl 工具将 ClickHouse 部署至云端的完整流程，涵盖账户注册、CLI 认证（OAuth/API Key）、服务创建及数据迁移等步骤。
部署 ClickHouse 到云端
迁移本地 ClickHouse 到 ClickHouse Cloud
创建或配置托管的 ClickHouse 云服务
npx skills add MapleTechLabs/maple --skill clickhousectl-cloud-deploy -g -y
指导用户从零搭建本地 ClickHouse 开发环境，涵盖安装 clickhousectl、部署实例、初始化项目结构及创建表结构等全流程。
需要搭建本地 ClickHouse 开发环境
在本地安装和启动 ClickHouse 服务
npx skills add MapleTechLabs/maple --skill clickhousectl-local-dev -g -y
提供COSS UI粒子组件索引，用于快速查找和复制粘贴基于coss原语的UI模式，支持480种组件示例，加速前端界面开发。
需要实现特定UI功能
寻找可复用的UI组件模式
构建表单、对话框或导航等界面
npx skills add MapleTechLabs/maple --skill coss-particles -g -y
辅助正确实现 coss UI 组件，涵盖选择原语、编写代码、迁移 shadcn/Radix 及故障排除。提供文档参考与使用规范，确保可访问性与生产级模式。
构建包含按钮、对话框等原语的 UI
从 shadcn/Radix 迁移到 coss/Base UI
解决 coss 组件行为问题
npx skills add MapleTechLabs/maple --skill coss -g -y
用于扫描 React 代码库的安全、性能、正确性和架构问题，输出健康评分。适用于提交前检查回归或整体代码清理优化。
完成功能开发后
修复 Bug 后
提交代码前
用户希望提升代码质量
npx skills add MapleTechLabs/maple --skill react-doctor -g -y
提供Tinybird CLI工具的使用指南，涵盖本地开发、分支管理、构建部署及数据操作。用于指导tb命令执行、CI/CD配置、环境切换及Secrets管理，确保开发者遵循标准工作流与最佳实践。
运行 tb 相关命令
进行本地或云端部署
配置 CI/CD 流水线
管理 Tinybird 数据或密钥
npx skills add MapleTechLabs/maple --skill tinybird-cli-guidelines -g -y
提供Tinybird Python SDK的使用指南，涵盖资源定义、客户端创建、数据接入查询及CLI命令（dev/build/deploy），适用于Python项目中的数据管道开发与迁移。
使用tinybird-sdk定义datasources或pipes
运行tinybird dev/build/deploy命令
进行数据接入或查询开发
从旧版文件迁移到Python定义
npx skills add MapleTechLabs/maple --skill tinybird-python-sdk-guidelines -g -y
Tinybird TypeScript SDK 使用指南，提供数据源、管道和查询的类型安全定义方法。涵盖安装配置、CLI命令（dev/build/deploy）及资源定义规则，支持全类型推断。
安装或配置 @tinybirdco/sdk
在 TypeScript 中定义 datasources 或 pipes
创建类型安全的 Tinybird 客户端
运行 tinybird dev/build/deploy 命令
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 注释，涵盖生成、修复及审查场景。
添加或修复 JSDoc 注释
解决 jsdocs 诊断错误
准备 JSON 提取文档
审查公共 API 文档
npx skills add MapleTechLabs/maple --skill jsdocs -g -y
从 JSDoc 示例中提取代码至 scratchpad 目录生成 TypeScript 文件，支持自动适配 Runner 或保留原样，便于用户快速尝试和调试源码片段。
用户要求 dump、copy、open 或 try 源码中的示例
需要从当前光标位置提取 JSDoc Example
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
npx skills add MapleTechLabs/maple --skill maple-audit -g -y
提供 .NET/C# 项目集成 OpenTelemetry 的标准配置模板，涵盖 ASP.NET Core 的 Traces、Metrics 和 Logs 自动化采集与 OTLP 导出设置。
.NET 应用需要集成可观测性
配置 OpenTelemetry 追踪或指标
npx skills add MapleTechLabs/maple --skill maple-csharp-style -g -y
为基于 Effect-TS 的 Maple 应用集成 OpenTelemetry 遥测，提供 Node、Cloudflare Workers 和浏览器环境的标准化 Bootstrap 配置与日志追踪支持。
需要在 Effect 应用中集成 OpenTelemetry 链路追踪
配置 Maple 应用的遥测导出层
npx skills add MapleTechLabs/maple --skill maple-effect-style -g -y
提供Go语言OpenTelemetry集成规范，封装SDK初始化与HTTP导出器配置，实现Trace、Log、Metric的标准化采集与上报。
需要为Go服务添加可观测性支持
配置OpenTelemetry SDK及OTLP HTTP导出器
设置Trace/Log/Metric资源属性
npx skills add MapleTechLabs/maple --skill maple-go-style -g -y
提供Maple平台Java应用接入OpenTelemetry遥测数据的标准化指南，支持零代码Agent自动注入及手动SDK集成，涵盖Traces、Logs和Metrics的OTLP HTTP导出配置。
Java应用需要接入可观测性平台
配置OpenTelemetry Java Agent或SDK
设置OTLP端点和认证信息
npx skills add MapleTechLabs/maple --skill maple-java-style -g -y
提供Kotlin应用集成OpenTelemetry遥测的指南，涵盖零代码Java Agent自动注入和手动SDK配置，支持Ktor与Spring Boot，实现链路追踪、日志与指标上报。
需要为Kotlin项目配置OpenTelemetry遥测
询问如何集成Maple可观测性平台
npx skills add MapleTechLabs/maple --skill maple-kotlin-style -g -y
提供Next.js/Vercel环境下集成Maple可观测性的标准配置指南，涵盖OpenTelemetry初始化、LLM提供商自动插桩及路由手动埋点规范。
需要为Next.js应用配置OpenTelemetry
询问如何集成Maple进行APM监控
涉及Vercel环境下的链路追踪设置
npx skills add MapleTechLabs/maple --skill maple-nextjs-style -g -y
提供 Node.js 应用集成 OpenTelemetry 的标准配置模板，支持 Express/Fastify/Hono/Bun 等框架。通过 --import 引导 SDK，使用 OTLP HTTP 导出追踪、日志和指标数据至 Maple 平台，并指导自动插桩与手动埋点规范。
需要为 Node.js 服务添加可观测性
配置 OpenTelemetry SDK 启动参数
设置 Trace/Log/Metric 的 OTLP HTTP 导出器
npx skills add MapleTechLabs/maple --skill maple-nodejs-style -g -y
将项目接入Maple可观测性平台，通过在各应用和服务中内联OpenTelemetry配置，自动注入追踪、日志和指标数据。
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进行链路追踪或指标采集
审查代码中的遥测实现是否符合Maple规范
npx skills add MapleTechLabs/maple --skill maple-onboarding-style -g -y
定义Maple Python项目的OpenTelemetry集成规范，涵盖模块级Tracer/Meter获取、装饰器与上下文管理器使用、异常记录及OTLP日志配置，禁止硬编码密钥。
Python代码审查
OpenTelemetry集成实施
npx skills add MapleTechLabs/maple --skill maple-python-style -g -y
为Maple平台提供Rust项目的OpenTelemetry集成规范，配置HTTP OTLP导出器及tracing桥接，实现日志、指标和追踪数据的自动上报。
需要在Rust项目中集成OpenTelemetry监控
需要配置Maple平台的遥测数据导出
npx skills add MapleTechLabs/maple --skill maple-rust-style -g -y
提供高性能 Pandas 替代方案，通过 ClickHouse 加速数据分析。支持多种数据源连接、跨源 Join 及完整 Pandas API，适用于需提升数据处理速度或整合多源数据的场景。
需要加速 Pandas 代码性能
使用 Pandas 语法分析数据
从数据库或云存储加载数据为 DataFrame
跨不同数据源进行数据关联
npx skills add MapleTechLabs/maple --skill chdb-datastore -g -y
提供在Python进程内直接运行ClickHouse SQL的能力，支持查询本地文件、远程数据库及云存储。适用于无需服务器的即席分析、跨源关联及构建有状态分析管道。
需要直接在Python中执行ClickHouse SQL语句
对Parquet/CSV/JSON等本地文件或S3等云存储进行SQL查询
使用mysql/s3/postgresql等表函数进行跨数据源联合查询
用户明确提及chdb.query或ClickHouse SQL语法
npx skills add MapleTechLabs/maple --skill chdb-sql -g -y
Maple平台多语言OpenTelemetry遥测规范，定义自定义属性键、状态码格式及资源属性双发等约定。用于指导代码中添加埋点、配置导出器或审查PR，确保与Tinybird MV和仪表盘兼容。
编写或审查涉及OpenTelemetry埋点的代码
配置OTLP导出器或Tracer Provider
审查涉及遥测相关服务的PR
npx skills add MapleTechLabs/maple --skill maple-telemetry-conventions -g -y
专注于优化新用户注册后的引导流程、激活率及首次使用体验，帮助用户快速达成“啊哈时刻”并建立长期留存习惯。
优化注册后引导流程
提升用户激活率
改善首次运行体验
缩短价值实现时间
npx skills add MapleTechLabs/maple --skill onboarding-cro -g -y
指导通过MCP构建、修复或审查Maple仪表盘组件，涵盖JSON结构规范、数据源区分及自定义过滤语法，避免常见陷阱。
create_dashboard
add_dashboard_widget
update_dashboard_widget
dashboard widget JSON
npx skills add MapleTechLabs/maple --skill maple-dashboard-widgets -g -y
基于OpenTelemetry规范v1.58.0，审查代码Diff、PR或文件是否符合OTel规范。重点检查MUST/SHOULD违规项，如部分成功处理、重试状态码及OTLP协议合规性。
is this spec compliant
review this PR against the OTel spec
spec-review this diff
check my partial-success handling
npx skills add MapleTechLabs/maple --skill maple-otel-spec-review -g -y
