solo-init

/init

一次性创始人引导流程。提出关键问题，并生成个性化配置文件。所有内容都以易读的 Markdown/YAML 格式存储，可随时编辑。

两层配置：

• ~/.solo-factory/defaults.yaml — 组织级配置（Bundle ID、GitHub 组织、Apple Team ID）。所有项目共享。
• 项目中的 .solo/ — 创始人理念、开发原则、STREAM 校准和选定的技术栈。按项目配置，但通常各项目相同。

solo-factory/templates/ 中的模板是默认模板。此技能会根据你的回答对其进行个性化设置。

安装 solo-factory 后运行一次即可。可以安全地重新运行——技能会显示当前值，并让你进行更新。

输出结构

~/.solo-factory/
└── defaults.yaml              # Org defaults (bundle IDs, GitHub, Team ID)

.solo/
├── manifest.md                # Your founder manifesto (generated from answers)
├── stream-framework.md         # STREAM calibrated to your risk/decision style
├── dev-principles.md          # Dev principles tuned to your preferences
└── stacks/                    # Only your selected stack templates
    ├── nextjs-supabase.yaml
    └── python-api.yaml

其他技能会读取这些内容：

• /scaffold 会读取 defaults.yaml 中的 <org_domain>、<apple_dev_team> 占位符，以及 .solo/stacks/ 中的技术栈模板
• /validate 会读取 manifest.md，用于检查是否符合宣言
• /setup 会读取 dev-principles.md，用于配置工作流
• /stream 会读取 stream-framework.md，用于决策框架

步骤

1. 检查现有配置

• 读取 ~/.solo-factory/defaults.yaml — 如果存在，则显示当前值
• 检查项目路径中是否存在 .solo/
• 如果两者都存在，询问：“从头重新配置？”或“保留现有配置并跳过？”
• 如果两者都不存在，则继续执行第 2 步

2. 确定项目路径

如果 $ARGUMENTS 包含路径，则使用该路径。否则使用当前工作目录。

3. 询问组织默认设置（AskUserQuestion，5 个问题）

完整的问题说明请参阅 references/questions.md → “Round 0: Org Defaults”。

4. 创建组织默认设置

mkdir -p ~/.solo-factory

写入 ~/.solo-factory/defaults.yaml：

# Solo Factory — org defaults
# Used by /scaffold and other skills for placeholder replacement.
# Re-run /init to update these values.

org_domain: "<answer from 3.1>"
apple_dev_team: "<answer from 3.2>"
github_org: "<answer from 3.3>"
projects_dir: "<answer from 3.4>"
knowledge_base_repo: "<answer from 3.5>"

5. 询问 Round 1 — 理念与价值观（AskUserQuestion，4 个问题）

完整的问题说明请参阅 references/questions.md → “Round 1: Philosophy & Values”。

6. 询问 Round 2 — 开发偏好（AskUserQuestion，4 个问题）

完整的问题说明请参阅 references/questions.md → “Round 2: Development Preferences”。

7. 询问 Round 3 — 决策风格与技术栈（AskUserQuestion，3 个问题）

完整的问题说明请参阅 references/questions.md → “Round 3: Decision Style & Stacks”。

8. 加载默认模板并生成个性化文件

相关内容请参阅 references/generation-rules.md：

• 模板源位置
• 输出文件结构（defaults.yaml、manifest.md、stream-framework.md、dev-principles.md、stacks/）
• 各文件的个性化规则（如何将回答映射到生成的内容）
• 技术栈模板映射（回答 → YAML 文件）

10. 验证 Solograph MCP（可选检查）

• 尝试运行 uvx solograph --help，或检查 MCP 工具是否可用
• 如果可用：“已检测到 Solograph — 代码图谱已就绪”
• 如果不可用：“提示：安装 Solograph，以便跨项目搜索代码（pip install solograph 或 uvx solograph）”

11. 总结

Solo Factory initialized!

Org config:
  Config:         ~/.solo-factory/defaults.yaml
  org_domain:     <value>
  apple_dev_team: <value>
  github_org:     <value>
  projects_dir:   <value>

Founder profile:
  Manifest:       .solo/manifest.md
  Dev Principles: .solo/dev-principles.md
  STREAM:          .solo/stream-framework.md
  Stacks:         .solo/stacks/ (N stacks)

These files are yours — edit anytime.
Other skills read from .solo/ automatically.

Next steps:
  /validate "your idea"          — validate with your manifest
  /scaffold app nextjs-supabase  — scaffold with your stack

边缘情况

完整列表请参阅 references/generation-rules.md → “Edge Cases”。

常见问题

未找到模板目录

原因： solo-factory 未作为子模块安装，或模板已移动。 解决方法： 如果找不到模板，技能会根据内置知识生成内容。若要永久解决，请确保 solo-factory/templates/ 存在。

技术栈未复制到 .solo/

原因： 技术栈选择的回答未映射到模板文件。 解决方法： 检查 templates/stacks/ 中可用的技术栈。重新运行 /init 并从列表中选择。

defaults.yaml 已存在

原因： 此配置之前已初始化。 解决方法： 技能会检测现有配置，并询问是否重新配置。选择“从头重新配置”即可覆盖。