Menu
在 Ascend 上定位 HIXL/ADXL/HIXL_CS 建链、传输问题。适用于用户明确要求诊断 HIXL，或日志中出现 HIXL、ADXL、HIXL_CS、HixlCSClient、Ascend direct transport 相关报错。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | hixl-troubleshoot |
| description | 在 Ascend 上定位 HIXL/ADXL/HIXL_CS 建链、传输问题。适用于用户明确要求诊断 HIXL，或日志中出现 HIXL、ADXL、HIXL_CS、HixlCSClient、Ascend direct transport 相关报错。 |
| license | CANN Open Software License Agreement Version 2.0 |
你是 HIXL 部署与运行时问题 的定位专家。根据用户提供的环境信息、运行日志，结合 Wiki，多仓库源码，判断问题最可能落在哪一个阶段、哪一条传输路径以及哪一层组件，是否是BUG。
Issue日志获取章节依赖仓库拉取章节deps.sh 拉取 ~/hixl-troubleshooting/hixl.wiki；references/differential-diagnosis.md 定义结论证据门槛和高歧义现象的判别证据一定要结合代码进行定位，如果代码和日志行数不一致，要去查看历史代码是否有bug（可能后续修复了），如果后续修复了，告诉用户应该升级到什么时候的版本
npu-smi info；910B=A2，910=A3。/root/ascend/log。log-triage.sh，必须按 plog 时间戳而不是文件名顺序锁定首个 HIXL 相关错误；双端使用显式 source 标签。查看 HcclCommPrepare 的同一 comm[...] 下发时间差、对端更早的 DRV/HCCP/RUNTIME 首错和时钟偏差提示。hixl-transfer-paths.md 判引擎/路径，再判建链或传输。应用层 503900、transfer failed、stream timeout 只是一层症状，必须继续追底层首错。differential-diagnosis.md 建立候选假设集。对每个高歧义症状写出支持证据、反证和下一条判别证据；关键词命中 Wiki 只能生成假设，不能直接作为结论。source-align.sh 记录每个仓的 SHA 和对齐方式。结合代码和日志要充分怀疑代码是否有 BUG：追到报错触发处的具体代码逻辑、追溯关键变量来源，并横向比较同类实现。发现同类实现不一致或逻辑经不起推敲时，代码 BUG 优先于环境问题。确认 BUG 前必须说清文件、函数、源码 ref；日期近似对齐不能断言某个 CANN 版本已修复。env-check.md 执行最小必要检查。不得由应用层超时直接推断网络、PFC、容器或环境问题。source / 文件:行号 / 时间戳诊断启动后立即执行；有网络时必须执行，不得跳过。
bash scripts/deps.sh
~/hixl-troubleshooting/runtime、hcomm、driver、hixl、hixl.wiki（gitcode.com/cann）git pull --ff-only日志与当前 master 的行号不一致时，必须先对齐源码；CANN 版本本身不能可靠地自动映射到每个仓的
commit。优先使用 issue、构建信息或用户提供的精确 ref：
bash scripts/source-align.sh \
--ref hixl=<commit-or-tag> \
--ref hcomm=<commit-or-tag>
没有精确 ref 时，可以按日志/构建日期选择不晚于该日期的历史提交，但输出必须标记为
date-approximation：
bash scripts/source-align.sh --before 2026-06-16
脚本不 checkout 工作树。用其输出的 SHA 通过 git -C <repo> show <sha>:<path> 和
git -C <repo> grep <pattern> <sha> -- <path> 查看历史代码；日期近似不能据此承诺具体升级版本。
bash scripts/download-issue-logs.sh cann hixl <issue_no>
脚本已把 attachment_urls.txt 写到
~/hixl-troubleshooting/issues/cann-hixl-<issue_no>/。
如果issue无附件日志，跳过步骤二和步骤三，直接使用issue正文日志或者图片进行定位。
目标（具体工具因 agent 而异，Playwright MCP / Puppeteer / Cursor browser 等均可）：
在已登录 gitcode.com 的浏览器会话中，打开
https://gitcode.com/cann/hixl/issues/<issue_no>，执行 JS 读取localStorage.getItem('access_token')，得到 web JWT 字符串。 若为空/null，提示用户在浏览器中登录 gitcode 一次后重试。 拿到 JWT 后执行save-gitcode-jwt.sh缓存，再重跑步骤 1。
bash scripts/save-gitcode-jwt.sh '<jwt>'
bash scripts/download-issue-logs.sh cann hixl <issue_no>
JWT 缓存在 ~/.hixl-troubleshoot/gitcode_access_token（约 24h 过期；HTTP 401/403 时清缓存并重取）。
告知用户：当前 issue 有日志附件（共 N 个，链接见 attachment_urls.txt 或 issue 页
https://gitcode.com/cann/hixl/issues/<issue_no>），需自行下载并解压，请提供解压后的日志目录路径。
收到路径后继续步骤 3，对该路径跑 log-triage。
用户提供或自动下载的 plog 目录；双端建链问题必须优先同时输入两端：
# 单端
bash scripts/log-triage.sh <plog目录>
# 双端
bash scripts/log-triage.sh \
--source P=<P端plog目录> \
--source D=<D端plog目录>
自动下载时默认目录为 ~/hixl-troubleshooting/issues/cann-hixl-<issue_no>/extracted（zip 内可能有子目录，指向实际 plog 路径即可）。
脚本会对无法按时间戳归并、单端日志和跨端时钟未同步给出限制提示；这些提示必须反映在结论置信度中。
HIXL 代码检视技能。用于检视 GitCode 上的 HIXL 项目 PR，当用户要求检视PR，审查PR时调用此skill。 自动分析代码变更，检查内存泄漏、安全漏洞和可读性，生成结构化报告并发布评论。
HIXL 本地开发闭环：改码、按范围跑 UT、增量覆盖率估算、PR 前检视；开 PR 后配合既有 gitcode-pipeline 盯 CI，并基于 OpenLiBing 修复低级错误。修改 HIXL 源码/测试/构建脚本、 本地验证、/hixl-dev、CI 失败修复时使用。创建 PR 用 gitcode-pr，流水线轮询用 gitcode-pipeline。
触发 GitCode PR 流水线，并循环查询流水线状态直到完成。当用户提到触发流水线、查看流水线状态、等待流水线结果、流水线失败、盯一下流水线、盯ci、看一下pr 12306的ci时自动使用此 skill。
用于生成对外api文档，当用户说生成接口文档，生成接口说明，增加接口说明，增加接口文档时使用该skill
读取 GitCode issue 详情和评论。当用户提到 GitCode issue 时必须使用此技能。 **必须触发此 skill 的场景**： - 查看/读取 issue：查看issue、看看issue、读取issue、打开issue、issue详情、issue是什么 - GitCode URL：gitcode.com/**/issues/**、issue链接 - 直接说编号：issue 123、#123、问题123 - 查看评论：issue评论、评论内容 **重要**：不要使用 WebFetch 或 curl，内容通过 JavaScript 动态加载。使用 GitCode API 获取。
使用 GitCode API 创建 Pull Request 和获取 PR 评论。当用户需要**创建** GitCode PR、将代码**推送并创建合并请求**、**获取 PR 评论**、**查看 PR 讨论**、**查看 PR 改动**或**删除 PR 评论**时使用此 skill。支持读取普通评论和行内(diff)评论，包括评论内容、文件路径、代码行号等详细信息。 **必须触发此 skill 的场景**（用户提到以下任何内容时使用）： - 创建/提交 PR：创建PR、提个PR、发PR、做个PR、帮我PR、生成PR、需要PR、pull request、merge request - 推送代码到远程：push代码、推代码、把代码推上去、提交到远程、推送到gitcode、提交代码到GitCode - 合并请求：合并请求、代码合入请求、请求合并、merge request - PR模板/描述：PR模板、PR描述、PR格式 - 关联issue创建PR：关issue的PR、关联issue创建PR - 获取PR改动：查看PR变更、PR文件列表、PR改了什么、看PRdiff、获取PR文件 - **获取 PR 评论**：查看PR评论、PR评论、获取评论、read comments - **查看 PR 讨论**：PR discussions、查看讨论、discussions - **删除 PR 评论**：删除评论、删除PR评论、移除评论、delete comment、移除这条评论