inspire

Category: Tools & Productivity | Uploader: realZillionX | Downloads: 0 | Version: v1.0（Latest）

Execution-first Inspire platform playbook for agents driving the inspire CLI as a black-box tool, with on-demand references for platform workflows.

Changelog: Source: GitHub https://github.com/realZillionX/InspireSkill

Directory Structure

Current level: tree/main/

📁 .github/
- 📁 workflows/
  - 📄 publish.yml 1.4 KB
📁 assets/
- 📄 hero.svg 9.0 KB
📁 cli/
- 📁 examples/
  - 📁 workflows/
    
    📄 retrieve_job_log.yml 3.0 KB
    
    📄 run_bridge_action.yml 4.8 KB
- 📁 inspire/
  - 📁 accounts/
    
    📄 __init__.py 1.2 KB
    
    📄 normalize.py 9.3 KB
    
    📄 storage.py 5.0 KB
  - 📁 bridge/
    
    📁 tunnel/
    
    📄 __init__.py 1.5 KB
    
    📄 config.py 3.6 KB
    
    📄 models.py 6.0 KB
    
    📄 rtunnel.py 5.0 KB
    
    📄 scp.py 2.7 KB
    
    📄 ssh.py 7.2 KB
    
    📄 ssh_exec.py 9.1 KB
    
    📄 __init__.py 69 B
    
    📄 forge.py 23.6 KB
  - 📁 cli/
    
    📁 commands/
    
    📁 account/
    
    📄 __init__.py 1.0 KB
    
    📄 add.py 6.9 KB
    
    📄 current.py 647 B
    
    📄 list_cmd.py 634 B
    
    📄 remove.py 1.0 KB
    
    📄 use.py 657 B
    
    📁 config/
    
    📄 __init__.py 479 B
    
    📄 check.py 10.2 KB
    
    📄 context.py 8.1 KB
    
    📄 env_cmd.py 2.7 KB
    
    📄 show.py 9.6 KB
    
    📁 hpc/
    
    📄 __init__.py 616 B
    
    📄 hpc_commands.py 18.6 KB
    
    📄 hpc_events.py 2.6 KB
    
    📄 hpc_metrics.py 1.8 KB
    
    📁 image/
    
    📄 __init__.py 1.5 KB
    
    📄 image_commands.py 24.0 KB
    
    📁 init/
    
    📄 __init__.py 484 B
    
    📄 discover.py 97.9 KB
    
    📄 env_detect.py 5.2 KB
    
    📄 errors.py 1.2 KB
    
    📄 init_cmd.py 12.7 KB
    
    📄 json_report.py 2.8 KB
    
    📄 templates.py 9.3 KB
    
    📄 toml_helpers.py 3.1 KB
    
    📁 job/
    
    📄 __init__.py 772 B
    
    📄 job_commands.py 44.2 KB
    
    📄 job_create.py 10.8 KB
    
    📄 job_deps.py 392 B
    
    📄 job_events.py 6.5 KB
    
    📄 job_logs.py 27.9 KB
    
    📄 job_metrics.py 1.8 KB
    
    📁 model/
    
    📄 __init__.py 575 B
    
    📄 model_commands.py 7.1 KB
    
    📁 notebook/
    
    📄 __init__.py 3.5 KB
    
    📄 connection_test_cmd.py 3.6 KB
    
    📄 connections_cmd.py 4.0 KB
    
    📄 forget_cmd.py 2.0 KB
    
    📄 install_deps.py 12.4 KB
    
    📄 notebook_commands.py 26.9 KB
    
    📄 notebook_create_flow.py 28.8 KB
    
    📄 notebook_events.py 3.3 KB
    
    📄 notebook_lifecycle.py 3.9 KB
    
    📄 notebook_lookup.py 16.1 KB
    
    📄 notebook_metrics.py 2.6 KB
    
    📄 notebook_presenters.py 4.6 KB
    
    📄 notebook_ssh_flow.py 29.6 KB
    
    📄 refresh_cmd.py 4.7 KB
    
    📄 remote_exec.py 25.7 KB
    
    📄 remote_scp.py 6.6 KB
    
    📄 remote_shell.py 9.8 KB
    
    📄 top.py 12.4 KB
    
    📁 project/
    
    📄 __init__.py 797 B
    
    📄 project_commands.py 22.2 KB
    
    📁 ray/
    
    📄 __init__.py 978 B
    
    📄 ray_commands.py 30.2 KB
    
    📁 resources/
    
    📄 __init__.py 418 B
    
    📄 resources_list.py 29.0 KB
    
    📄 resources_nodes.py 7.7 KB
    
    📄 resources_specs.py 13.7 KB
    
    📄 table.py 2.5 KB
    
    📁 serving/
    
    📄 __init__.py 1.0 KB
    
    📄 serving_commands.py 9.8 KB
    
    📄 serving_metrics.py 1.5 KB
    
    📁 user/
    
    📄 __init__.py 446 B
    
    📄 user_commands.py 6.1 KB
    
    📄 __init__.py 928 B
    
    📄 run.py 10.3 KB
    
    📄 update.py 12.9 KB
    
    📁 formatters/
    
    📄 __init__.py 546 B
    
    📄 human_formatter.py 12.1 KB
    
    📄 json_formatter.py 1.2 KB
    
    📁 utils/
    
    📄 __init__.py 254 B
    
    📄 auth.py 2.5 KB
    
    📄 errors.py 1.4 KB
    
    📄 events.py 7.3 KB
    
    📄 id_resolver.py 10.3 KB
    
    📄 job_cli.py 6.2 KB
    
    📄 job_submit.py 7.6 KB
    
    📄 metrics_plot.py 9.8 KB
    
    📄 metrics_shared.py 20.3 KB
    
    📄 notebook_cli.py 1.8 KB
    
    📄 notebook_post_start.py 5.5 KB
    
    📄 output.py 1.5 KB
    
    📄 profile.py 1.1 KB
    
    📄 quota_resolver.py 10.1 KB
    
    📄 tunnel_reconnect.py 6.9 KB
    
    📄 update_notice.py 6.1 KB
    
    📄 __init__.py 133 B
    
    📄 context.py 843 B
    
    📄 logging_setup.py 6.3 KB
    
    📄 main.py 4.0 KB
  - 📁 config/
    
    📁 options/
    
    📄 __init__.py 60 B
    
    📄 api.py 4.7 KB
    
    📄 forge.py 2.2 KB
    
    📄 infra.py 2.7 KB
    
    📄 project.py 3.6 KB
    
    📄 __init__.py 1.9 KB
    
    📄 env.py 2.4 KB
    
    📄 load.py 5.6 KB
    
    📄 load_account_layer.py 6.1 KB
    
    📄 load_accounts.py 1.6 KB
    
    📄 load_common.py 7.6 KB
    
    📄 load_env.py 5.9 KB
    
    📄 load_layers.py 5.2 KB
    
    📄 load_runtime.py 4.0 KB
    
    📄 models.py 6.7 KB
    
    📄 path_aliases.py 5.1 KB
    
    📄 schema.py 2.6 KB
    
    📄 schema_categories.py 302 B
    
    📄 schema_models.py 2.1 KB
    
    📄 toml.py 1.3 KB
    
    📄 workspaces.py 3.9 KB
  - 📁 platform/
    
    📁 openapi/
    
    📄 __init__.py 879 B
    
    📄 auth.py 1.3 KB
    
    📄 client.py 12.8 KB
    
    📄 endpoints.py 1.8 KB
    
    📄 errors.py 2.1 KB
    
    📄 hpc_jobs.py 7.4 KB
    
    📄 http.py 5.9 KB
    
    📄 inference_servings.py 5.1 KB
    
    📄 jobs.py 5.7 KB
    
    📄 models.py 746 B
    
    📄 nodes.py 3.2 KB
    
    📁 web/
    
    📁 browser_api/
    
    📁 availability/
    
    📄 __init__.py 701 B
    
    📄 api.py 16.3 KB
    
    📄 models.py 1.1 KB
    
    📄 select.py 4.7 KB
    
    📄 __init__.py 4.8 KB
    
    📄 core.py 4.9 KB
    
    📄 hpc_jobs.py 5.5 KB
    
    📄 images.py 11.3 KB
    
    📄 jobs.py 12.8 KB
    
    📄 metrics.py 7.3 KB
    
    📄 models.py 4.9 KB
    
    📄 notebooks.py 24.5 KB
    
    📄 playwright_notebooks.py 10.2 KB
    
    📄 projects.py 13.6 KB
    
    📄 ray_jobs.py 14.1 KB
    
    📄 rtunnel.py 71.3 KB
    
    📄 servings.py 6.2 KB
    
    📄 users.py 3.0 KB
    
    📄 workspaces.py 2.3 KB
    
    📁 session/
    
    📄 __init__.py 7.2 KB
    
    📄 auth.py 13.3 KB
    
    📄 browser_client.py 4.9 KB
    
    📄 models.py 5.4 KB
    
    📄 proxy.py 4.4 KB
    
    📄 requests.py 2.1 KB
    
    📄 workspace.py 5.2 KB
    
    📄 __init__.py 53 B
    
    📄 resources.py 8.0 KB
    
    📄 __init__.py 58 B
  - 📄 __init__.py 60 B
  - 📄 compute_groups.py 1.7 KB
