القائمة
当用户要在本地验证当前源码构建出的 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 或说明产物为何需要保留。