메뉴
当用户要在本地验证当前源码构建出的 NextClaw 产品实例、restart/start/stop、避免跑到全局安装版 nextclaw、需要可复用本地安装态/构建态验证命令或 smoke harness 时使用。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Use when implementing, refactoring, or designing source-level contracts in this repository, especially if a task touches frontend/backend i18n or user-facing copy, frontend base/display components, tool schemas, API/protocol parameters, shared contracts, compatibility paths, fallback-heavy logic, duplicate branches, weak abstractions, unclear file placement, ad-hoc helpers, or patch-style fixes that would turn into garbage code.
Create or update complete NextClaw lightweight apps, deciding whether the user needs a Panel App, a Service App, or a combined Panel + Service App. Use for NextClaw applets, small tools, dashboards, local file tools, AI-assisted UI tools, apps that may combine right-side UI with backend actions, or questions about what NextClaw/Panel apps can do and which app APIs/capabilities they can use.
当用户要求提交、收尾、统一 NPM 发布、GitHub release、changelog、release notes、版本更新说明、产品更新笔记、变更汇总，或担心并行会话导致发布内容靠记忆整理时使用。适用于需要进入用户可见发布说明的 NextClaw workspace 包变更、Changesets 聚合、AI 撰写版本更新笔记、可拉取结构化 release notes JSON，以及 update manifest releaseNotesUrl 闭环。
Use when building, verifying, or releasing NextClaw desktop installers, DMGs, update bundles, update manifests, or one-command desktop beta/stable release automation. Enforces the packaged update public key contract, the required verification commands, and the rule that raw electron-builder output is not enough.
当用户要求“发布 beta”“统一 beta 发版”“发一个新的 NPM beta 版本”“一键 beta release”或希望直接复用 NextClaw 的 beta 发布闭环时使用。适用于 nextclaw 及其相关 workspace 包的 beta 发布，也适用于需要同时闭合 npm registry 与 NPM runtime update channel 的场景。
Use when publishing NextClaw NPM packages or NPM runtime update channels, including beta/stable dist-tags, nextclaw@beta validation, runtime bundle manifests, packaged update public keys, and npm registry closure checks.
| name | local-source-runtime-validation |
| description | 当用户要在本地验证当前源码构建出的 NextClaw 产品实例、restart/start/stop、避免跑到全局安装版 nextclaw、需要可复用本地安装态/构建态验证命令或 smoke harness 时使用。 |
让 AI 或开发者验证“当前仓库源码构建出来的 NextClaw”真实 start / restart / stop 行为，避免误用 PATH 中已经安装的旧 nextclaw。
日常默认使用：
pnpm local:runtime
这个命令会：
packages/nextclaw/dist/cli/app/index.js 作为唯一 CLI 入口；~/.nextclaw 作为 NEXTCLAW_HOME，复用同一份配置、workspace、sessions 和 memory；~/.nextclaw-source-runtime/default/run 作为 NEXTCLAW_RUN_HOME，隔离 service.json、ui-runtime.json、restart sentinel 和运行日志；使用本 skill，当用户提到：
pnpm dev。pnpm local:runtime
http://127.0.0.1:18888
pnpm local:runtime:restart
pnpm local:runtime:status
pnpm local:runtime:stop
需要容器级隔离、独立数据目录，并从当前仓库源码 build 镜像时，使用短命令：
pnpm docker:start
这个命令会：
docker/compose.yml 和 docker/Dockerfile 从当前仓库源码构建镜像；~/.nextclaw-docker 作为默认数据目录，挂载到容器内 /data；NEXTCLAW_HOME=/data；18891 和 gateway 18890，避免占用安装态默认端口；nextclaw-docker，自定义 --container-name 会使用独立 compose project，避免不同验证实例互相 recreate；pnpm fetch，源码变更后不应重新下载依赖；pnpm install --offline 仍会执行，用于把当前源码 workspace 装配进镜像；/api/health 并打印 UI、API、logs、down 命令。常用可选参数：
pnpm docker:start -- --ui-port 18891 --api-port 18890 --data-dir /tmp/nextclaw-docker-smoke
pnpm docker:start -- --dry-run
关闭默认 Docker 验证实例：
pnpm docker:stop
默认 shared-data：
~/.nextclaw；~/.nextclaw-source-runtime/<instance>/run；可配置入口：
pnpm local:source-runtime -- start --port 18889 --instance test-a
复制配置但隔离数据：
pnpm local:source-runtime -- start --home-mode clone-config --port 18889
临时隔离：
pnpm local:source-runtime -- start --home-mode temp --port 18889
真实 home，高风险，只在用户明确要求时使用：
pnpm local:source-runtime -- start --home-mode current --allow-current-home --port 18888
nextclaw restart 验证当前源码；它可能来自全局安装版。pnpm dev 的总控 wrapper 验证 restart 恢复体验；backend 退出会让 dev runner 自己收尾。pnpm local:runtime。pnpm local:source-runtime -- ...。pnpm clean:generated 或说明产物为何需要保留。