- 📁 scripts/
  - 📁 reverse_capture/
    
    📄 analyze.py 4.8 KB
    
    📄 capture.py 17.5 KB
    
    📄 known_endpoints.py 5.2 KB
    
    📄 README.md 5.2 KB
  - 📄 bootstrap_inspire_env.sh 451 B
  - 📄 inspire.env.template 328 B
- 📁 tests/
  - 📄 __init__.py 20 B
  - 📄 conftest.py 3.4 KB
  - 📄 test_account_commands.py 14.4 KB
  - 📄 test_account_normalize.py 6.4 KB
  - 📄 test_bridge_exec.py 57.0 KB
  - 📄 test_bridge_scp.py 14.4 KB
  - 📄 test_browser_api_jobs.py 2.3 KB
  - 📄 test_browser_api_metrics.py 9.9 KB
  - 📄 test_browser_api_ray_jobs.py 16.6 KB
  - 📄 test_browser_api_servings.py 7.1 KB
  - 📄 test_cli_commands.py 70.4 KB
  - 📄 test_cli_smoke.py 2.7 KB
  - 📄 test_config_files.py 59.1 KB
  - 📄 test_debug_logging.py 4.1 KB
  - 📄 test_error_utils.py 4.0 KB
  - 📄 test_forge_utils.py 9.3 KB
  - 📄 test_hpc_commands.py 11.5 KB
  - 📄 test_id_resolver.py 5.5 KB
  - 📄 test_image_commands.py 35.6 KB
  - 📄 test_init_command.py 1.6 KB
  - 📄 test_init_encoding.py 2.2 KB
  - 📄 test_main_help.py 995 B
  - 📄 test_notebook_commands.py 58.3 KB
  - 📄 test_notebook_create_flow.py 15.7 KB
  - 📄 test_notebook_install_deps.py 8.4 KB
  - 📄 test_notebook_jupyter.py 7.9 KB
  - 📄 test_notebook_metrics.py 12.6 KB
  - 📄 test_notebook_post_start.py 2.6 KB
  - 📄 test_notebook_rtunnel_flow.py 6.9 KB
  - 📄 test_notebook_rtunnel_helpers.py 33.1 KB
  - 📄 test_notebook_rtunnel_probe.py 5.9 KB
  - 📄 test_notebook_rtunnel_verify.py 924 B
  - 📄 test_notebook_top.py 6.8 KB
  - 📄 test_notebook_wait.py 4.4 KB
  - 📄 test_openapi_client_config.py 2.9 KB
  - 📄 test_openapi_hpc_jobs.py 3.9 KB
  - 📄 test_openapi_inference_servings.py 7.8 KB
  - 📄 test_openapi_jobs.py 6.1 KB
  - 📄 test_openapi_proxy_config.py 3.5 KB
  - 📄 test_project_list_commands.py 8.7 KB
  - 📄 test_project_selection.py 15.3 KB
  - 📄 test_quota_resolver.py 7.8 KB
  - 📄 test_resource_metrics_variants.py 9.6 KB
  - 📄 test_resources_specs_command.py 15.2 KB
  - 📄 test_rtunnel_binary.py 2.1 KB
  - 📄 test_serving_commands.py 1.9 KB
  - 📄 test_ssh_exec.py 8.1 KB
  - 📄 test_tunnel_reconnect.py 4.4 KB
  - 📄 test_update_installer_detection.py 2.4 KB
  - 📄 test_utils.py 24.8 KB
  - 📄 test_web_config_resolution.py 1.9 KB
  - 📄 test_web_session.py 25.8 KB
  - 📄 test_web_session_proxy.py 3.4 KB
  - 📄 test_workspace_selection.py 4.6 KB
