用途:solo-init(/init)是 solo-factory 的一次性创始人引导技能,在安装 solo-factory 后运行一次,通过提问生成个性化配置。所有内容以可读的 markdown/YAML 保存,可随时编辑。可安全重复运行,会显示当前值并允许更新。
主要能力:配置分两层。组织级 ~/.solo-factory/defaults.yaml 保存 bundle ID、GitHub 组织、Apple Team ID 等,跨项目共享;项目内 .solo/ 保存创始人哲学、开发原则、STREAM 校准和所选技术栈,按项目但通常相同。solo-factory/templates/ 中的模板为默认值,本技能根据回答个性化。
输出结构:~/.solo-factory/defaults.yaml;.solo/ 下含 manifest.md(创始人宣言)、stream-framework.md(按风险/决策风格校准)、dev-principles.md(按偏好调整)、stacks/(仅所选栈模板,如 nextjs-supabase.yaml、python-api.yaml)。其他技能会读取这些文件:/scaffold 读取 defaults.yaml 的占位符与 .solo/stacks/;/validate 读取 manifest.md 做宣言一致性检查;/setup 读取 dev-principles.md;/stream 读取 stream-framework.md。
使用方式:运行 /init。步骤包括检查已有配置(若 defaults.yaml 与 .solo/ 均存在,询问“从头重配”或“保留并跳过”);确定项目路径($ARGUMENTS 含路径则用之,否则用当前工作目录);依次提问组织默认值(5 题)、哲学与价值观(4 题)、开发偏好(4 题)、决策风格与技术栈(3 题);创建 ~/.solo-factory 并写入 defaults.yaml;加载默认模板并生成个性化文件;可选检查 Solograph MCP(尝试 uvx solograph --help,可用则提示“Solograph detected — code graph ready”,否则建议 pip install solograph 或 uvx solograph);最后输出摘要与后续步骤,如 /validate "your idea"、/scaffold app nextjs-supabase。
适用场景:首次设置 solo factory、初始化 profile、配置默认值、首次会话或需要重新配置时。
限制与常见问题:模板目录缺失时,技能会依据内联知识生成,永久修复需确保 solo-factory/templates/ 存在;技术栈未复制到 .solo/ 时,检查 templates/stacks/ 中的可用栈并重跑 /init 选择;defaults.yaml 已存在时,技能会检测并询问是否重配,选择“从头重配”可覆盖。具体问题规格见 references/questions.md,生成规则与边界情况见 references/generation-rules.md。