Skip to content

[FEATURE] 提供峰值内存拆解诊断 Skill #106

Closed

Description

@codeasier

功能描述

在仓库中提供 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 命令;同时增加静态契约测试,锁定命令引用、区间回退、安全边界和输出结构。

示例

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

  1. added a commit that references this issue on Aug 24, 2026
    6a8e384
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions