service-app-creator

NextClaw Service App Creator

本 skill 是 Service 运行形态、service-app.json、Service Action、risk 和验证入口的唯一 owner。若用户表达的是“做一个完整 NextClaw 小应用”，先由 nextclaw-app-creator 判断是否还需要 Panel；本 skill 不拥有 Panel UI 或 bridge 字段。

不要再把所有 schema v2 Service 都等同于 command/args + MCP stdio + native-process。当前 NextClaw 同时支持：

• Portable WASI Service：protocol: "wasi-component"，由 NextClaw 随产品提供的 runner 执行 Rust/WASI Component；
• native-process Service：protocol: "mcp"，由宿主启动 Node、Python、系统命令或其它本地进程。

先选择运行形态

优先 Portable WASI

满足以下条件时选择 Portable：

• Service 可以表达为明确的 Action，或确实需要 Resident / Provider 生命周期；
• KV、SQLite、受授权文件、允许域名、密钥槽位、Provider、model slot 或 agent slot 能覆盖需求；
• 希望同一份 .napp 在支持的平台运行，且不把用户完整宿主权限交给 Guest；
• 应用面向分发、安装或长期维护，安全能力边界比快速脚本更重要。

选择后必须读取 references/portable-wasi-service-app.md，不能凭本入口猜 WIT、manifest、生命周期或构建命令。

仅在真实需要时选择 native-process

以下情况选择 native-process：

• 必须直接运行 Node/Python/系统程序、平台 SDK、驱动、socket 或外部守护进程；
• 依赖无法由当前 Portable Runtime 能力合同承接；
• 用户明确只要一个快速、本机、无需 Rust 工具链的 Service helper，并接受宿主用户权限边界；
• 正在维护现有 workspace service-apps/<id>/ MCP Service。

选择后必须读取 references/native-process-service-app.md。不能仅因开发机暂时缺少 Rust，就把需要可移植或受限能力边界的应用静默降级为宿主进程。

Rust 工具链边界

必须准确区分创作者与最终用户：

• 在本机创建并构建 Rust/WASI Guest，需要 cargo、rustc 和 wasm32-wasip2；先运行 nextclaw app doctor --profile wasi。
• 安装和运行已经构建好的 Portable .napp 不要求最终用户安装 Rust、Cargo、Wasmtime 或系统 Node。WebAssembly Component 已在包内，runner 由 NextClaw 提供。
• 纯 Panel App 和 native-process Service 不因 Portable Runtime 的存在而需要 Rust。

如果用户目标明确要求 Portable，但工具链检查失败，保留已创建的源码和失败证据，说明缺少的开发依赖；未经授权不要自动安装 Rust，也不要把未构建源码说成可交付应用。

两种交付边界

完整或可发布的 schema v2 Mini App

Service 应位于应用包根：

my-app/
├── manifest.json
├── marketplace.json
├── panels/<panel-id>.panel/              # 可选
├── service-components/<service-id>/
│   └── service-app.json
└── ...runtime-specific sources and artifacts

根 manifest.json.components 是组件归属的事实源。Portable 使用 runtime.profile: wasi；native-process 使用 runtime.profile: native-process。适用的 build/check/test/dev/call/pack/validate-publish 命令都从包根运行。