AugmentClaude

Inspire CLI

Manage machine learning workloads on the Inspire platform via command-line interface.

Installation

  1. Make sure Claude is on your device and in your terminal.

    Skills load from ~/.claude/skills/ when Claude Code starts up — so you need it on your machine first. If you don't have it yet, install it once with the command below, then run claude in any terminal to verify.

    One-time setup
    npm i -g @anthropic-ai/claude-code

    Already have it? Skip ahead.

  2. Paste into Claude Code or into your terminal.

    This copies the whole skill folder into ~/.claude/skills/inspire-realzillionx/ — the SKILL.md plus any scripts, reference docs, or templates the skill ships with. Safe default: works for every skill.

    Faster alternative (instruction-only skills)

    Skips the clone and grabs only the SKILL.md file. Don't use this if the skill ships Python scripts, reference markdowns, or asset templates — they won't be downloaded and the skill will fail when it tries to load them.

    Quick install (SKILL.md only)
    Sign up to copy
  3. Restart Claude Code.

    Quit and reopen Claude Code (or any other agent that loads from ~/.claude/skills/). New skills are picked up on startup.

  4. Just ask Claude.

    Skills auto-activate when your request matches the skill's description — no slash command needed. Trigger phrases live in the skill's own frontmatter; you can read them in the “What this skill does” section above.

Prefer to read the source first? Open on GitHub.

When Claude uses it

Use for Inspire/启智平台 (qz.sii.edu.cn) through the inspire CLI: install/update, accounts, local SII proxy setup, INSPIRE.md project onboarding and upkeep, workspace/project/resource/path selection, Notebook, GPU Job, HPC, Ray, Serving, Image, Model Registry, observation, cleanup, and Inspire CLI Browser API maintenance. Use CLI Help for syntax and load only the focused reference.

What this skill does

Inspire Skill

inspire 是启智平台的本地 CLI。命令组、子命令、参数、默认值和示例以 inspire --helpinspire <group> --helpinspire <group> <subcommand> --help 为准;本文件只保留平台判断、项目上下文约定、最短执行闭环和 Reference 路由。

核心操作模型

执行前先把任务拆成四个平面:

平面绑定内容
调度条件workspaceprojectgroupquota、GPU/CPU/内存/Shared Memory 和 image,决定任务在哪里、以什么规格运行。
远端文件代码、数据、权重、Checkpoint 和产物的共享盘路径;Path Alias 只描述文件在哪里。
工作负载交互调试用 Notebook;固定 GPU 后台任务用 Job;CPU Slurm 批处理用 HPC;弹性 Worker、常驻或流式任务用 Ray;模型 HTTP 服务用 Serving。
观察收尾Events 看调度,Job Logs 看程序,Metrics / Instances 看实际工作单元,Status 看平台状态;其它 Workload 的应用日志按对应 Help 和共享盘约定处理。最后核验业务健康和产物,再清理资源。

创建 Workload 时显式绑定 workspaceprojectgroupquotaimage,或引用保存这五项的 Workload Profile;这些调度字段没有隐式默认值。选择资源时从同一条 Live Quota Row 复制完整 groupquota。GPU Job Shared Memory 是实例级资源,不能超过所选 Quota 的实例内存;细节见 references/compute-workloads.md。Workload Profile 保存调度条件,Path Alias 保存远端路径,两者不能互相替代。

Live 查询是账号、Workspace、Project、Compute Group、Quota、Image 和资源可用性的事实源;本地缓存只是加速层,可用 inspire cache status|refresh|clear 管理,不能当作资源事实。CLI 对 Agent 的稳定资源身份只有 Name 和 Alias;同名对象用 Workspace、可读候选和 --pick 消歧。

发现类列表和 Batch 结果默认最多展示 20 项,用命令自身的 --limit/-n 收窄或 --all 显式展开;Job 日志默认有行数和字符预算,截断时会给出已展示数量和继续获取完整结果的选项。需要结构化输出时使用根级 inspire --json ...,输出始终是单一 JSON 文档。

