用途:把当前仓库配置为支持 super.engineering,通过官方 sc project scripts 接口写入 .superconductor/config.json,设置仓库级的 worktree 安装(setup)与开发服务器运行(run)脚本。除用户另行要求外,不创建工作树、不提交、不推送、不打开浏览器。
主要能力:加载实时指引(读取 ~/.pi/agent/skills/superconductor/SKILL.md,并运行 sc instructions project、sc project scripts --help);用 sc project scripts --json、sc project scripts check --json、sc worktree status --json、git status --short --branch 检查当前状态;依据仓库证据推导命令,例如按已提交的包管理器 lockfile 得出 pnpm install --frozen-lockfile 或 npm ci,优先复用已有 dev 或 start 脚本;添加 host、port 或转发参数前先查看框架 CLI 帮助,不猜测参数语法;面向浏览器的开发服务器在框架支持时配置可 IPv4 访问的绑定地址(如 Astro 接受 pnpm run dev --host 0.0.0.0,其他框架不同)。
使用方式:以 repo 作用域写配置,使受管工作树继承;使用 sc 而非直接替换 JSON,以保留未知字段并原子校验:sc project scripts set setup "<verified setup command>" --scope repo --json;sc project scripts set run devserver --default "<verified run command>" --scope repo --json。随后用 sc project scripts check --json 校验,安全且非破坏时运行一次 setup,用 sc project scripts run <name> --json 启动,确认 sc project scripts status --json 显示运行中;若服务暴露 HTTP 且已知端口,请求其 IPv4 回环 URL 并要求成功响应。验证后停止目标(除非用户要求保持运行),再检查 .superconductor/config.json、git diff、git status --short。最后按 setup、默认运行目标、验证结果、变更文件报告,配置保持未提交,除非用户另行要求提交。
限制:不要虚构 teardown、stop 或 cleanup 命令,仅在仓库已定义所需生命周期行为时添加;仅在仓库证据支持时选择命令;保留已有有效 setup 或 run 命令,除非证据表明其错误;当包管理器、运行脚本或目标服务不明确时,提出一个聚焦问题;若无需 setup 命令,不要添加空命令;仓库已有多个命名运行目标时保留它们并为新目标选择描述性名称;浏览器类应用仅有进程启动而无可达服务,不构成充分验证。