SkillDock

本 skill 随独立的 skilldock 插件分发，可在 Codex 或 Claude 中使用，仅打开本地技能管理应用。两边打开的是同一个本地实例和同一份数据。在支持原生入口的 Codex 版本中，可从 More / Explore 的 SkillDock 打开完整主页面并固定到侧栏；在 Claude 中把本地技能管理器打开在内置浏览器面板里。GUI 按钮直接调用本地服务，打开即加载本机技能库。用户只要求打开界面时，不替其安装、禁用或移除实际技能。

Codex 原生入口

仅 Codex 有此入口（Claude 不加载它）。插件随包提供本地 MCP 服务及完整 UI。新会话/重载后，在 More / Explore 选择 SkillDock；可用 Pin to sidebar 固定。第一次打开会自动准备后台，后续复用已核实的实例。全局页面沿用已保存的项目，首次无选择时用用户主目录，用户可从项目选择器切换。后台中断时界面会重连，不自动重放写操作。原型 SkillDock Preview 是不同测试插件，正式入口需单独固定；不自动卸载用户的 Preview。

分发和生命周期说明见 原生应用接入。

启动与打开

从本次实际加载的 SKILL.md 所在目录定位 scripts/launch.sh，不要假定仓库 checkout 或插件缓存路径。启动器按固定顺序查找本机 Node.js 22.12+（Codex 工作区、已下载的专用版本、Homebrew、nvm/fnm/Volta/asdf/mise/nodenv、PATH），保存所选路径供两侧入口与后台任务复用，失效时重新查找；找不到时弹出安装引导（打开下载页或安装后“重新检测”），不再自动下载。

/bin/sh "/实际安装位置/skill-manager/scripts/launch.sh" start --project "/用户项目的绝对路径"

启动前确定用户项目目录，并用 --project 显式传入；不要先切换到下载目录或安装目录再把它作为用户项目。未指定时依次使用 SKILLDOCK_PROJECT_DIR、界面保存的项目、调用工作目录。界面“切换项目”可保存新的扫描选择。可用 SKILLDOCK_STATE_DIR 指定独立应用数据目录、PORT 指定端口；默认数据位于 ~/.local/share/skilldock，默认端口 4771。启动器把源文件复制到应用数据目录，按 lockfile 安装依赖并构建（输出写入数据目录的 build.log），不向安装的插件缓存写入运行数据。首次启动需要 npm registry 可达，后续复用相同构建。