sf-onboard

运行目录

开始 onboard 前，先确认当前目录是要接入 SpecForge 的业务项目根。若当前在 frontend/、backend/ 等子目录，先回到仓库根；不要在子目录里初始化 .specforge/，除非用户明确说明该子目录就是独立项目。

sf-onboard 只做四件事：搭骨架、升级已有 .specforge/ 运行时、识别存量项目、报告迁移建议。骨架完成后其他 sf-* 技能才能运行；已有代码的项目应先进入 sf-steering 建立 wiki 基线，再处理新需求或 bug。

必读

• references/structure-and-migration.md：安装命令、标准骨架、starter 来源、覆盖规则和迁移映射。
• .specforge/skills/sf-steering/stages/steering/SKILL.md：项目画像、长期约束和 wiki 归档判断；仅在 .specforge/ 已存在或初始化完成后读取。
• .specforge/core/standards/workflow.md：初始化边界、上下文加载和中文输出；仅在 .specforge/ 已存在或初始化完成后读取。

核心原则