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最佳实践指南，涵盖Schema设计、查询优化和数据插入策略。包含28条规则，用于审查表结构、SQL查询及数据摄入配置，确保符合ClickHouse特定行为并优化性能。
审查ClickHouse表结构设计
优化ClickHouse查询语句
评估ClickHouse数据导入策略
npx skills add MapleTechLabs/maple --skill clickhouse-best-practices -g -y
指导使用 clickhousectl 将 ClickHouse 应用部署至 ClickHouse Cloud，涵盖账户注册、CLI 认证、服务创建及迁移流程。
部署 ClickHouse 到云端
迁移本地 ClickHouse 到 ClickHouse Cloud
创建 ClickHouse Cloud 服务
npx skills add MapleTechLabs/maple --skill clickhousectl-cloud-deploy -g -y
指导用户从零开始在本地搭建 ClickHouse 开发环境，涵盖工具安装、版本管理、项目初始化及服务启动。
搭建本地 ClickHouse 环境
安装 ClickHouse 数据库
初始化 ClickHouse 项目结构
npx skills add MapleTechLabs/maple --skill clickhousectl-local-dev -g -y
提供基于coss原型的可复制UI组件模式索引，帮助快速查找并集成480种预构建的UI粒子示例，加速前端界面开发。
需要快速实现特定UI组件如表单、对话框或按钮时
寻找可直接使用的UI代码片段以加速前端开发
npx skills add MapleTechLabs/maple --skill coss-particles -g -y
辅助实现 coss UI 组件，涵盖组件选择、代码编写、shadcn/Radix 迁移及故障排查。确保正确导入、无障碍访问和 Tailwind 样式，避免常见陷阱。
构建 coss 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 (tb) 的使用指南，涵盖本地开发、分支管理、构建部署、数据操作及 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）及遗留文件迁移，适用于基于Python的Tinybird项目开发与运维。
使用tinybird-sdk进行开发
运行tinybird CLI命令
在Python中定义数据资源
npx skills add MapleTechLabs/maple --skill tinybird-python-sdk-guidelines -g -y
提供Tinybird TypeScript SDK的使用指南，涵盖数据源定义、管道配置、类型安全查询及CLI命令（dev/build/deploy），支持从旧格式迁移。
使用@tinybirdco/sdk进行开发
定义Tinybird数据源或管道
运行Tinybird CLI构建部署
npx skills add MapleTechLabs/maple --skill tinybird-typescript-sdk-guidelines -g -y
提供 Tinybird 数据建模、SQL 优化及资源管理的最佳实践，涵盖数据源、管道、端点和物化视图的创建与重构。
创建或更新 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 的 JSDoc，确保符合 jsdocs oxlint 规则。涵盖修复诊断、准备 JSON 提取文档及审查公共 API 文档等场景。
添加或修复 JSDoc 注释
解决 jsdocs 诊断错误
为 JSON 提取准备文档
审查公共 API 文档
npx skills add MapleTechLabs/maple --skill jsdocs -g -y
从 JSDoc 示例提取代码生成 TypeScript 文件至 scratchpad，支持自动适配 Runner 并处理冲突命名，用于快速尝试源码示例。
用户要求 dump、copy、open 或 try 源码中的示例
用户在 IDE 中选中代码或移动光标后请求提取示例
npx skills add MapleTechLabs/maple --skill scratchpad -g -y
用于扫描 React 代码库的安全性、性能、正确性及架构问题，输出健康评分。支持在提交前检查变更回归或进行全面清理，辅助提升代码质量。
完成功能开发后
修复 Bug 后
提交代码前
用户希望改善代码质量时
npx skills add MapleTechLabs/maple --skill react-doctor -g -y
用于构建、编辑和修复 Maple 仪表盘及组件。遵循先测试后提议的工作流，通过查询可观测性数据验证 widget 配置的有效性，确保基于真实数据生成图表、统计或表格展示。
用户请求创建或修改仪表盘
用户需要添加或调整可视化组件
npx skills add MapleTechLabs/maple --skill dashboard-builder -g -y
用于调查告警、错误激增或异常等事件的根因分析技能。通过分析链路追踪、日志和指标数据，定位故障原因并评估影响范围，为值班工程师提供具体证据和建议。
收到告警通知
调查服务故障
排查性能缓慢问题
分析异常波动
npx skills add MapleTechLabs/maple --skill incident-investigation -g -y
审计已接入 OpenTelemetry 的项目，对照 Maple 规范检查遥测数据完整性与正确性。识别服务分类，依据 checks.md 生成带严重等级的发现报告，并指引使用配套技能修复缺失或错误配置，确保服务地图和数据分析正常。
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的OTLP HTTP导出设置及ASP.NET Core引导代码。
需要为C#应用配置可观测性
初始化OpenTelemetry集成
npx skills add MapleTechLabs/maple --skill maple-csharp-style -g -y
介绍如何在 Maple 应用中集成 Effect-TS 与 OpenTelemetry，提供 Node、浏览器及 Cloudflare Workers 的初始化配置，支持自动检测环境变量、优雅关闭及链路追踪日志关联。
需要为 Effect 应用配置 OpenTelemetry 追踪
询问 Maple 平台下的可观测性集成方法
处理不同运行时环境的 Telemetry SDK 引导
npx skills add MapleTechLabs/maple --skill maple-effect-style -g -y
为Maple Go项目提供OpenTelemetry集成方案，包含Trace、Log和Metric的HTTP导出器配置。支持进程启动时初始化及优雅关闭，自动注入服务名、环境及VCS元数据，实现可观测性数据的标准化上报。
需要为Go应用集成OpenTelemetry监控
配置Maple平台的遥测数据上报
设置Trace、Log或Metric的OTLP HTTP导出
npx skills add MapleTechLabs/maple --skill maple-go-style -g -y
提供基于 OpenTelemetry 的 Java 应用可观测性接入方案，支持零代码 Agent 自动插桩及手动 SDK 集成，配置 OTLP HTTP 导出器与日志桥接。
需要为 Java 服务配置分布式追踪和指标采集
询问如何集成 OpenTelemetry Java Agent 或 SDK
需要设置 Maple 平台的端点和认证信息
npx skills add MapleTechLabs/maple --skill maple-java-style -g -y
提供Kotlin应用集成OpenTelemetry的两种方案：零代码Java Agent自动埋点和手动SDK配置。支持Spring Boot/Ktor，涵盖Trace、Log、Metric导出及资源属性设置。
需要为Kotlin/JVM项目添加可观测性
配置OpenTelemetry Java Agent或SDK
集成Maple遥测数据收集
npx skills add MapleTechLabs/maple --skill maple-kotlin-style -g -y
提供 Next.js/Vercel 环境下集成 Maple APM 的最佳实践，涵盖 OpenTelemetry 初始化、Anthropic SDK 自动插桩及 Route Handlers 手动埋点规范。
配置 Next.js 应用的可观测性
集成 Vercel OpenTelemetry
添加 Anthropic API 追踪
npx skills add MapleTechLabs/maple --skill maple-nextjs-style -g -y
提供Node.js应用集成OpenTelemetry遥测的标准配置，支持Express/Fastify等框架。通过--import启动SDK，使用HTTP OTLP导出器上报Trace、Log和Metric数据，并自动注入上下文至业务代码。
需要为Node.js项目配置OpenTelemetry监控
询问如何接入Maple遥测平台
需要设置Tracing、Logging或Metrics采集
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使用、命名、配置及VCS属性。
需要添加OpenTelemetry监控代码
配置遥测SDK初始化
npx skills add MapleTechLabs/maple --skill maple-onboarding-style -g -y
定义 Maple Python 项目中 OpenTelemetry 的使用规范，涵盖模块级初始化、装饰器/上下文管理器绑定工作单元、异常记录及 OTLP 日志配置。
需要配置或集成 OpenTelemetry 监控时
审查 Python 代码中的遥测实现是否符合规范时
npx skills add MapleTechLabs/maple --skill maple-python-style -g -y
为Maple平台提供Rust项目的OpenTelemetry集成配置，支持通过HTTP导出Trace、Log和Metric数据，并桥接tracing crate实现自动上报。
需要配置Rust应用的可观测性
初始化OpenTelemetry SDK以连接Maple平台
集成tracing到OpenTelemetry链路
npx skills add MapleTechLabs/maple --skill maple-rust-style -g -y
提供基于ClickHouse的高性能Pandas替代方案，支持多种数据源接入、跨源Join及加速慢速Pandas代码。适用于数据分析、大数据处理及多源数据融合场景，保持标准Pandas API兼容。
用户希望使用Pandas语法分析数据但追求更高性能
需要连接数据库或云存储并转换为DataFrame
需要对不同来源的数据进行联合查询和聚合
npx skills add MapleTechLabs/maple --skill chdb-datastore -g -y
提供在Python进程中直接运行ClickHouse SQL的能力，支持查询本地文件、远程数据库及云存储。适用于编写SQL分析、跨源关联及高级SQL功能，非DataFrame操作。
用户需要在Python中执行ClickHouse SQL语法
用户希望查询Parquet/CSV/JSON文件或S3等云存储数据
用户提及chdb.query()或需要跨源SQL连接
npx skills add MapleTechLabs/maple --skill chdb-sql -g -y
提供Maple平台跨语言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 仪表板小部件。涵盖面板类型、数据源格式、单位规则及验证流程，确保 Widget JSON 正确生成与渲染。
创建或更新仪表板小部件
处理 Widget JSON 配置
审查图表数据正确性
npx skills add MapleTechLabs/maple --skill maple-dashboard-widgets -g -y
基于OpenTelemetry规范v1.58.0，审查代码差异、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
are these retryable status codes right
does apps/ingest honor the OTLP spec
npx skills add MapleTechLabs/maple --skill maple-otel-spec-review -g -y