Workspace 判断:

  • CPU资源空间分布式训练空间 是所有用户默认可用的公共 Workspace:前者承担 CPU Notebook、联网准备、依赖安装、HPC 数据处理和 CPU Ray;后者承担 GPU Notebook、GPU Job、多节点训练、Serving 和 GPU 观察。
  • 其余 Workspace(项目专属空间、国产卡分区等)必须由用户亲自指认,并记录到项目上下文;不要因为列表可见就自行启用。
  • 分布式训练空间 通常没有公网:公网内容先在 CPU资源空间 准备,写入共享盘或固化成镜像,再供 GPU Workload 使用;判断细节见 references/internal-sources.md

项目上下文

进入一个具体科研或工程项目的工作区时,先核对项目上下文:INSPIRE.md./.inspire/ 项目配置。缺失或过期时不要直接开工,先主动向用户问清四件事——本仓库归属的 Project、需要指认的专属 Workspace、Paths(默认存储池与规范远端路径)、Image(项目基底镜像)——再执行 inspire init --scope project,并在符合条件时创建 INSPIRE.md。归属判断只能由用户确认,不从列表猜测。

INSPIRE.md 是具体项目工作区的资产合同,让不同 Agent、成员和会话共享稳定平台拓扑、Canonical Remote Paths、永久基础设施和资产身份;它不是 InspireSkill 安装产物,CLI、Skill 或通用工具源码仓库不创建。账号凭据、实时状态、日志和短期计划不进入该文件。

项目信息需要持续维护:保存新基底镜像、变更规范路径、指认新 Workspace、新增永久基础设施后,当场同步 INSPIRE.md 和项目配置;发现记录与 Live 查询漂移时以 Live 为准并修正。完整问询清单、初始化步骤和维护触发点见 references/project-context.md

最短执行闭环

  1. 项目工作区先核对项目上下文;缺失时按 references/project-context.md 问清并初始化。
  2. 根据用户目标加载一份最匹配的 Reference;跨边界时再加载第二份。
  3. 用 CLI Help 确认当前版本的真实命令表面。
  4. 用 Live 查询确认账号、Workspace、Project、Compute Group、Quota、Image 和资源可用性。
  5. 准备共享路径、代码和环境;复杂条件先 dry-run 或运行短 Probe。
  6. 提交匹配的 Workload。
  7. 按当前 Workload 的 Help 依次观察可用的 Events、Logs、Metrics、Instances 和 Status。
  8. 核验业务健康与产物完整性;本次产生的持久资产写回 INSPIRE.md
  9. 运行中的对象先 stop,再 delete;终态且不再需要的对象直接 delete,仍有当前或声明的未来消费者时保留。

按需加载索引

命令语法和参数始终回到 CLI Help。每次先加载最匹配的一份 Reference:

平台操作

用户问题或判断点先加载
安装、更新、账号、多账号切换、全局发现references/setup/install-and-config.md
本机 Clash Verge 的 *.sii.edu.cnSII Proxy / DIRECT 分流references/setup/sii-proxy.md
项目初始化、INSPIRE.md、Project / Workspace / Paths / Image 问询、项目信息持续维护references/project-context.md
Workspace、Compute Group、Quota、实时资源、优先级、Workload Profilereferences/resources.md
共享盘、存储池、挂载隔离、Path Aliasreferences/paths.md
联网准备、SII 内部源、依赖安装、镜像固化references/internal-sources.md
Notebook 创建、连接、跨账号解析、exec / shell / scp、IDE URL、文件流转references/notebook.md
GPU Job、CPU HPC、Ray、Serving,及提交后的观察、优先级与异常references/compute-workloads.md
CPU 准备、数据处理、GPU 训练、部署或交付的阶段化计划references/workflows.md
Image 选择、保存、注册、可见性和清理references/image.md
Model Registry、Model Version 与 Serving 的关系references/model.md

CLI 开发

仅在维护 CLI Browser API 封装、核对前端请求合同,或用户明确要求接口细节时加载 references/dev/browser-api-v1.md;涉及 /api/v2 Action 面时加载 references/dev/browser-api-v2.md

Related skills