/factory

一键安装完整的 Solo Factory 创业启动工具包。

安装内容

23 项技能 —— 覆盖从创意构思到产品上线的完整创业流程：

MCP 服务器（可选）—— solograph 提供 15 个工具：

• kb_search —— 基于知识库的语义搜索
• session_search —— 检索历史 Claude Code 会话
• codegraph_query / codegraph_explain / codegraph_stats / codegraph_shared —— 代码智能分析
• project_info / project_code_search / project_code_reindex —— 项目注册中心
• source_search / source_list / source_tags / source_related —— 源内容管理
• web_search —— 网络搜索

安装步骤

1. 解析参数（来自 $ARGUMENTS）：

   • --mcp —— 同时配置 solograph MCP 服务器
   • --skills-only —— 跳过 MCP 配置（默认行为）
   • 不传任何参数 —— 安装全部技能，并询问是否配置 MCP

2. 检测当前 AI 代理环境并选择安装方式：

   # 检查可用命令
   command -v npx >/dev/null 2>&1 && echo "npx: ok"
   command -v clawhub >/dev/null 2>&1 && echo "clawhub: ok"
   

   方式 A（推荐）：npx skills —— 兼容任意 AI 代理，直接从 GitHub 安装。

   方式 B：clawhub install —— 面向偏好使用 ClawHub 注册中心的 OpenClaw 用户。

   方式 C：Claude Code 插件 —— 若用户正在使用 Claude Code，则建议采用插件方式安装。

3. 安装全部 23 项技能：

   方式 A —— npx skills（推荐，即刻生效）：

   npx skills add fortunto2/solo-factory --all
   

   该命令将一次性从 GitHub 安装全部技能至所有已检测到的 AI 代理（包括 Claude Code、Cursor、Copilot、Gemini CLI、Codex 等），无需账号或发布流程。

   方式 B —— clawhub（OpenClaw 用户）：

   # 检查登录状态
   clawhub whoami 2>/dev/null || echo "请先运行：clawhub login"
   
   # 安装所有可用技能
   for skill in 
     audit build community-outreach content-gen deploy 
     humanize index-youtube init landing-gen metrics-track 
     pipeline plan research retro review 
     scaffold seo-audit setup stream swarm 
     validate video-promo you2idea-extract; do
     echo -n "正在安装 solo-$skill... "
     clawhub install "solo-$skill" 2>&1 | tail -1
     sleep 2
   done
   

   若部分技能尚未发布至 ClawHub，则对这些技能回退至方式 A 安装。

   方式 C —— Claude Code 插件（一体化安装）：

   claude plugin marketplace add https://github.com/fortunto2/solo-factory
   claude plugin install solo@solo --scope user
   

   该命令可一次性完成全部 23 项技能 + 3 个代理 + 钩子函数 + MCP 自动启动的配置。

4. MCP 配置（当指定 --mcp 或用户确认启用时）：

   提示：“是否为代码智能分析与知识库搜索配置 solograph MCP？”

   4a. 检查 uv/uvx 是否就绪：

   command -v uvx >/dev/null 2>&1 && echo "uvx: ok" || echo "uvx: missing"
   

   若未安装：提示“请先安装 uv：https://docs.astral.sh/uv/”

   4b. 配置 MCP：

   针对 OpenClaw（通过 mcporter）：

   mcporter config add solograph --stdio "uvx solograph"
   

   针对 Claude Code（通过 .mcp.json）：

   {
     "mcpServers": {
       "solograph": {
         "command": "uvx",
         "args": ["solograph"]
       }
     }
   }
   

   4c. 验证配置：

   uvx solograph --help
   

5. 输出安装结果报告：

   ## Solo Factory 安装完成
   
   **安装方式：** npx skills / clawhub / Claude Code 插件  
   **已安装技能数：** X/23  
   **MCP 是否已配置：** yes/no  
   **失败项：** [列出所有失败的安装项]
   
   ### 快速上手
   
   可尝试以下命令：
   - `/solo-research "你的创业想法"` —— 市场调研  
   - `/solo-validate "你的创业想法"` —— 评分 + 生成 PRD  
   - `/solo-stream "我该辞职创业吗"` —— 决策框架  
   
   ### 完整工作流
   
   research → validate → scaffold → setup → plan → build → deploy → review  
   
   ### 更多信息
   
   GitHub：https://github.com/fortunto2/solo-factory  
   MCP：https://github.com/fortunto2/solograph
   

常见问题

npx skills：命令未找到

解决方法： 安装 Node.js 18+。npx 随 npm 一同分发。

clawhub：部分技能未找到

原因： 并非所有技能均已发布至 ClawHub。

解决方法： 改用 npx skills add fortunto2/solo-factory --all 安装。

uvx：命令未找到（用于 MCP）

解决方法： curl -LsSf https://astral.sh/uv/install.sh | sh

MCP 工具无法正常工作

解决方法： 使用 uvx solograph --help 测试；检查 .mcp.json 文件或 mcporter 配置。