- 📄 pyproject.toml 2.2 KB
- 📄 README.md 12 B
- 📄 uv.lock 371.4 KB
📁 references/
- 📄 browser-api.md 32.1 KB
- 📄 compute-workloads.md 5.0 KB
- 📄 less-used-commands.md 3.9 KB
- 📄 notebook.md 3.9 KB
- 📄 openapi.md 10.5 KB
- 📄 proxy-setup.md 4.2 KB
- 📄 resources-and-paths.md 3.3 KB
- 📄 troubleshooting.md 6.7 KB
- 📄 workflows.md 2.9 KB
📁 scripts/
- 📄 install.sh 10.4 KB
📄 .gitignore 436 B
📄 LICENSE 1.0 KB
📄 README.md 22.3 KB
📄 SKILL.md 7.6 KB

SKILL.md

---
name: inspire
description: "Execution-first Inspire platform playbook for agents driving the inspire CLI as a black-box tool, with on-demand references for platform workflows."
---

# Inspire Skill

## 1. 常驻硬约束

把 `inspire` CLI 当黑盒使用。不要读 CLI 源码来猜平台状态；状态、事件、日志、资源余量都通过命令实时查询。

| 主题 | 约束 |
| --- | --- |
| 输出观察面 | Agent 默认使用人类格式。人类输出更短，隐藏低价值 raw ID，适合直接决策。`--json` 只是脚本接口；只有写脚本、接 `jq` 或必须消费结构化字段时才使用。 |
| 代理配置 | 代理通过 `inspire account add`、账号级 config、`inspire config show` 和 `inspire config check` 管理。任务命令直接写 `inspire <cmd>`，CLI 会读取持久配置。 |
| 项目路径 | 项目远端路径通过 `inspire init --discover` 写入仓库级 `.inspire/config.toml`。日常命令直接用 notebook name、job name 和配置内路径。 |
| 实时事实源 | `job list`、`notebook list`、`resources specs/list/nodes` 等状态查询以平台实时结果为准。本地 cache 只能当 SSH 会话、事件副本等非权威辅助信息。 |
| 资源申请 | 先查实时空余，再按真实需求申请。不要因为模型保守而主动缩小规模；只有调度语义、项目配额或实时空余明确不足时才降档。 |
| 默认 workspace | 默认只主动使用 `CPU 资源空间` 和 `分布式训练空间`。其它 workspace 需要仓库级 `INSPIRE.md` 或用户明确指定。 |
| 优先级 | `--priority` 接受 $$1$$ 到 $$10$$。$$1$$ 到 $$3$$ 是低优先级，$$4$$ 是普通优先级，$$5$$ 到 $$10$$ 是高优先级。需要稳定运行时传 $$5$$ 或更高，并用 `inspire job status <name>` 核对人类输出中的优先级。 |
| 排错入口 | 任务 PENDING、CREATING 过久或 FAILED 原因不明时，第一步查 `inspire <res> events <name>`。不要凭猜测重提。 |
| 清理 | 终态且不再需要的资源用 `<res> delete <name> --yes` 清理；running 先 stop。不确定是否仍有人使用时跳过。 |
| 大操作 | 共享盘大规模 `mv`、`cp`、`rm` 前先看文件量和大小分布。超过 $$20$$ 分钟的远程操作用后台任务和 sentinel 文件，不要让 `notebook exec` 长时间同步挂住。 |

