alex-de-haas/docker-host

hosty-app-skill

Build, wrap, or update Hosty runtime apps.

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/alex-de-haas/docker-host --skill hosty-app-skill

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

Hosty App Skill

Use this skill to implement Hosty runtime apps in the shape expected by this repository. The supported contract is an app manifest with schemaVersion: "app.0.1".

Workflow

  1. Identify whether the user wants to create a new runtime app, wrap an existing app, update an app manifest, add Hosty identity/roles, configure data/backups, or validate an app.
  2. Treat docs/features/runtime-app-manifest/feature.md, docs/features/domain-model/feature.md, docs/features/auth-gateway/feature.md, apps/core/src/Haas.Hosty.Core/RuntimeAppManifest.cs, apps/core/src/Haas.Hosty.Core/CoreLifecycleService.cs, and apps/demo-app as source of truth when implementation details matter.
  3. Use apps/demo-app/manifest.json as the manifest shape and hosty apps install apps/demo-app --runtime dev as the local directory install pattern.

References

  • Read references/app-manifest.md when authoring or reviewing manifest.json, runtime profiles, service implementations, settings, storage, dependencies, endpoints, install/update behavior, or backups.
  • Read references/app-auth-and-users.md when adding app identity, app-owned roles, or scoped app directory access.
  • Read references/app-manifest.md ("MCP Interface") when adding or debugging an app's MCP endpoint — delegated- and scoped-token auth, the handshake's HTTP 202, and read-only annotations.
  • Read references/app-feeds.md when publishing or reviewing repository-owned feeds.json for Marketplace discovery and Core-managed updates.
  • Read references/app-launch-mode.md when the app has a UI, to keep it from drawing the name and page navigation a shell already renders around it.
  • Read references/demo-app-patterns.md when validating against the repository Demo App.
  • Read references/app-implementation-checklist.md before final verification.

Local Validation

Use Core-managed runtime app lifecycle:

bash
hosty core start
hosty apps install apps/demo-app --runtime dev
hosty apps start com.haas.demo-app

For direct endpoint probes:

bash
TOKEN="$(hosty apps identity com.haas.demo-app --user user@docker-host.local --format token)"
curl -H "X-Docker-Host-Identity: $TOKEN" <assigned-demo-app-origin>/api/auth/identity

按任务相关推荐