Agent Skills
› ClickHouse/ClickHouse
ClickHouse/ClickHouse
GitHub分析 jemalloc 等内存分配配置文件的技能，通过并行子代理提取统计信息、识别热点调用栈及生成可视化图表，帮助开发者定位内存使用模式与分配瓶颈。
Install All Skills
npx skills add ClickHouse/ClickHouse --all -g -y
Skills in Collection (23)
分析 jemalloc 等内存分配配置文件的技能，通过并行子代理提取统计信息、识别热点调用栈及生成可视化图表，帮助开发者定位内存使用模式与分配瓶颈。
用户希望分析内存分配情况
需要查找主要的内存分配源
用户提供了 .collapsed 格式的内存配置文件
npx skills add ClickHouse/ClickHouse --skill alloc-profile -g -y
用于通过二分查找定位 ClickHouse 回归 bug 的提交。自动下载 CI 预构建二进制，执行测试脚本验证 SQL 复现用例，根据退出码判断好坏版本，从而快速缩小并确定引入缺陷的具体 Git 提交。
用户需要定位导致回归的 Git 提交
使用 SQL 复现 ClickHouse 错误并查找坏版本
npx skills add ClickHouse/ClickHouse --skill bisect -g -y
为ClickHouse项目生成符合维护者期望的PR描述，包括标题规范、自由格式上下文及模板化Changelog条目，提升代码审查效率。
需要撰写或更新Pull Request描述时
向ClickHouse仓库提交代码变更时
npx skills add ClickHouse/ClickHouse --skill clickhouse-pr-description -g -y
自动审计并关闭 ClickHouse 仓库中不再失败的“flaky test”GitHub Issue。通过查询 CI 历史验证测试稳定性，安全清理已修复的遗留问题。
需要清理过期的 flaky test issue
定期维护 GitHub 仓库状态
npx skills add ClickHouse/ClickHouse --skill close-flaky-issues -g -y
在本地运行AI代码审查，模拟CI流程对当前分支进行独立检查。支持自动修复并重新审查，提供提交前的代码质量第二意见，确保代码符合规范后再推送。
请求在推送前审查当前分支
要求运行本地AI代码审查
获取Diff的独立审核意见
npx skills add ClickHouse/ClickHouse --skill codex-review -g -y
自动化处理PR的无人值守技能，自动解析冲突、修复CI失败及审查反馈并推送更新。适用于后台持续集成与代码合并流程，确保分支同步而不需人工干预。
需要自动解决PR冲突时
批量处理停滞的Pull Request
自动化脚本触发PR维护任务
npx skills add ClickHouse/ClickHouse --skill continue-pr-auto -g -y
该技能用于继续处理现有的Pull Request，包括解决冲突、修复CI失败、响应审查反馈并推送更新。支持验证PR状态及合并历史，确保操作安全有效。
用户希望继续处理某个PR
需要解决PR冲突或CI失败
需要根据审查意见修改代码
npx skills add ClickHouse/ClickHouse --skill continue-pr -g -y
用于分析ClickHouse查询的CPU性能瓶颈。通过采样查询分析器和系统日志收集CPU堆栈跟踪，识别热点函数和调用路径，帮助定位执行耗时原因。
用户希望查找SQL查询的CPU热点
用户需要分析查询性能瓶颈
用户想要调查查询执行时间分布
npx skills add ClickHouse/ClickHouse --skill cpu-profile -g -y
该技能用于通过执行标准脚本创建测试数据集（如hits, visits, tpch等）。它会自动验证服务器状态、检查表冲突并执行相应的SQL语句来建立测试环境，确保数据准备过程的安全与规范。
需要初始化或重置测试数据
运行TPC-H/TPC-DS基准测试前准备数据
搭建ClickHouse测试环境
npx skills add ClickHouse/ClickHouse --skill create-test-datasets -g -y
为 ClickHouse 项目创建 Git worktree，智能判断文本或构建任务以决定是否硬链接子模块。支持分支检出、新建及路径配置，优化开发环境初始化流程。
用户需要为 ClickHouse 项目创建新的开发工作区
用户需要基于特定分支建立独立的 git worktree
npx skills add ClickHouse/ClickHouse --skill create-worktree -g -y
从 ClickHouse 自解压二进制文件中离线提取内部 ELF，解决跨架构无法运行或需真实符号进行核心转储调试的问题。
需要为不同架构的二进制文件加载核心转储
gdb/lldb 显示无真实符号的自解压二进制文件
npx skills add ClickHouse/ClickHouse --skill decompress-binary -g -y
自动整理ClickHouse发布说明，将生成器的原始输出清洗、分类并重写为标准格式，确保内容准确且符合规范。
需要编辑自动生成器的Changelog输出
准备发布版本并清理CHANGELOG.md
npx skills add ClickHouse/ClickHouse --skill edit-changelog -g -y
自动诊断并修复ClickHouse公共PR同步至私有仓库时的CI失败问题。支持处理合并冲突、构建失败和测试失败三种场景，通过解析PR号定位同步PR并执行针对性修复。
用户请求修复CH Inc sync CI作业失败
检测到同步PR存在合并冲突或CI状态异常
npx skills add ClickHouse/ClickHouse --skill fix-sync -g -y
生成 ClickHouse 仓库中准备合并的 PR 报告，按作者分类并显示 CI 状态及冲突情况。
查询准备合并的 PR
查看 'good-prs'
检查 merge-ready PR
npx skills add ClickHouse/ClickHouse --skill good-prs -g -y
用于评估ClickHouse性能测试结果，判断回归是否真实、是否存在抖动或已知历史问题。通过CI数据或本地脚本对比PR变更与历史趋势，提供可操作的结论。
需要评估PR对性能的影响
检查性能测试结果的稳定性与真实性
对比当前运行与历史基准数据
npx skills add ClickHouse/ClickHouse --skill perf-comparison -g -y
分析 ClickHouse PR 的性能对比报告，提取性能回归与改进项，并通过交叉引用主分支历史数据区分真实变更与不稳定测试，确保结果完整准确。
用户要求分析特定 PR 的性能报告
用户提供 CI 性能比较链接或 PR 编号
npx skills add ClickHouse/ClickHouse --skill perf-report -g -y
用于审查 ClickHouse Pull Request，检查代码正确性、安全性、性能及合规性。支持自动获取 Diff、识别 Revert PR、验证 Changelog 元数据质量，并提供针对 C++ 核心模块的严格反馈。
用户要求审查 PR
用户提供 PR 编号或分支名称
npx skills add ClickHouse/ClickHouse --skill review -g -y
用于更新 ClickHouse 第三方库（contrib submodule）版本。处理分支管理、CMake 适配及源码修复，支持交互与自动化流水线模式，涵盖依赖升级全流程。
用户请求更新第三方库版本
需要 bump contrib 子模块
npx skills add ClickHouse/ClickHouse --skill update-contrib -g -y
在浏览器中提供待提交或 PR 前的代码变更审查界面。启动本地服务器渲染 diff，收集用户行级评论并返回 JSON，需逐一处理反馈。支持本地及 SSH 转发场景，适用于需要人工介入的代码审查流程。
请求在浏览器中审查代码变更
需要在提交前进行交互式代码 review
npx skills add ClickHouse/ClickHouse --skill diff-review -g -y
用于本地复现 ClickHouse CI 性能测试中性能变化的结果。自动获取报告、下载二进制文件并重新运行受影响的查询，以验证回归或改进是否真实存在。
用户希望“double-check”CI性能测试结果
用户希望“reproduce”或“verify locally”性能对比差异
用户希望“re-run”特定提交的性能检查
npx skills add ClickHouse/ClickHouse --skill double-check-perf-tests -g -y
用于端到端调查 CI 失败，通过 PR 或 S3 URL 获取测试输出，区分偶发与回归，检查关联 Issue 和修复状态，并生成根因假设。全程只读，不修改代码或提交。
用户询问 CI 构建或测试失败原因
提供 GitHub PR 或 S3 报告链接要求分析
npx skills add ClickHouse/ClickHouse --skill investigate-ci -g -y
用于分析ClickHouse Keeper压力测试结果的技能，支持验证PR、调查回归及生成性能报告。
验证Keeper PR对压力测试的影响
查询特定日期窗口内的Keeper性能变化
调查Keeper夜间构建的回归或改进
询问Keeper p99延迟、内存或RPS指标
npx skills add ClickHouse/ClickHouse --skill keeper-stress-analysis -g -y