## 2. 基础命令入口

### 2.1 账号、配置、资源

| 命令 | 用途 |
| --- | --- |
| `inspire account add <name>` | 添加账号、平台地址和代理配置，并可设为活动账号 |
| `inspire account {list,use,current,remove}` | 多账号管理 |
| `inspire init --discover` | 在当前仓库绑定 Inspire 项目、workspace、compute group 和远端路径 |
| `inspire config show --compact` | 查看合并后的账号、代理、镜像和路径配置 |
| `inspire config context` | 查看活动账号、当前项目、workspace alias 和 compute groups |
| `inspire config check` | 检查认证和平台连通性 |
| `inspire resources list --all --include-cpu` | 查实时 GPU/CPU 可用量 |
| `inspire resources nodes -A` | 查整节点空余 |
| `inspire resources specs --usage all` | 查 notebook、job、HPC、Ray 可用规格三元组 |
| `inspire project list` | 查项目配额、预算和优先级 |
| `inspire user whoami` | 查当前登录身份 |
| `inspire user permissions --workspace <name>` | 查 workspace 权限码 |

### 2.2 Notebook

| 命令 | 用途 |
| --- | --- |
| `inspire notebook list -A` | 列 notebook，默认看人类表格 |
| `inspire notebook create --workspace X --group Y -q <gpu,cpu,mem> --image URL --project P --wait` | 创建实例并等待 RUNNING |
| `inspire notebook status <name>` | 查实例详情 |
| `inspire notebook events <name>` | 查生命周期事件 |
| `inspire notebook ssh <name>` | 建立 SSH 通路 |
| `inspire notebook exec <name> "<cmd>"` | 运行一次性远程命令 |
| `inspire notebook shell <name>` | 打开持久交互 shell |
| `inspire notebook scp <name> <src> <dst>` | 传非 Git 文件，远端路径优先写绝对路径 |
| `inspire notebook {start,stop,delete} <name> --yes` | 生命周期操作 |
| `inspire notebook test <name>` | 连通性测试 |

