一键在 Manus 中运行任何 Skill

cluster-fast-slow-rank-detector

星标6

分支3

更新时间2026年3月15日 09:59

专门用于 Ascend 集群 Profiling 性能数据的“快慢卡”诊断专家技能。当用户提供【集群性能数据目录/路径】并要求分析【快慢卡】、【慢节点】、【负载不均衡】或【集群瓶颈】时，必须触发此技能。该技能会自动接收集群路径，调度相关工具输出快慢卡的宏观定性与微观根因（如 Host 下发瓶颈、算子计算劣化）。

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

在 Manus 中运行

来源

kali20gakki

kali20gakki/mindstudio-skills

打开 GitHub 仓库查看创作者相关仓库

下载

在 Manus 中运行

集群快慢卡诊断

1. 技能目标

在 Ascend 多卡/集群场景下，利用 Advisor 工具结合专家规则，自动识别因计算、通信或 Host 下发导致的性能瓶颈卡（慢卡），并下钻定位微观根因。

2. 诊断先验知识库 (Expert Rules)

禁止仅凭单项指标字面意思下结论，必须严格遵守以下华为官方诊断逻辑：

【Host 下发瓶颈 (伪快卡)】
- 现象：某卡（Rank X）的 Free Time 极长（占比 > 10% 或远超均值），且 Compute 和 Communication 时间异常偏短。
- 定性：Rank X 绝非快卡，而是导致集群阻塞的“慢卡”。 CPU 下发慢导致其 NPU 饿死（产生巨大 Free Time）。当它终于发起通信时，其他卡已等待多时（其他卡 Wait 长），故其通信瞬间完成。
- 动作：调用 scripts/compare_api_stats.py，重点观察 launch、aclrtSynchronizeDevice 等下发/同步 API 的耗时与间隙差异。
【纯计算快慢卡】
- 现象：各卡 Free Time 普遍较短且均匀，但某卡 Compute Time 显著大于均值。
- 定性：计算型慢卡。若单算子调用次数 (count) 不同，为负载切分不均；若次数相同但平均耗时 (avg_time) 激增，为算子硬件劣化或动态 Shape 导致。
- 动作：调用 scripts/compare_op_stats.py 对比算子执行差异。
【通信/慢链路瓶颈】
- 现象：各卡通信带宽远低于理论值（如 SDMA < 2GB/s）。
- 定性：通常为小包通信（ZeRO3 切分过细）、SDMA 地址未对齐或硬件问题。

3. 硬性约束 (MUST DO)

执行已有脚本，严禁造轮子：微观下钻环节（Step 3）必须且只能通过在终端执行 scripts/ 下的对比脚本获取差异数据。严禁在未执行脚本前自行读取 CSV/DB 进行 Diff 分析。
禁止 Trace 分析：本技能流程不包含 Timeline 级分析，Step 4 输出报告后立即结束，禁止主动读取 trace_view.json。

4. 标准操作流程 (SOP)

宏观体检：强制调用 msprof-analyze-advisor 工具输入集群路径，获取总体耗时极差与“慢卡分析”矩阵。
瓶颈定性：对照【先验知识库】，判定核心瓶颈属于 Host下发慢、计算慢 还是 纯通信慢，并锁定真正的“慢卡 RankID”。
微观下钻：根据瓶颈类型，在终端直接执行下方对应的对比脚本（计算慢用 OP 脚本，下发慢用 API 脚本）。仅当路径自动发现失败报错时，才可通过补充 --slow-path 参数重试。
输出报告：按以下结构输出最终回复：
- 诊断结论：瓶颈类型及真正慢卡的 RankID。
- 宏观证据：引用 Advisor 报告中的极差数据（如 Free Time 对比）。
- 微观根因：结合脚本输出的 Top 差异数据（特定 API 或算子的耗时比对），解释物理原因。
- 优化建议：给出针对性建议（如绑核、切分策略、排查算子Shape差异等）。

5. 脚本调用手册

对比脚本统一存放在本技能目录的 scripts/ 文件夹中，支持自动发现集群目录或手动指定文件（优先 CSV，次选 DB）。

核心命令模板：

# 【计算类瓶颈】调用算子对比脚本（将 <本技能目录> 替换为 get_skill 返回中的路径）
python <本技能目录>/scripts/compare_op_stats.py <集群数据根目录> <慢卡RankID> <快卡RankID> [--top N]

# 【下发类瓶颈】调用 API 对比脚本
python <本技能目录>/scripts/compare_api_stats.py <集群数据根目录> <慢卡RankID> <快卡RankID> [--top N]

参数说明：

cluster_pah: 集群数据根目录（包含 profiler_info_{rank}.json）。
slow_rank / fast_rank: 慢卡与快卡（基准）的 Rank ID。
--top N: （可选）输出差异最大的前 N 条，默认 20。
--slow-path / --fast-path: （可选）当集群自动发现机制报错时，用于手动指定慢/快卡的 *.csv 或 *.db 绝对路径。
--json: （可选）以 JSON 格式结构化输出。

同仓库更多 Skills

同仓库

model-adapt

kali20gakki/mindstudio-skills

为 msModelSlim 创建基础 Transformers 模型适配器（Model Adapter）。包含创建适配器、实现必需接口及四步验证流程。适用：Decoder-only LLM、理解类 VLM（仅 LLM/text 部分）。不适用：多模态生成模型（图像/视频/语音生成）、Encoder-only、非 Transformers 架构。

2026-04-096

model-analysis

kali20gakki/mindstudio-skills

在实现适配器前对候选模型做分析。确定模型实现来源（transformers 或模型目录）、结构特征、是否需逐层加载及 MoE 融合权重风险。适用于用户询问模型适配可行性或做适配前分析时使用。

2026-04-096

