fix-slow-queries 是 Paperclip 项目中的一项技能工作流，目标是在保持原有行为的前提下，交付可测量的 PostgreSQL 慢查询改进，最终形成一个可以通过检查的 PR；如果只输出可疑 SQL 列表或未经证实的重写，则只算中间结果。若请求只要求诊断，则应按更窄的范围处理。
用途：用于定位 Paperclip 的慢查询并实施修复。流程首先确定报告中的 URL、环境、公司或工作区、部署版本、所属仓库和本地检出，并阅读 AGENTS.md 与相关规则，在专用分支或工作树中工作，选择通常两到三个查询族的有限批次，记录暂缓处理的候选。
主要能力与流程：通过 Cloud 发现链路，从 Paperclip Cloud 的 fleet admin 追溯到 Neon 项目、分支、端点、数据库与运行时角色，并记录对应部署与时间窗口；采集查询文本或指纹、调用次数、总耗时、平均耗时、行数以及 I/O、临时文件、锁等待等证据，区分“SQL 昂贵”“数据库路径主导慢请求”“增加数据库容量有帮助”三类主张。使用 rg 追踪路由或调度器到服务、生成 SQL 与索引的完整路径，提出可证伪的原因和需保留的契约。随后在本地用一次性真实 PostgreSQL 和具有代表性行数、选择性与载荷的合成数据复现基线，固定修复前提交，保存结果、计时与 EXPLAIN（ANALYZE, BUFFERS, FORMAT JSON），并预先定义性能验收标准。
实施与验证：做测量支持的最小改动，在等效夹具与相同设置下对比基线与修复，性能上使用预热和重复采样、报告中位数与离散度，必要时交替顺序以排除缓存影响；正确性上比较每个返回列和外部可见行为，保留排序、重复、空值、租户范围与脱敏，行数相同但结果错误同样视为失败。按调用方图和受影响契约选择回归检查，如 UUID/JSON 连接、JSON 投影、历史边界、所有权与恢复读取、轮询与缓存等，先跑聚焦检查，再跑仓库要求的预 PR 检查。
PR 与限制：使用完整 PR 模板写明原因、契约、基准命令、基线版本、修复前后计时、相等性证据、回归结果与剩余风险，并持续处理评审与检查，不能以“CI 待定”结束。资料明确约束：除非有充分理由，否则不应要求运行迁移脚本；也不应通过启动脚本绕过迁移；若必须迁移，需在生产规模副本上计时，超过约一到两分钟的迁移应先优化并标记人工评审。该技能本身不授予评论、关闭、合并、部署、扩容或变更托管数据库的权限。
适用场景：Paperclip 或 paperclip-cloud 中 PostgreSQL 慢查询的诊断与优化，包括索引、JSON 投影、历史范围限制、所有权与恢复读取、轮询与缓存相关查询。
限制与暂未提供：资料未提供该技能的安装命令、调用方式、收费信息或具体平台支持范围。