Notebook 细节、镜像固化、远程命令语义和大文件操作：加载 [references/notebook.md](references/notebook.md)。

### 2.3 Job、HPC、Ray

| 命令 | 用途 |
| --- | --- |
| `inspire job create -n <name> -q <gpu,cpu,mem> --nodes N -c "<cmd>" --workspace X --group Y --image URL --priority 5` | 创建 GPU 多节点任务 |
| `inspire run "<cmd>" -q <gpu,cpu,mem> --nodes N --workspace X --group Y --image URL --watch` | 快速提交 GPU job 并跟日志 |
| `inspire job {list,status,logs,events,stop,delete} <name>` | 观测、止损和清理 GPU job |
| `inspire hpc create -n <name> -c "<slurm-body>" --compute-group G --workspace X -q <gpu,cpu,mem> --project P --image URL --image-type SOURCE_PRIVATE` | 创建 CPU Slurm/HPC 任务 |
| `inspire hpc {list,status,events,metrics,stop,delete} <name>` | 观测、止损和清理 HPC 任务 |
| `inspire ray create ...` | 创建 Ray 集群；仅在明确需要弹性计算时使用 |
| `inspire ray {list,status,events,instances,stop,delete} <name>` | 观测、止损和清理 Ray 集群 |

GPU job、HPC 两层资源模型、Ray 适用边界和示例：加载 [references/compute-workloads.md](references/compute-workloads.md)。

### 2.4 镜像和较少使用命令

| 命令 | 用途 |
| --- | --- |
| `inspire image list --source all` | 浏览镜像 |
| `inspire image save <notebook-name> -n X -v v1 --public --wait` | 从 notebook 保存镜像 |
| `inspire image set-default --job URL --notebook URL` | 写入项目默认镜像 |
| `inspire serving list`、`inspire model list`、`inspire user api-keys` | 权限受限或低频只读命令 |

低频命令加载 [references/less-used-commands.md](references/less-used-commands.md)。

## 3. 按需加载索引

| 什么时候加载 | 引用 |
| --- | --- |
| 需要选择 workspace、compute group、规格三元组、存储池或远端路径 | [references/resources-and-paths.md](references/resources-and-paths.md) |
| 要创建、连接、执行、传文件、保存镜像或维护 notebook | [references/notebook.md](references/notebook.md) |
| 要提交 GPU job、CPU HPC、Ray，或解释优先级和调度事件 | [references/compute-workloads.md](references/compute-workloads.md) |
| 要按 CPU 准备、数据处理、训练三阶段推进项目 | [references/workflows.md](references/workflows.md) |
| SSH bootstrap、rtunnel、HPC 异常、大规模文件操作或失败排障 | [references/troubleshooting.md](references/troubleshooting.md) |
| 代理方案、Clash Verge 示例和账号级代理配置 | [references/proxy-setup.md](references/proxy-setup.md) |
| OpenAPI 合约或 Browser API 端点背景 | [references/openapi.md](references/openapi.md)、[references/browser-api.md](references/browser-api.md) |

## 4. `--quota` 通用格式

`notebook create`、`job create`、`run`、`hpc create`、`ray create --head-quota` 和 Ray worker 的 `quota=` 都使用三元组：

```bash
<gpu>,<cpu>,<mem>
```

`mem` 以 GiB 计。CPU-only 写成 `0,<cpu>,<mem>`。三元组必须在当前 workspace 可见规格中唯一匹配；多个 compute group 撞上同一三元组时，加 `--group <name>` 或对应命令的 compute group 参数消歧。先用：

```bash
inspire resources specs --usage all
```

## 5. 项目上下文

仓库根可用 `INSPIRE.md` 记录非配置性上下文，建议包含：

- `Default Image`
- `Path Conventions`
- `Public Directory Layout`
- `Existing Notebooks`
- `Ongoing Jobs`

不要把账号配置、密码、代理密钥或 `.inspire/config.toml` 内容复制进 `INSPIRE.md`。配置由 CLI 合并和展示。

Comments 0

Latest | Hot

Please login before commenting.

Loading comments...

inspire

Directory Structure

SKILL.md

Report

Notice