gitcode-code-reviewer

kali20gakki/mindstudio-skills

用于审查 GitCode PR，并结合 PR metadata、diff 与整个代码仓上下文生成深度审查结论或发布逐行评论。当用户希望 review GitCode PR、检查某个 GitCode PR 链接、分析变更风险、或将审查意见发布到 GitCode PR 时使用。典型触发方式包括“review this PR”“检视这个 PR”“检查 PR”，或直接提供 GitCode PR 链接，例如 https://gitcode.com/owner/repo/pull/123 。

2026-04-076

ascend-pytorch-profiler-db-explorer

kali20gakki/mindstudio-skills

面向 Ascend PyTorch Profiler / msprof DB（如 ascend_pytorch_profiler*.db、msprof_*.db）的 SQL 分析技能。将自然语言问题（算子耗时、通信、下发、调度、schema/table 查询）转为安全可执行 SQL，并按需从官方文档提取表结构详情。

2026-03-186

mindstudio-profiler-data-check

kali20gakki/mindstudio-skills

当用户提供 MindStudio profiler 采集的性能数据（框架 profiler、msprof 命令行）时，对数据完整性、采集状态及关键配置进行校验，确保后续分析工具能正常运行。

2026-03-126

op-mfu-calculator

kali20gakki/mindstudio-skills

计算算子（如 matmul/GEMM）的 MFU（Machine FLOP Utilization），并给出清晰的公式和推导过程。

2026-03-066

name

cluster-fast-slow-rank-detector

description

集群快慢卡诊断

1. 技能目标

在 Ascend 多卡/集群场景下，利用 Advisor 工具结合专家规则，自动识别因计算、通信或 Host 下发导致的性能瓶颈卡（慢卡），并下钻定位微观根因。

2. 诊断先验知识库 (Expert Rules)

禁止仅凭单项指标字面意思下结论，必须严格遵守以下华为官方诊断逻辑：

【Host 下发瓶颈 (伪快卡)】
- 现象：某卡（Rank X）的 Free Time 极长（占比 > 10% 或远超均值），且 Compute 和 Communication 时间异常偏短。
- 定性：Rank X 绝非快卡，而是导致集群阻塞的“慢卡”。 CPU 下发慢导致其 NPU 饿死（产生巨大 Free Time）。当它终于发起通信时，其他卡已等待多时（其他卡 Wait 长），故其通信瞬间完成。
- 动作：调用 scripts/compare_api_stats.py，重点观察 launch、aclrtSynchronizeDevice 等下发/同步 API 的耗时与间隙差异。
【纯计算快慢卡】
- 现象：各卡 Free Time 普遍较短且均匀，但某卡 Compute Time 显著大于均值。
- 定性：计算型慢卡。若单算子调用次数 (count) 不同，为负载切分不均；若次数相同但平均耗时 (avg_time) 激增，为算子硬件劣化或动态 Shape 导致。
- 动作：调用 scripts/compare_op_stats.py 对比算子执行差异。
【通信/慢链路瓶颈】
- 现象：各卡通信带宽远低于理论值（如 SDMA < 2GB/s）。
- 定性：通常为小包通信（ZeRO3 切分过细）、SDMA 地址未对齐或硬件问题。

3. 硬性约束 (MUST DO)

执行已有脚本，严禁造轮子：微观下钻环节（Step 3）必须且只能通过在终端执行 scripts/ 下的对比脚本获取差异数据。严禁在未执行脚本前自行读取 CSV/DB 进行 Diff 分析。
禁止 Trace 分析：本技能流程不包含 Timeline 级分析，Step 4 输出报告后立即结束，禁止主动读取 trace_view.json。

4. 标准操作流程 (SOP)

宏观体检：强制调用 msprof-analyze-advisor 工具输入集群路径，获取总体耗时极差与“慢卡分析”矩阵。
瓶颈定性：对照【先验知识库】，判定核心瓶颈属于 Host下发慢、计算慢 还是 纯通信慢，并锁定真正的“慢卡 RankID”。
微观下钻：根据瓶颈类型，在终端直接执行下方对应的对比脚本（计算慢用 OP 脚本，下发慢用 API 脚本）。仅当路径自动发现失败报错时，才可通过补充 --slow-path 参数重试。
输出报告：按以下结构输出最终回复：
- 诊断结论：瓶颈类型及真正慢卡的 RankID。
- 宏观证据：引用 Advisor 报告中的极差数据（如 Free Time 对比）。
- 微观根因：结合脚本输出的 Top 差异数据（特定 API 或算子的耗时比对），解释物理原因。
- 优化建议：给出针对性建议（如绑核、切分策略、排查算子Shape差异等）。

5. 脚本调用手册

对比脚本统一存放在本技能目录的 scripts/ 文件夹中，支持自动发现集群目录或手动指定文件（优先 CSV，次选 DB）。

核心命令模板：

# 【计算类瓶颈】调用算子对比脚本（将 <本技能目录> 替换为 get_skill 返回中的路径）
python <本技能目录>/scripts/compare_op_stats.py <集群数据根目录> <慢卡RankID> <快卡RankID> [--top N]

# 【下发类瓶颈】调用 API 对比脚本
python <本技能目录>/scripts/compare_api_stats.py <集群数据根目录> <慢卡RankID> <快卡RankID> [--top N]

参数说明：

cluster_pah: 集群数据根目录（包含 profiler_info_{rank}.json）。
slow_rank / fast_rank: 慢卡与快卡（基准）的 Rank ID。
--top N: （可选）输出差异最大的前 N 条，默认 20。
--slow-path / --fast-path: （可选）当集群自动发现机制报错时，用于手动指定慢/快卡的 *.csv 或 *.db 绝对路径。
--json: （可选）以 JSON 格式结构化输出。