Agent Skills
› MapleTechLabs/maple
MapleTechLabs/maple
GitHub提供ClickHouse架构设计建议，根据工作负载类型（如可观测性、IoT等）选择摄入或建模模式。通过决策框架和官方文档溯源，输出包含权衡分析、瓶颈识别及验证方法的结构化推荐。
Install All Skills
npx skills add MapleTechLabs/maple --all -g -y
Skills in Collection (35)
提供ClickHouse架构设计建议，根据工作负载类型（如可观测性、IoT等）选择摄入或建模模式。通过决策框架和官方文档溯源，输出包含权衡分析、瓶颈识别及验证方法的结构化推荐。
设计ClickHouse系统架构
选择数据摄入或建模模式
将最佳实践转化为特定工作负载的系统设计
npx skills add MapleTechLabs/maple --skill clickhouse-architecture-advisor -g -y
提供ClickHouse模式、查询及数据插入的最佳实践规则，用于审查数据库设计、优化查询性能及规范数据摄入流程。
审查ClickHouse表结构或配置
优化SQL查询语句
评估数据导入策略
npx skills add MapleTechLabs/maple --skill clickhouse-best-practices -g -y
指导用户使用clickhousectl将ClickHouse应用部署至云托管服务，涵盖账户注册、CLI认证、服务创建及数据迁移流程。
用户希望将本地ClickHouse迁移到ClickHouse Cloud
用户需要创建或配置ClickHouse Cloud托管服务
用户想要将ClickHouse应用部署到生产环境的云端
npx skills add MapleTechLabs/maple --skill clickhousectl-cloud-deploy -g -y
指导用户从零开始在本地搭建 ClickHouse 开发环境，涵盖工具安装、实例初始化、服务启动及基础建表流程。
需要本地运行 ClickHouse
搭建数据分析开发环境
安装 ClickHouse CLI 工具
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
辅助正确实现 coss UI 组件，涵盖组件选择、代码编写、shadcn/Radix 迁移及常见问题排查。
使用 coss 基础组件构建 UI
从 shadcn/Radix 迁移到 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的使用指南，涵盖本地开发、分支管理、构建部署及数据操作。适用于执行tb命令、配置CI/CD流水线及管理令牌等场景，确保开发者遵循标准工作流与最佳实践。
运行 tb 命令
设置 CI/CD 流水线
部署 Tinybird 项目
进行本地或云端数据操作
npx skills add MapleTechLabs/maple --skill tinybird-cli-guidelines -g -y
提供Tinybird Python SDK的使用指南，涵盖数据源、管道和查询的Python定义，包括安装配置、CLI命令及资源迁移。
使用tinybird-sdk进行开发
定义Tinybird数据资源
运行Tinybird CLI命令
npx skills add MapleTechLabs/maple --skill tinybird-python-sdk-guidelines -g -y
提供Tinybird TypeScript SDK的使用指南，涵盖数据源、管道定义、类型安全客户端创建及CLI命令集成。适用于TypeScript项目中Tinybird资源的开发与配置。
使用@tinybirdco/sdk进行开发
定义Tinybird数据源或管道
执行Tinybird CLI构建部署
npx skills add MapleTechLabs/maple --skill tinybird-typescript-sdk-guidelines -g -y
提供Tinybird数据源、管道、端点及物化视图的开发规范、SQL优化策略与最佳实践，指导资源创建、查询编写及项目结构组织。
创建或更新Tinybird资源文件
编写或优化SQL查询
设计端点架构和数据模型
npx skills add MapleTechLabs/maple --skill tinybird -g -y
通过逐层追问引导用户完善计划或设计，覆盖目标、安全、测试等维度，挑战假设并推荐方案，最终达成对设计的共识并总结风险与下一步。
用户希望压力测试其计划或设计
用户提到 'grill me'
需要深入梳理设计决策和潜在风险
npx skills add MapleTechLabs/maple --skill grill-me -g -y
用于编写和更新 Effect 公共 API 的 JSDoc，确保符合 jsdocs oxlint 规则。涵盖创建、修复注释及文档审查，遵循特定结构和行文规范，以生成高质量的 TypeScript 文档。
添加或修复 JSDoc 注释
解决 jsdocs 诊断错误
准备 JSON 提取所需的文档
审查公共 API 文档
npx skills add MapleTechLabs/maple --skill jsdocs -g -y
从源码光标附近的 JSDoc 示例提取代码并生成 TypeScript 文件，支持自动追加 Effect 运行逻辑，便于快速尝试和调试示例。
用户要求复制、打开或尝试源码中的示例
需要基于当前选择或光标位置提取 JSDoc 示例
npx skills add MapleTechLabs/maple --skill scratchpad -g -y
用于扫描React代码库的安全、性能、正确性及架构问题，输出健康评分。适用于提交前检查变更回归或整体代码清理优化，辅助提升代码质量。
完成功能开发后
修复Bug后
提交代码前
用户希望改进代码质量
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的标准配置指南，涵盖Trace、Metric和Log的OTLP HTTP导出及ASP.NET Core自动插桩设置。
需要为C#项目添加可观测性
配置OpenTelemetry OTLP导出器
ASP.NET Core 监控初始化
npx skills add MapleTechLabs/maple --skill maple-csharp-style -g -y
提供基于Effect-TS的Maple可观测性集成指南，涵盖OpenTelemetry追踪、日志和跨端（Node/Browser/Cloudflare）Bootstrap配置。
需要集成OpenTelemetry追踪
配置Effect-TS应用的日志与Span
处理不同运行时的遥测导出
npx skills add MapleTechLabs/maple --skill maple-effect-style -g -y
提供Go语言OpenTelemetry SDK集成方案，支持Trace、Log、Metric通过HTTP导出至Maple平台。包含自动初始化与优雅关闭逻辑，注入服务名、环境及Git元数据等资源属性，实现一站式可观测性接入。
需要为Go项目配置OpenTelemetry
需要集成Maple可观测性平台
需要统一Trace/Log/Metric导出配置
npx skills add MapleTechLabs/maple --skill maple-go-style -g -y
提供Java应用集成Maple可观测性平台的配置指南，支持通过OpenTelemetry Java Agent实现零代码自动注入，或手动引入SDK进行显式配置，涵盖Traces、Logs和Metrics的OTLP导出。
需要为Java项目添加APM监控
配置OpenTelemetry指标或日志导出
解决GraalVM下无法使用Agent的问题
npx skills add MapleTechLabs/maple --skill maple-java-style -g -y
提供Kotlin应用集成OpenTelemetry的指南，支持零代码Java Agent自动插桩和手动SDK配置，涵盖Traces、Logs及Metrics的OTLP导出与资源属性设置。
需要为Kotlin项目配置可观测性
集成OpenTelemetry Java Agent或SDK
配置OTLP日志和指标导出
npx skills add MapleTechLabs/maple --skill maple-kotlin-style -g -y
提供Next.js/Vercel环境下Maple OpenTelemetry的集成指南，涵盖自动配置、LLM Provider插桩及Route Handler手动埋点规范。
需要为Next.js应用配置OpenTelemetry监控
需要在Vercel环境中接入Maple可观测性平台
需要实现Anthropic等LLM调用的自动追踪
npx skills add MapleTechLabs/maple --skill maple-nextjs-style -g -y
提供Node.js应用集成OpenTelemetry的标准配置方案，支持Express/Fastify等框架，通过--import引导SDK启动并配置OTLP HTTP导出器。
需要为Node.js项目添加分布式追踪和监控
询问如何配置OpenTelemetry SDK
npx skills add MapleTechLabs/maple --skill maple-nodejs-style -g -y
将项目接入Maple可观测平台，通过OpenTelemetry为仓库内所有应用和服务配置Trace、Log和Metric。支持多种语言栈，自动处理端点与密钥注入，实现全链路监控集成。
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使用、withSpan助手集成、命名约定、内联密钥配置及VCS资源属性，禁止自定义封装。
需要为项目添加OpenTelemetry监控时
审查或重构现有遥测代码是否符合Maple规范时
npx skills add MapleTechLabs/maple --skill maple-onboarding-style -g -y
定义Maple平台Python项目的OpenTelemetry集成规范，涵盖模块级Tracer/Meter获取、装饰器与上下文管理器使用、异常记录及OTLP日志配置，指导开发者实现标准化的可观测性接入。
需要为Python服务添加OpenTelemetry监控
询问Maple平台Python代码的可观测性最佳实践
npx skills add MapleTechLabs/maple --skill maple-python-style -g -y
提供Rust项目中OpenTelemetry集成配置，涵盖traces、logs和metrics的HTTP OTLP导出及tracing桥接。
需要集成OpenTelemetry监控
配置Rust后端可观测性
npx skills add MapleTechLabs/maple --skill maple-rust-style -g -y
提供基于ClickHouse的高性能pandas替代方案，支持16+数据源和多种文件格式的加载、分析及跨源Join。通过一行代码替换实现现有pandas代码加速，适用于需要高效数据处理和分析的场景。
使用pandas风格语法分析数据
加速缓慢的pandas代码
将远程数据库或云存储查询为DataFrame
跨不同数据源进行数据连接
npx skills add MapleTechLabs/maple --skill chdb-datastore -g -y
提供在Python进程内直接运行ClickHouse SQL的能力，支持对本地文件、远程数据库及云存储进行查询与分析。适用于无需服务器的即席SQL查询、跨源连接及状态分析管道构建。
用户需要在Python中执行ClickHouse SQL语法
用户希望查询Parquet/CSV/JSON文件或S3等云存储数据
用户提到chdb.query()或需要跨源SQL Join
npx skills add MapleTechLabs/maple --skill chdb-sql -g -y
提供Maple项目跨语言（TS/Rust/Python）的OpenTelemetry规范，涵盖自定义属性键、状态码格式、资源属性及Tinybird集成规则，用于指导或审查遥测代码实现。
编写或审查涉及OpenTelemetry插桩的代码
配置OTLP导出器或定义新的资源属性
审查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构造、数据源区分、自定义whereClause语法及验证，防止常见配置陷阱。
create_dashboard
add_dashboard_widget
update_dashboard_widget
dashboard widget JSON
QueryDraft
npx skills add MapleTechLabs/maple --skill maple-dashboard-widgets -g -y
基于OpenTelemetry规范v1.58.0，审查代码差异、PR或文件是否符合OTel规范。重点检查MUST/SHOULD违规项，如OTLP服务端处理、自监控及状态码逻辑，提供带引用的合规性发现。
审查PR或Diff的OTel规范合规性
检查部分成功处理逻辑
验证重试状态码是否正确
审查OTLP服务器表面变更
检查自监控实现
npx skills add MapleTechLabs/maple --skill maple-otel-spec-review -g -y
