用途:nano(/nano)把已验证的想法转化为可执行的实施步骤,属于“实现规划”阶段技能。适用于非平凡任务:涉及 3 个以上文件、新功能、重构或缺陷调查;在动手实现前先产出有边界、可操作的计划。计划被视为一份契约:若计划写 4 个文件,PR 就应只触碰 4 个文件。
主要能力:按范围分级规划——Small(1-3 个文件,仅实施步骤)、Medium(4-10 个文件,产品规格 + 实施步骤 + 风险)、Large(10+ 文件,产品规格 + 技术规格 + 实施步骤 + 分阶段执行)。会载入上游工件与历史方案(resolve.sh plan),读取 think 工件中的关键风险、最窄切入点、超出范围项与前提是否已验证,并参考 git 历史与模块简报。每个将改动的文件都会被列出,步骤按执行顺序排列,每步可独立验证,并主动暴露未知点。Medium/Large 范围还会做架构检查:数据流、失败模式、扩展瓶颈、测试矩阵、确定性步骤与隐性步骤、回滚能力。涉及用户可见产物时套用产品标准(shadcn + Tailwind 等)。
使用方式:先初始化或检查会话(session.sh status / session.sh init development),再开始 plan 阶段。计划审批模式由会话中的 plan_approval 决定:auto 直接继续,manual 默认等待明确批准,not_required 跳过审批。local 模式下改用通俗语言,不列 /review 等命令。计划通过后保存计划工件,需含 planned_files、plan_approval、context_checkpoint。后续步骤可调用 /review、/security、/qa,全部通过后 /ship 创建 PR。
限制:不先读代码就规划是首要失败模式;不应把应原子完成的两处改动拆开;测试不单独成步而应内嵌于每步验证;不列已被否定的备选方案;不写时间估算;若发现超出原始请求的步骤应停下来与用户确认。纯 CSS 式“加样式”不构成完整计划。默认技术栈为 shadcn/ui + Tailwind,偏离需有理由。依赖版本应使用最新稳定版,不依赖训练数据中的版本。遥测可通过 NANOSTACK_NO_TELEMETRY=1 或相关文件关闭。