跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
图像与绘图

phase-publish

Run Phase Publish — image generation sub-pipeline (provider-pluggable: relay primary + official OpenAI fallback, realtime-forced) + WordPress publish with RankMath meta + IndexNow ping. Use when draft has passed all quality gates and is ready for live publication. Triggered by /seo-blog publish, /publish, "post this to WordPress", "go live".

XuanRanL · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add XuanRanL/loamwright-SEO-Skill --skill phase-publish

技能说明


name: phase-publish description: Run Phase Publish — image generation sub-pipeline (provider-pluggable: relay primary + official OpenAI fallback, realtime-forced) + WordPress publish with RankMath meta + IndexNow ping. Use when draft has passed all quality gates and is ready for live publication. Triggered by /seo-blog publish, /publish, "post this to WordPress", "go live". allowed-tools: [Read, Write, Bash, Task] disable-model-invocation: true

Phase Publish Orchestrator

Image generation + WordPress upload + indexing notification + monitor registration.

Critical: disable-model-invocation: true — only triggered explicitly by user or upstream skill. Cannot be auto-invoked. Prevents accidental publishing.

Inputs

Required in workspace/{task_id}/:

  • draft.md with frontmatter Stage: optimized
  • meta.json
  • quality.json with overall_passed: true
  • review.json with score >= target_score

Required in ~/.xuanran-seo/credentials/wordpress/<slug>.json:

  • { url, username, app_password }

Stage 1: Image Sub-Pipeline (5 sub-stages, 1-34 min total)

Stage 27a: image-slot-allocator    (~2 sec, no LLM)
  Decide brief.image_count slots (default 6, max 8 — scripts/_core/image_policy.py): 1 cover (16:9) + the rest section images (16:9/4:3)
  Format-aware H2 selection (per BLOG-FORMATS-2026-CATALOG §2.2)
  Output: image_slots.json

Stage 27b: image-prompt-designer    (~15 sec, LLM)
  Read brand-identity.json (colors), brand-voice.md (aesthetic)
  Generate shared Art Direction Prefix (Strategy A visual consistency)
  Design 9-field prompt per slot
  Output: image_prompts.json

Stage 27c: openai-image-generator  (~1-3 min realtime, parallel max_workers=4)
  Routes to the provider chain (scripts/_core/image_provider.py):
    primary  = openclawroot relay  (realtime only — relays have NO Batch API)
    fallback = official OpenAI      (auto-tried PER-SLOT if the relay fails)
  Calls images.generate per slot, saves PNGs, writes images.json.
  Mode is FORCED realtime (config.yaml :: image.default_mode). Do NOT use
  --mode auto/batch here: that bypasses the relay (batch is official-only) and
  reproduces the 2026-05-21 "worst-of-both-worlds" wait.

Stage 27d: batch-job-poller         (SUPPLEMENTAL — only if an official-OpenAI
  batch was ever submitted; the canonical realtime flow does not need it)
  GET /v1/batches/{id} → status; download output_file when completed

Stage 27e: image-post-processor    (~10 sec, no LLM)
  EXIF strip + WebP convert + srcset 3 sizes + compress <200KB + SEO filename
  Generate ImageObject schema fragment

Stage 27f: image-curator            (REFERENCE-ONLY — no Stage() dispatches agents/image-curator.md; alt/caption polish happens in the scripted image pipeline + wp_publisher media fields)
  Polish alt text per image (≤125 chars, keyword-natural)
  Generate optional captions
  Replace [IMAGE-SLOT-N] placeholders in draft.md
  Inject ImageObject into schema @graph
  Update frontmatter Stage: images-injected

Cost: provider-dependent. At 4K high the ledger books ~$1.67/image → $10/article at the default 6 images ($13.4 at the max 8). The relay (openclawroot) is token-billed and typically cheaper, but cost_ledger deliberately over-estimates it with the official per-image table (conservative cost guard, see scripts/_core/image_provider.py).

Stage 2: WordPress Publish (~30 sec)

scripts/wordpress/wp_publisher.py (the canonical publisher — scripts/publish/ holds only change_log/gsc/indexnow helpers). Categories are resolve-only at publish: an unresolvable name aborts before any WP write (create deliberately at init via scripts.wordpress.setup_categories, or opt in with --allow-create-categories):

1. Upload every generated image to Media Library (multipart)
   - cover → featured_media
   - sections → inline references in body
   - All srcset variants uploaded
   - REQUIRED 4 metadata fields per upload: title + alt_text + caption + description
   
2. markdown_to_html(body) with anchor links resolved

3. PROJECT CSS INJECTION (required — see HARD RULE below)
   IF projects/{slug}/brand/article-css.css exists:
       css = projects/{slug}/brand/article-css.min.css (prefer minified)
       wrapper_class = read leading selector from CSS file
                       (internal name, typically "{slug}-pillar")
       # PUBLISHED name may differ: style_tokens rewrites it at the publish
       # boundary. Resolve with scripts._core.style_tokens, never hand-write.
       body_html = wrap_with_gutenberg_css_block(body_html, css, wrapper_class)
       # Append any trailing inline JSON-LD AFTER the closing wrapper
   
4. POST /wp-json/wp/v2/posts (status: **draft** — DEFAULT, do NOT publish yet)
   - title, slug, content (now CSS-wrapped), excerpt, categories, tags
   - featured_media = cover media_id
   - `status: "draft"` unless user explicitly opted in to publish-on-create (see step 8)
   - Returns post_id + preview URL

5. RankMath / Yoast meta via canonical bridge:
   - PREFERRED:  POST /wp-json/wp/v2/posts/{id} with body {"meta": {rank_math_*: ...}}
                 (works because the MU-plugin xuanran-rank-math-rest-bridge.php
                  registers RankMath keys with REST schema)
   - DEPRECATED: POST /xuanran/v1/rank-math-bridge (route returns 404 — only GET exists now)
   - Note: rank_math_robots enum is ["index","noindex","nofollow","noarchive","noimageindex","nosnippet"]
           — "follow" is NOT valid and will 400. Use ["index"] (follow is implicit default).

6. Inline JSON-LD for FAQPage / ItemList / BreadcrumbList — these are NOT 
   generated by RankMath's free tier; append as <script type="application/ld+json">
   to the post body OUTSIDE the CSS wrapper.

7. VERIFY against the PREVIEW URL (`/?p={id}&preview=true` works for drafts via authenticated session); confirm:
   - HTTP 200 (not 500 from malformed schema/HTML)
   - the project's wrapper class present in rendered HTML — resolve the PUBLISH
阅读完整来源 ↗