HIXL Agent Skills

Skills 列表

Skill	功能	触发场景
api-doc-generator	API 文档生成	用户说生成接口文档、生成接口说明、增加接口说明、增加接口文档
gitcode-issue	GitCode Issue 读取	查看/读取 issue、GitCode issue URL、直接说编号（issue 123、#123）、查看 issue 评论
gitcode-pipeline	GitCode PR 流水线管理	触发流水线、查看流水线状态、等待流水线结果、流水线失败、盯 CI、看一下 PR 的 CI
gitcode-pr	GitCode PR 创建与管理	创建 PR、推送代码到远程、合并请求、PR 模板/描述、关联 issue 创建 PR、获取 PR 改动、获取/查看/删除 PR 评论、查看 PR 讨论
hixl-dev	HIXL 本地开发与验证	修改 HIXL 代码/测试、本地 UT、增量覆盖率；开 PR 后配合 gitcode-pipeline 跟进 CI 并修低级错误
hixl-troubleshoot	HIXL/ADXL 运行时问题定位	用户明确要求诊断 HIXL，或日志中出现 HIXL、ADXL、Ascend direct transport 相关报错或调用栈
hixl-pr-review	HIXL代码检视/审查	用户明确要求检视PR或审查PR
hixl-ut-generator	HIXL UT 生成	用户要求基于当前改动生成测试、补充 UT、或根据 git diff 编写测试用例
hixl-srs-doc-generator	HIXL 设计文档生成	用户要求生成设计文档、需求文档、设计方案，或描述新功能需求时

SKILL 命名规范

• SKILL.md 文件必须严格命名为 SKILL.md（区分大小写）
• Skill 文件夹使用 kebab-case 命名法，例如 hixl-troubleshoot
• Skill 的补充资料放在 references/ 、 scripts/ 或 assets/ 目录下，避免将说明散落在多个入口文件中

使用方式

安装

将 .agents/skills/ 目录放置到项目根目录下。支持 Agent Skills 规范 的工具（如 OpenCode 等）会自动扫描并加载这些 Skill。

触发方式

Skill 有两种触发方式：

1. 场景匹配：当用户的任务描述命中 Skill 的触发场景时，Agent 自动识别并调用对应 Skill。例如用户说“帮我分析这段 HIXL 建链失败日志”或“帮我检视一下这个PR：<PR链接>”，Agent 会匹配到对应的 Skill。
2. 指定调用：用户直接指定使用某个 Skill，例如 /hixl-troubleshoot 分析一下建链失败日志、/hixl-pr-review 检视一下PR：<PR链接>。

SKILL.md frontmatter 中的 description 定义了主要触发边界，也可参考 Skills 列表 中的"触发场景"列。

免责声明

1. 本目录中的 Agent Skills 内容仅供技术参考和学习使用，不代表其适用于任何生产环境或关键业务系统。
2. 开发者在使用时应自行评估其安全性、兼容性和适用性。作者及贡献者不对因使用本内容导致的任何直接或间接损失承担责任。
3. 部分诊断步骤可能依赖系统命令、设备环境或外部仓库信息，相关权限、网络与合规性需由开发者自行核实。
4. 除非另有明确约定，本目录所有内容均基于仓库当前许可证发布，不提供任何形式的技术支持或担保。