/setup

从现有的 PRD 和 CLAUDE.md 自动生成功能项目工作流配置。全程无需交互式提问——所有答案均从 /scaffold 执行后已存在的项目数据中提取。

适用场景

在 /scaffold 创建项目之后、/plan 之前执行。用于生成 docs/workflow.md，以便后续 /plan 和 /build 能正常运行。

MCP 工具（如可用则调用）

• project_info(name) — 获取项目详情及已识别的技术栈
• kb_search(query) — 检索开发原则、清单文件（manifest）、技术栈模板等知识库内容
• codegraph_query(query) — 基于代码图谱检查项目依赖关系

若 MCP 工具不可用，则仅回退至读取本地文件。

执行步骤

1. 检测项目根目录：

   • 若提供了 $ARGUMENTS，则在当前目录或 ~/.solo-factory/defaults.yaml 中定义的 projects_dir 下查找同名项目。
   • 否则使用当前工作目录。
   • 验证该目录存在，且包含 CLAUDE.md 文件。
   • 若未找到，通过 AskUserQuestion 向用户询问。

2. 检查是否已初始化：

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

3. 读取项目数据（并行执行 —— 所有文件同时读取）：

   • CLAUDE.md — 技术栈、架构设计、常用命令、应做与禁做事项（Do/Don't）
   • docs/prd.md — 问题描述、目标用户、解决方案、功能列表、关键指标、定价策略
   • package.json 或 pyproject.toml — 精确的依赖版本信息
   • Makefile — 可用的命令列表
   • 代码规范工具配置（.eslintrc*、eslint.config.*、.swiftlint.yml、ruff.toml、detekt.yml）

4. 读取生态源信息（可选 —— 提升生成质量）：

   • 从 CLAUDE.md 中识别技术栈名称（查找 “Stack:” 字样，或技术章节中明确指出的栈名）。
   • 若 MCP 的 kb_search 可用：搜索对应技术栈模板和开发原则文档。
   • 否则：尝试在 .solo/ 目录或插件模板目录（若可访问）中查找 stacks/.yaml 和 dev-principles.md。
   • 若以上均不可得：仅基于 CLAUDE.md + 包清单（package manifest）推导全部信息（已足够）。

5. 从包清单中识别编程语言：

   • 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 策略
   **适中型** — 鼓励编写测试，但不强制阻断流程。建议为以下内容编写测试：
   - 业务逻辑与校验逻辑
   - API 路由处理器
   - 复杂算法  
   无需强制测试的内容：UI 组件、一次性脚本、原型代码。
   
   ## 测试框架
   {根据 package manifest 中 devDeps 字段自动识别：vitest/jest/pytest/xctest}
   
   ## 提交规范
   **约定式提交（Conventional Commits）**  
   格式：`(): `  
   类型包括：feat、fix、refactor、test、docs、chore、perf、style
   
   ## 验证检查点
   **每个阶段完成后必须执行：**
   1. 运行测试 —— 全部通过  
   2. 运行 Linter —— 无错误  
   3. 运行构建 —— 成功（如适用）  
   4. 手动冒烟测试（smoke test）
   
   ## 分支策略
   - `main` —— 生产就绪分支  
   - `feat/` —— 功能开发分支  
   - `fix/` —— 热修复分支
   

8. 更新 CLAUDE.md： 若“关键文档”（Key Documents）章节中尚未引用 workflow.md，则补充该条目。

9. 输出摘要并提示下一步操作：

   已为 {ProjectName} 完成 setup！
   
   已创建：
     docs/workflow.md — TDD 适中策略，启用约定式提交
   
   下一步：/plan "你的首个功能"
   

常见问题

未找到 CLAUDE.md

原因： 项目尚未执行 /scaffold，或当前运行目录错误。 解决方法： 先运行 /scaffold，或确认当前位于含 CLAUDE.md 的项目根目录下。

workflow.md 已存在

原因： 此前已执行过 setup。 解决方法： 该技能会发出警告并询问是否覆盖重写；除非用户明确确认，否则原文件将被保留。

检测到错误的测试框架

原因： devDependencies 中存在多个测试框架。 解决方法： 该技能默认选取第一个匹配项。请手动编辑 docs/workflow.md 中的测试框架声明以修正。