solo-factory

安装完整的 Solo Factory 工具包 — 23 项启动技能 + 独奏 MCP 服务器，用于代码智能、知识库搜索和 Web 搜索。当用户说“安装独奏工厂”、“设置独奏”、“安装所有独奏技能”、“启动工具包”或“独奏工厂设置”时使用。这是整个启动管道的单命令入口点。

# /factory

One-command setup for the entire Solo Factory startup toolkit.

## What gets installed

**23 skills** — full startup pipeline from idea to shipped product:

| Phase | Skills |
|-------|--------|
| Analysis | research, validate, stream, swarm |
| Development | scaffold, setup, plan, build, deploy, review |
| Promotion | seo-audit, content-gen, community-outreach, video-promo, landing-gen, metrics-track |
| Utilities | init, audit, retro, pipeline, humanize, index-youtube, you2idea-extract |

**MCP server** (optional) — [solograph](https://github.com/fortunto2/solograph) provides 15 tools:
- `kb_search` — semantic search over knowledge base
- `session_search` — search past Claude Code sessions
- `codegraph_query` / `codegraph_explain` / `codegraph_stats` / `codegraph_shared` — code intelligence
- `project_info` / `project_code_search` / `project_code_reindex` — project registry
- `source_search` / `source_list` / `source_tags` / `source_related` — source management
- `web_search` — web search

## Steps

1. **Parse arguments** from `$ARGUMENTS`:
   - `--mcp` — also configure solograph MCP server
   - `--skills-only` — skip MCP setup (default)
   - No args — install skills, ask about MCP

2. **Detect agent and choose install method:**

   ```bash
   # Check what's available
   command -v npx >/dev/null 2>&1 && echo "npx: ok"
   command -v clawhub >/dev/null 2>&1 && echo "clawhub: ok"
   ```

   **Method A (recommended): `npx skills`** — works with any AI agent, installs from GitHub directly.
   **Method B: `clawhub install`** — for OpenClaw users who prefer ClawHub registry.
   **Method C: Claude Code plugin** — if user is on Claude Code, suggest plugin instead.

3. **Install all 23 skills:**

   **Method A — npx skills (recommended, works immediately):**

   ```bash
   npx skills add fortunto2/solo-factory --all
   ```

   This single command installs all skills from GitHub to all detected agents (Claude Code, Cursor, Copilot, Gemini CLI, Codex, etc.). No account or publishing required.

   **Method B — clawhub (OpenClaw users):**

   ```bash
   # Check login
   clawhub whoami 2>/dev/null || echo "Run: clawhub login"

   # Install available skills
   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 "Installing solo-$skill... "
     clawhub install "solo-$skill" 2>&1 | tail -1
     sleep 2
   done
   ```

   If some skills are not yet on ClawHub, fall back to Method A for those.

   **Method C — Claude Code plugin (all-in-one):**

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

   This installs all 23 skills + 3 agents + hooks + MCP auto-start in one command.

4. **MCP setup** (if `--mcp` or user agreed):

   Ask: "Set up solograph MCP for code intelligence and KB search?"

   **4a. Check uv/uvx:**
   ```bash
   command -v uvx >/dev/null 2>&1 && echo "uvx: ok" || echo "uvx: missing"
   ```
   If missing: "Install uv first: https://docs.astral.sh/uv/"

   **4b. Configure MCP:**

   For OpenClaw (via mcporter):
   ```bash
   mcporter config add solograph --stdio "uvx solograph"
   ```

   For Claude Code (via .mcp.json):
   ```json
   {
     "mcpServers": {
       "solograph": {
         "command": "uvx",
         "args": ["solograph"]
       }
     }
   }
   ```

   **4c. Verify:**
   ```bash
   uvx solograph --help
   ```

5. **Report results:**

   ```
   ## Solo Factory Setup Complete

   **Install method:** npx skills / clawhub / Claude Code plugin
   **Skills installed:** X/23
   **MCP configured:** yes/no
   **Failed:** [list any failures]

   ### Quick start

   Try these commands:
   - `/solo-research "your startup idea"` — scout the market
   - `/solo-validate "your startup idea"` — score + generate PRD
   - `/solo-stream "should I quit my job"` — decision framework

   ### Full pipeline

   research → validate → scaffold → setup → plan → build → deploy → review

   ### More info

   GitHub: https://github.com/fortunto2/solo-factory
   MCP: https://github.com/fortunto2/solograph
   ```

## Common Issues

### npx skills: command not found
**Fix:** Install Node.js 18+. npx comes with npm.

### clawhub: some skills not found
**Cause:** Not all skills published to ClawHub yet.
**Fix:** Use `npx skills add fortunto2/solo-factory --all` instead.

### uvx: command not found (for MCP)
**Fix:** `curl -LsSf https://astral.sh/uv/install.sh | sh`

### MCP tools not working
**Fix:** Test with `uvx solograph --help`. Check `.mcp.json` or mcporter config.

---

## 中文说明

# /factory

一键设置整个 Solo Factory 创业工具包。

## 安装内容

**23 项技能** —— 从创意到产品交付的完整创业管道：

| 阶段 | 技能 |
|-------|--------|
| Analysis | research, validate, stream, swarm |
| Development | scaffold, setup, plan, build, deploy, review |
| Promotion | seo-audit, content-gen, community-outreach, video-promo, landing-gen, metrics-track |
| Utilities | init, audit, retro, pipeline, humanize, index-youtube, you2idea-extract |

**MCP 服务器**（可选）—— [solograph](https://github.com/fortunto2/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` —— Web 搜索

## 步骤

1. **从 `$ARGUMENTS` 解析参数：**
   - `--mcp` —— 同时配置 solograph MCP 服务器
   - `--skills-only` —— 跳过 MCP 设置（默认）
   - 无参数 —— 安装技能，并询问是否需要 MCP

2. **检测代理并选择安装方式：**

   ```bash
   # Check what's available
   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（推荐，可立即生效）：**

   ```bash
   npx skills add fortunto2/solo-factory --all
   ```

   这一条命令会将所有技能从 GitHub 安装到所有检测到的代理（Claude Code、Cursor、Copilot、Gemini CLI、Codex 等）。无需账户或发布操作。

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

   ```bash
   # Check login
   clawhub whoami 2>/dev/null || echo "Run: clawhub login"

   # Install available skills
   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 "Installing solo-$skill... "
     clawhub install "solo-$skill" 2>&1 | tail -1
     sleep 2
   done
   ```

   如果某些技能尚未上架 ClawHub，则对这些技能回退到方式 A。

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

   ```bash
   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：**
   ```bash
   command -v uvx >/dev/null 2>&1 && echo "uvx: ok" || echo "uvx: missing"
   ```
   如果缺失：“请先安装 uv：https://docs.astral.sh/uv/”

   **4b. 配置 MCP：**

   对于 OpenClaw（通过 mcporter）：
   ```bash
   mcporter config add solograph --stdio "uvx solograph"
   ```

   对于 Claude Code（通过 .mcp.json）：
   ```json
   {
     "mcpServers": {
       "solograph": {
         "command": "uvx",
         "args": ["solograph"]
       }
     }
   }
   ```

   **4c. 验证：**
   ```bash
   uvx solograph --help
   ```

5. **报告结果：**

   ```
   ## Solo Factory Setup Complete

   **Install method:** npx skills / clawhub / Claude Code plugin
   **Skills installed:** X/23
   **MCP configured:** yes/no
   **Failed:** [list any failures]

   ### Quick start

   Try th