ops-cli-and-host-tools
Operate ODS operator CLI, lifecycle, diagnostics, backup/restore, host-agent, remote-provider, mDNS, and memory-shepherd surfaces safely.
- License 许可
- Apache-2.0
- 最近更新
- 2026-10-08
- Stars
- ★ 11
- Forks
- 3
01 前言 Front Matter
- name
- ops-cli-and-host-tools
- license
- Apache 2.0
- metadata
- { "disco-role": "operating" }
- description
- Operate ODS operator CLI, lifecycle, diagnostics, backup/restore, host-agent, remote-provider, mDNS, and memory-shepherd surfaces safely.
- disable-model-invocation
- true
02 资源文件 3
- 参考文档references/cli-operations.md9.8 KB
- 参考文档references/diagnostics.md9.7 KB
- 参考文档references/troubleshooting.md7.9 KB
03 SKILL.md 正文
ODS ops CLI and host tools sub-skill
Use this sub-skill when an ODS task touches the ods operator CLI, lifecycle commands, logs, configuration commands, mode/model command syntax, extension enable/disable/audit commands, backup/restore/update/uninstall helpers, doctor/support-bundle diagnostics, host-agent, mDNS, remote-provider helpers, or memory-shepherd.
Do not use this sub-skill for installer phase internals; route those to installers-and-platforms. Do not use it for service manifest schema or compose-extension design; route those to services-and-extensions. Do not use it for GPU tier/model catalog internals; route those to hardware-and-models. Do not use it for dashboard route/UI implementation except where a host-agent or remote-provider CLI boundary is the task. Route release-lane selection to testing-and-release after identifying the touched ops surface.
Operating workflow
-
Read
references/cli-operations.mdbefore changing or advising onods-cli,ods-backup.sh,ods-restore.sh,ods-update.sh, orods-uninstall.sh. It marks command families ashelp-only,read-only, ormutatingand records focused validation hints. -
Read
references/diagnostics.mdforods doctor, support bundles, host-agent endpoints, mDNS, remote-provider, and memory-shepherd behavior. -
Read
references/troubleshooting.mdwhen symptoms involve Docker access, stale compose flags, secret masking, rootless ownership, host-agent auth, remote-provider lifecycle, backup/restore, mDNS, update rollback, or memory-shepherd resets. -
To inspect a local ODS CLI dispatch surface without running the CLI, use the bundled read-only helper:
python3 scripts/check_cli_surface.py --ods-cli <ODS_TREE>/ods-cliAdd
--jsonfor machine-readable output and--strictwhen a new dispatch command should fail review unless it is classified.
Safety rules
- Prefer
--help,--dry-run,--json,list,status,plan, and static parsing before any command that changes files, containers, model state, remote peer state, or services. - Treat lifecycle commands (
start,stop,restart,update,rollback,restore,uninstall,purge,repair,agent start|stop|restart) as host-mutating. Do not run them without explicit user intent and a suitable installed ODS target. - Treat
backupas write-producing andrestore/rollback/purge/uninstallas potentially destructive even when they include prompts. - Never put API keys, bearer tokens, remote-provider secrets, SSH private keys, or raw
.envcontents in public notes. Use streamed secret inputs and redacted support-bundle outputs. - When editing CLI behavior, keep Bash 4+,
set -euo pipefail, service aliases, compose flag regeneration,.envmasking, and remote-provider secret handling intact.
Common task routing
- CLI command syntax, top-level dispatch, help text, or command risk classification: use this sub-skill, then cross-check with
testing-and-releasefor the focused CLI/contract lane. - Extension enable/disable/audit operator behavior: use this sub-skill for
ods enable|disable|audit; cross-linkservices-and-extensionsfor manifest and compose semantics. - Model/mode operator commands: use this sub-skill for
ods mode,ods model, and remote-provider command syntax; usehardware-and-modelsfor tier maps, catalog facts, and runtime backend constraints. - Host-agent API/service management, mDNS, remote provider, or memory-shepherd host helpers: use this sub-skill first, then route dashboard-facing API/UI details to
dashboard-and-apiif the task crosses into those services.
Source provenance
This runtime guidance distills evidence from relative ODS source paths such as ods/ods-cli, ods/ods-backup.sh, ods/ods-restore.sh, ods/ods-update.sh, ods/ods-uninstall.sh, ods/scripts/ods-doctor.sh, ods/scripts/ods-support-bundle.sh, ods/bin/ods-host-agent.py, ods/bin/ods-mdns.py, ods/bin/remote_provider/, ods/memory-shepherd/, ods/docs/ODS_CLI_DECOMPOSITION.md, and CLI/doctor/backup/remote-provider/mDNS tests. Future usage should rely on this bundled guidance, the bundled read-only helper, and public ODS commands/tests.
04 同仓库更多 Skills
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
python-api
Programmatic Object-Detection-Metrics API guidance for BoundingBox, BoundingBoxes, Evaluator, enums, coordinate conversion, AP/mAP semantics, and source-style import diagnostics.
file-evaluation
Folder-based PASCAL VOC AP/mAP evaluation from ground-truth and detection text files.
object-detection-metrics
Guides legacy Object-Detection-Metrics PASCAL VOC AP/mAP evaluation from detection text folders and direct Python API classes.
nx-workspace-patterns
Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.