## 功能描述 在仓库中提供 `pt-snap-memory-peak-breakdown` agent skill,指导 agent 基于现有 SnapshotDB、`report peak-memory` 和查询模板,对 active、allocated、reserved 各自峰值事件进行只读、可复现的内存归因。 ## 使用场景 底层峰值查询与报告能力已由 #62 / #63 提供,但 agent 仍需要统一工作流来: - 解析一致的数据库与 device 范围,且不修改 focus。 - 区分全 trace 与指定事件区间。 - 在每个指标自己的峰值事件上分析 active blocks 和 allocation callstacks。 - 分离 static、dynamic live 和 missing callstack。 - 避免把 allocator gap 误判为碎片、泄漏或 OOM 根因。 - 在 `pt-snap` 不可用时转交 setup skill,而不是自行安装或切换环境。 ## 期望的实现方式 新增仓库级 skill 文档,复用现有 `memory_peak`、`allocator_gap`、`active_memory_callstack_at_event`、`active_blocks_at_event` 模板和 `report peak-memory` 命令;同时增加静态契约测试,锁定命令引用、区间回退、安全边界和输出结构。 ## 示例 ```shell pt-snap report peak-memory snapshot.db --device 0 --metric active --include-static --limit 20 --json pt-snap query snapshot.db --device 0 --template-use active_blocks_at_event --params '{"event_id": 42, "include_static": true, "limit": 20}' -n 20\n```\n\n## 参考资源\n\n- #62\n- #63\n\n## 验收标准\n\n- [ ] Skill 仅接受现有 SnapshotDB,不导入或反序列化 pickle。\n- [ ] 所有分析命令显式传入数据库和 device,且不修改 focus。\n- [ ] 支持全 trace 和 inclusive event range 两种流程。\n- [ ] 分别记录 active、allocated、reserved 的峰值及各自 event ID。\n- [ ] 在选定事件上提供 active callstack 和代表性 block 归因。\n- [ ] 明确 static、missing callstack、百分比分母和 same-event gap 语义。\n- [ ] 禁止从该流程推断泄漏、碎片或 OOM 根因。\n- [ ] 提供自动化测试验证 skill 的命令、模板和安全契约。
Activity
feat: add pt-snap memory peak breakdown skill