2.7 KiB

Raw Blame History

name	description
first-time-setup	First-time setup flow for baoyu-article-illustrator preferences

First-Time Setup

Overview

When no EXTEND.md is found, guide user through preference setup.

Setup Flow

No EXTEND.md found
        │
        ▼
┌─────────────────────┐
│ AskUserQuestion     │
│ (all questions)     │
└─────────────────────┘
        │
        ▼
┌─────────────────────┐
│ Create EXTEND.md    │
└─────────────────────┘
        │
        ▼
    Continue to Step 1

Questions

Language: Use user's input language or preferred language for all questions. Do not always use English.

Use single AskUserQuestion with multiple questions (AskUserQuestion auto-adds "Other" option):

Question 1: Watermark

header: "Watermark"
question: "Watermark text for generated illustrations? Type your watermark content (e.g., name, @handle)"
options:
  - label: "No watermark (Recommended)"
    description: "No watermark, can enable later in EXTEND.md"

Position defaults to bottom-right.

Question 2: Preferred Style

header: "Style"
question: "Default illustration style preference? Or type another style name or your custom style"
options:
  - label: "None (Recommended)"
    description: "Auto-select based on content analysis"
  - label: "notion"
    description: "Minimalist hand-drawn line art"
  - label: "warm"
    description: "Friendly, approachable, personal"

Question 3: Save Location

header: "Save"
question: "Where to save preferences?"
options:
  - label: "Project"
    description: ".baoyu-skills/ (this project only)"
  - label: "User"
    description: "~/.baoyu-skills/ (all projects)"

Save Locations

Choice	Path	Scope
Project	`.baoyu-skills/baoyu-article-illustrator/EXTEND.md`	Current project
User	`~/.baoyu-skills/baoyu-article-illustrator/EXTEND.md`	All projects

After Setup

Create directory if needed
Write EXTEND.md with frontmatter
Confirm: "Preferences saved to [path]"
Continue to Step 1

EXTEND.md Template

---
version: 1
watermark:
  enabled: [true/false]
  content: "[user input or empty]"
  position: bottom-right
  opacity: 0.7
preferred_style:
  name: [selected style or null]
  description: ""
language: null
custom_styles: []
---

Modifying Preferences Later

Users can edit EXTEND.md directly or run setup again:

Delete EXTEND.md to trigger setup
Edit YAML frontmatter for quick changes
Full schema: config/preferences-schema.md

2.7 KiB Raw Blame History