用途:nano-run 是 nanostack 的首次安装引导,用于对话式配置技术栈、权限和工作偏好,并帮助用户完成第一次冲刺(sprint)。安装 nanostack 后运行一次即可,触发方式为 /nano-run。
主要能力:以友好引导者身份运行,避免术语和文档,直接对话。它会先执行只读状态检测:识别项目根目录、技术栈线索(package.json、go.mod、pyproject.toml、requirements.txt、Dockerfile)、已有 nanostack 状态(.nanostack/config.json、.nanostack/stack.json)以及宿主状态(.claude/settings.json 中 hook 与宽泛权限)。随后按引导(guided)或专业(professional)两种档案输出相应语言风格;guided 使用四段式骨架(Result、How to try、What was checked、What remains,西班牙语版为 Resultado、Como verlo、Que revise、Pendiente),professional 则直接列出文件、能力级别、命令和修复动作。
使用方式:典型流程为三步。第一步只读检测状态,运行 ~/.claude/skills/nanostack/bin/init-config.sh,并通过 ~/.claude/skills/nanostack/bin/detect-legacy-setup.sh 检测旧配置,输出结构化 JSON 用于设置记录。第二步配置,跳过条件为报告模式;逐个提问,每次只问一个问题,例如“你构建什么类型的项目”“你偏好如何工作”,运行 ~/.claude/skills/nanostack/bin/init-stack.sh 和 ~/.claude/skills/nanostack/bin/init-project.sh,并把工作模式偏好写入 .nanostack/config.json 的 preferences.workflow_mode(autopilot 或 manual)。第三步写入设置记录,调用 ~/.claude/skills/nanostack/bin/save-setup-artifact.sh,生成 .nanostack/setup/<timestamp>.json 并复制为 latest.json。
修复流程:若检测到旧安装,nano-run 不会静默修改。可推荐 bin/init-project.sh --repair,该命令为增量修复,添加缺失 hook 并为已有设置创建带时间戳的 .bak,但不移除宽泛权限条目。bin/init-project.sh --migrate-permissions 会移除 Bash(rm:*) 等宽泛规则,仅在用户明确批准时才可运行。若旧状态无法修复,设置记录的 summary.status 应写为 needs_repair,不能返回 ready。
模式与限制:报告模式(RUN_MODE=report_only)下只检测和报告,不运行变更脚本,不写配置文件,设置记录中的配置字段使用 skipped_report_only。宿主未知时,能力字段均为 unknown,并会提示无法验证硬性安全检查,建议运行 /nano-doctor。能力字段必须从宿主适配器读取,不得从宿主名称推断。该技能要求一次只问一个问题,不向引导用户暴露内部术语。官方资料未提供收费、价格或平台支持清单等信息。