opengemini-saas-builder（opengemini saas 构建器）

OpenClaw SaaS Builder

Use this skill when the user wants full project orchestration instead of a quick snippet.

Core idea

OpenClaw is the driver. Gemini CLI is the brainstorming and generation copilot. GitHub CLI is for repo creation and GitHub operations. Vercel CLI is optional for deployment.

Do not treat Gemini as an unsupervised executor. Use it to generate plans, alternatives, code drafts, copy, architecture ideas, and reviews. OpenClaw remains responsible for file edits, shell execution, validation, and external side effects.

What this skill should produce

For a serious SaaS or web project, aim to create at least:

• requirements.md
• architecture.md
• Rules.md
• README.md
• TODO.md
• skills-plan.md
• source code scaffold or implementation

For deployment-ready work, also aim for:

• .env.example
• deployment.md
• CI/deploy notes

Preflight first

Before promising repo creation or deployment, run the preflight helper:

./skills/openclaw-saas-builder/scripts/preflight_saas_builder.sh

Interpretation:

• If Gemini CLI fails, continue with OpenClaw-only planning or ask whether to proceed without Gemini.
• If gh auth status fails, do not promise automatic repo creation yet.
• If vercel whoami fails, do not promise deployment yet.

If Vercel is required, the user should already have the CLI installed and authenticated. Typical checks:

which vercel
vercel --version
vercel whoami

Build modes

Read references/saas-build-modes.md when deciding scope. Use one of these modes explicitly:

• idea mode
• MVP mode
• production mode
• launch mode

Default workflow

Phase 1: Discovery and brainstorming

Clarify:

• product goal
• target users
• pain point
• MVP scope
• must-have features
• non-goals
• monetization or business purpose
• data and privacy concerns
• preferred stack or constraints

Use Gemini CLI to accelerate this phase. Prefer structured output. Good pattern:

• ask Gemini for a concise options list
• ask Gemini for tradeoffs
• ask Gemini for a JSON spec draft

Phase 2: Requirements package

Create these docs early:

• requirements.md
• architecture.md
• Rules.md
• skills-plan.md
• TODO.md

Use the bundled helpers when useful:

./skills/openclaw-saas-builder/scripts/generate_requirements.sh <project-name> '<brief>'
./skills/openclaw-saas-builder/scripts/generate_architecture.sh <project-name> '<brief>'
./skills/openclaw-saas-builder/scripts/generate_rules.sh <project-name> '<brief>'

Read references/saas-doc-templates.md for the expected sections.

If the user asks for diagrams, generate Mermaid diagrams in markdown first.

Phase 3: Implementation plan

Break work into small, ordered milestones. Use TODO.md or a milestone list. Good milestone pattern:

1. bootstrap repo
2. scaffold app
3. core domain logic
4. auth and data
5. UI and polish
6. tests
7. docs
8. repo publish
9. deploy

Phase 4: Build

Choose the build path based on complexity.

For small or medium tasks

• inspect files directly
• use Gemini CLI for spec, code drafts, or review
• edit files with OpenClaw tools
• run tests locally

For larger coding tasks

Prefer ACP or coding-agent for implementation loops. Use Gemini CLI as planning and review support, not as the only coding engine.

Phase 5: GitHub repository creation

Only do this when the user has explicitly asked for it or clearly requested end-to-end setup.

Typical local flow:

1. initialize git if needed
2. create README and baseline docs
3. verify gh auth status
4. create repo with a sensible name
5. set remote
6. commit initial version
7. push default branch

Use the helper when appropriate:

./skills/openclaw-saas-builder/scripts/create_github_repo.sh <repo-name> [--private|--public]

Use the GitHub skill for detailed command patterns.

Naming guidance:

• use a short, readable slug
• prefer product name or function over vague names
• avoid joke names unless the user asks

Phase 6: Optional Vercel deployment

Only do this when the user asked for deployment.

Before deploy, verify:

which vercel
vercel --version
vercel whoami

If Vercel auth is not ready, stop and say exactly that. Do not fake deployment readiness.

Use the helper when appropriate:

./skills/openclaw-saas-builder/scripts/deploy_vercel.sh

Typical flow:

1. verify framework and build output
2. confirm env vars
3. run Vercel link or init if needed
4. deploy
5. capture deployment URL
6. write deploy notes to deployment.md

Safety and approval rules

These actions change the outside world and should be treated as explicit-user-intent actions:

• creating remote repos
• pushing commits to remote
• creating cloud projects
• deploying to Vercel
• sending webhooks or emails

Planning, docs, scaffolding, and local implementation can proceed normally. For external side effects, confirm intent if the request is ambiguous.

How to use Gemini CLI inside this skill

Use gemini-cli skill patterns. Recommended helpers:

• ./skills/gemini-cli/scripts/check_gemini.sh
• ./skills/gemini-cli/scripts/gemini_json_validate.sh
• ./skills/gemini-cli/scripts/gemini_review.sh
• ./skills/gemini-cli/scripts/gemini_with_model.sh

Recommended Gemini uses:

• brainstorming product directions
• generating JSON specs
• drafting architecture alternatives
• drafting landing-page copy
• reviewing rewritten files
• naming ideas for repos or products

Bad use:

• blindly executing Gemini-generated shell
• trusting invalid JSON
• letting Gemini decide external side effects without review

Recommended outputs by project stage

Early stage

• requirements.md
• architecture.md
• Rules.md
• TODO.md

Mid stage

• code scaffold
• component and module plan
• .env.example
• test checklist

Late stage

• README.md
• deployment.md
• GitHub repo
• deploy URL

References

Read these when needed:

• references/saas-doc-templates.md
• references/repo-and-deploy-checklist.md
• references/saas-build-modes.md

Use skills/gemini-cli/references/website-prompts.md when the project includes a marketing site or landing page.

Publish readiness notes

This skill is meant to be practical, not magical. It assumes:

• Gemini CLI is installed and authenticated
• GitHub CLI is installed and authenticated for repo creation
• Vercel CLI is installed and authenticated for deployment
• OpenClaw remains the orchestrator for validation, editing, and safety decisions