Agent Skills
› ClickHouse/ClickHouse
ClickHouse/ClickHouse
GitHub分析jemalloc等生成的折叠堆栈格式内存分配文件，定位文件后并行运行多个Agent进行统计、去噪和热点识别，帮助开发者理解内存使用模式和查找顶级分配器。
Install All Skills
npx skills add ClickHouse/ClickHouse --all -g -y
Skills in Collection (22)
分析jemalloc等生成的折叠堆栈格式内存分配文件，定位文件后并行运行多个Agent进行统计、去噪和热点识别，帮助开发者理解内存使用模式和查找顶级分配器。
用户希望分析内存分配模式
需要找出顶级内存分配者
提供或请求分析.collapsed/.folded格式的内存配置文件
npx skills add ClickHouse/ClickHouse --skill alloc-profile -g -y
用于通过二分查找定位 ClickHouse 回归错误的提交，自动下载 CI 预编译二进制并管理测试循环。
用户需要找出引入 bug 的特定提交
用户提供了 SQL 复现文件并请求定位回归
npx skills add ClickHouse/ClickHouse --skill bisect -g -y
用于生成符合 ClickHouse 维护者规范的 PR 描述，包括标题格式和包含上下文及变更日志的正文结构。
需要为 Pull Request 撰写或更新描述
用户询问如何编写符合项目规范的 PR 内容
npx skills add ClickHouse/ClickHouse --skill clickhouse-pr-description -g -y
自动审计并关闭已修复的Flaky测试GitHub Issue。通过对比CI历史与Git日志，确认测试在指定周期内无失败后执行关闭操作，减少仓库噪音。
需要清理过期的flaky test issue
定期维护GitHub Issue状态
npx skills add ClickHouse/ClickHouse --skill close-flaky-issues -g -y
自动化处理PR的无人值守技能，用于解决冲突、修复CI失败及回应审查意见。通过判断分支状态智能重做特性以对齐主分支，全程无需用户交互，仅接受数字PR号作为输入，适用于批量PR维护场景。
需要自动合并存在冲突或过期的Pull Request
需要批量修复CI失败并更新PR
使用utils/continue-all-prs.sh脚本驱动PR维护
npx skills add ClickHouse/ClickHouse --skill continue-pr-auto -g -y
用于接管并推进现有 Pull Request，包括解决代码冲突、修复 CI 失败、处理审查反馈及推送更新。支持验证 PR 状态与合并祖先关系，确保操作安全有效。
用户希望继续处理某个 Pull Request
需要解决 PR 中的合并冲突或 CI 构建失败
需要根据审查意见修改并重新提交代码
npx skills add ClickHouse/ClickHouse --skill continue-pr -g -y
分析 ClickHouse 查询的 CPU 性能瓶颈。支持通过 query_id 回溯或执行新查询，利用采样探查器和 trace_log 收集 CPU 堆栈轨迹，识别热点函数和调用路径，辅助性能优化。
用户希望查找 SQL 查询中的 CPU 热点
用户需要分析查询耗时分布及性能瓶颈
用户想调查特定查询的 CPU 资源消耗情况
npx skills add ClickHouse/ClickHouse --skill cpu-profile -g -y
通过执行标准脚本为ClickHouse创建测试数据集（hits, visits, tpcds, tpch）。流程包括参数解析、服务连通性检查及冲突表检测，确保环境就绪后安全生成测试数据。
需要初始化或重置特定测试数据集时
运行包含测试数据的测试用例前
npx skills add ClickHouse/ClickHouse --skill create-test-datasets -g -y
为ClickHouse项目创建Git worktree，支持硬链接子模块以节省磁盘和网络开销。根据任务类型（文本或构建）决定是否跳过耗时的子模块设置，提供分支检测和路径建议功能。
用户需要为ClickHouse创建新的开发工作区
用户希望基于现有分支或远程分支建立独立的工作目录
npx skills add ClickHouse/ClickHouse --skill create-worktree -g -y
从 ClickHouse 自解压二进制文件中离线提取内部 ELF，解决跨架构无法运行时的符号加载问题，支持调试核心转储。
需要加载缺少符号的 CI/Release 二进制文件进行调试
目标二进制与主机架构不同导致无法直接运行自解压
npx skills add ClickHouse/ClickHouse --skill decompress-binary -g -y
用于编辑 ClickHouse 自动生成版本更新日志的技能。通过标准化标题、分类条目和清理无效内容，将原始输出转换为符合发布规范的 CHANGELOG.md 格式。
用户需要整理自动生成器输出的变更日志
用户希望将原始 PR 描述重构为正式发布的版本说明
npx skills add ClickHouse/ClickHouse --skill edit-changelog -g -y
自动诊断并修复ClickHouse PR同步CI作业失败问题，涵盖冲突解决、构建错误修复及测试故障排查。
PR同步CI作业状态为conflicts found
PR同步CI作业状态为build failed
PR同步CI作业状态为tests failed
npx skills add ClickHouse/ClickHouse --skill fix-sync -g -y
生成 ClickHouse 仓库中可合并 PR 的报告，筛选 CI 仅 CH Inc sync 异常或全绿的 PR，按作者分组并显示审批状态。
查询好 PR
检查可合并 PR
仅被同步任务阻塞的 PR
npx skills add ClickHouse/ClickHouse --skill good-prs -g -y
用于评估ClickHouse性能测试结果，判断回归是否真实、存在或需深入调查。支持CI数据、本地运行及历史对比，识别噪声并生成可操作结论。
检查PR性能变化
分析本地perf.py运行结果
对比历史趋势与稳定性
评估测试噪声与置信度
npx skills add ClickHouse/ClickHouse --skill perf-comparison -g -y
分析 ClickHouse PR 的性能对比报告，识别性能回归与提升。通过查询主分支历史数据区分真实变更与波动测试，提供完整且分类明确的性能变化清单。
需要分析 CI 性能报告中的回归或改进
需要验证性能变化是否由 PR 引起而非测试波动
npx skills add ClickHouse/ClickHouse --skill perf-report -g -y
用于审查 ClickHouse 代码拉取请求，检查正确性、安全性、性能及合规性。支持处理 PR、分支或 diff 差异，自动检测还原提交并验证变更日志元数据质量。
用户要求审查代码拉取请求
用户提供 PR 编号或代码差异供审核
npx skills add ClickHouse/ClickHouse --skill review -g -y
用于将 ClickHouse contrib/ 下的第三方库子模块升级至新版本，处理 fork 管理、CMake 适配及源码修复。
用户要求更新某个 contrib 库的版本
需要 bump 依赖到新的 git tag 或 commit
npx skills add ClickHouse/ClickHouse --skill update-contrib -g -y
在浏览器中启动本地服务展示代码差异，收集用户行级评论后返回JSON供Agent处理。适用于提交或PR前的交互式代码审查场景。
用户请求在浏览器中审查代码变更
需要交互式获取用户对未提交或待合并代码的行级反馈
npx skills add ClickHouse/ClickHouse --skill diff-review -g -y
在本地复现 ClickHouse CI 性能测试结果，通过下载指定架构的二进制文件并重新运行被标记为性能变化的查询，以验证回归或改进的真实性。
double-check perf check result
reproduce perf test locally
verify performance regression
re-run perf check
npx skills add ClickHouse/ClickHouse --skill double-check-perf-tests -g -y
自动分析 ClickHouse CI 失败，通过对比主分支历史区分偶发与真实回归，查找关联 Issue 和 PR，并生成根因假设。全程只读，不修改代码或提交。
收到 GitHub PR 或 S3 报告的 URL
需要诊断 CI 测试失败原因
判断测试是否为 Flaky
npx skills add ClickHouse/ClickHouse --skill investigate-ci -g -y
分析ClickHouse Keeper压力测试结果，支持PR验证、回归排查及性能对比。通过标准化SQL查询与脚本工作流，提供p99延迟、内存等指标的深度洞察，辅助Keeper版本稳定性评估。
Keeper PR验证
Keeper性能回归调查
Keeper夜间构建报告
特定时间段或PR的性能对比
Keeper压力测试仪表板查询
npx skills add ClickHouse/ClickHouse --skill keeper-stress-analysis -g -y
