solo-setup

/setup

根据现有 PRD 和 CLAUDE.md 自动生成项目工作流配置。不会提出任何交互式问题——所有答案都从 /scaffold 后已有的项目数据中提取。

适用时机

/scaffold 创建项目后、/plan 之前使用。此操作会创建 docs/workflow.md，供 /plan 和 /build 使用。

MCP 工具（如可用则使用）

• project_info(name) — 获取项目详情和检测到的技术栈
• kb_search(query) — 搜索开发原则、清单和技术栈模板
• codegraph_query(query) — 检查代码图中的项目依赖关系

如果 MCP 工具不可用，则仅读取本地文件。

步骤

1. 检测项目根目录：

   • 如果提供了 $ARGUMENTS，则在当前目录或 ~/.solo-factory/defaults.yaml 中的 projects_dir 里查找具有该名称的项目。
   • 否则使用当前工作目录。
   • 验证目录存在且包含 CLAUDE.md。
   • 如果未找到，通过 AskUserQuestion 提问。

2. 检查是否已初始化：

   • 如果 docs/workflow.md 已存在，则发出警告并询问是否重新生成。

3. 读取项目数据（并行读取——一次性读取所有内容）：

   • CLAUDE.md — 技术栈、架构、命令、要做/不要做的事项
   • docs/prd.md — 问题、用户、解决方案、功能、指标、定价
   • package.json 或 pyproject.toml — 精确的依赖版本
   • Makefile — 可用命令
   • Linter 配置（.eslintrc*、eslint.config.*、.swiftlint.yml、ruff.toml、detekt.yml）

4. 读取生态系统资料（可选——提升质量）：

   • 从 CLAUDE.md 检测技术栈名称（查找“Stack:”或技术部分中的技术栈名称）。
   • 如果 MCP kb_search 可用：搜索技术栈模板和开发原则。
   • 否则：在 .solo/ 或插件模板目录（如果可访问）中查找 stacks/<stack>.yaml、dev-principles.md 和 dev-principles-my.md（个人扩展）。
   • 如果两者都不可用：根据 CLAUDE.md 和 package 清单推导所有信息（足够使用）。

5. 从 package 清单检测语言：

   • package.json → TypeScript
   • pyproject.toml → Python
   • *.xcodeproj 或 Package.swift → Swift
   • build.gradle.kts → Kotlin

6. 如有需要，创建 docs 目录：

   mkdir -p docs
   

7. 生成 docs/workflow.md： 根据开发原则（来自 MCP/KB 或内置默认设置）：

   # Workflow — {ProjectName}
   
   ## TDD Policy
   **Moderate** — Tests encouraged but not blocking. Write tests for:
   - Business logic and validation
   - API route handlers
   - Complex algorithms
   Tests optional for: UI components, one-off scripts, prototypes.
   
   ## Test Framework
   {from package manifest devDeps: vitest/jest/pytest/xctest}
   
   ## Commit Strategy
   **Conventional Commits**
   Format: `<type>(<scope>): <description>`
   Types: feat, fix, refactor, test, docs, chore, perf, style
   
   ## Verification Checkpoints
   **After each phase completion:**
   1. Run tests — all pass
   2. Run linter — no errors
   3. Run build — successful (if applicable)
   4. Manual smoke test
   
   ## Branch Strategy
   - `main` — production-ready
   - `feat/<track-id>` — feature branches
   - `fix/<description>` — hotfixes
   

8. 更新 CLAUDE.md — 如果“关键文档”部分中没有工作流引用，则添加该引用。

9. 显示摘要并建议下一步：

   Setup complete for {ProjectName}!
   
   Created:
     docs/workflow.md — TDD moderate, conventional commits
   
   Next: /plan "Your first feature"
   

常见问题

未找到 CLAUDE.md

原因： 项目尚未通过脚手架创建，或当前目录不正确。
解决方法： 先运行 /scaffold，或确保当前位于包含 CLAUDE.md 的项目根目录。

workflow.md 已存在

原因： 之前已完成设置。
解决方法： 技能会发出警告并询问是否重新生成。除非你确认覆盖，否则会保留现有文件。

检测到的测试框架不正确

原因： devDependencies 中存在多个测试框架。
解决方法： 技能会选择找到的第一个框架。手动编辑 docs/workflow.md，指定正确的框架。