Xhs Viral Rewrite

xhs-viral-rewrite — 爆款人设改写

Takes a viral-pulse report's TOP 30 notes + a persona JSON, produces 30 bespoke Carol-style rewrites where each preserves the validated viral hook but speaks in the creator's own voice.

When to use

User has run xhs-viral-pulse and wants persona-aware rewrites:

• 「把刚才那份爆款用我人设改写一遍」
• 「按我人设把这 30 条改成我能拍的标题」
• 「Rewrite these viral hooks for my persona」

Quick start

python3 shared/lib/cli.py viral-rewrite \
  --input output/2026-04-27/viral-pulse/ \
  --persona 真相拆解师

If --input omitted, uses the most recent viral-pulse output. If --persona omitted, uses config.yaml::defaults.persona.

What it produces

Updates the existing viral-pulse report in Feishu by:

1. Adding §六「Joyce 人设改写映射 (TOP 30)」 — 30-row table mapping original viral title → recommended form + persona-adapted rewrite + transformation angle
2. Updating §四 TOP 10 选题 — each topic gains an 原爆款锚点 field linking to specific TOP 30 notes
3. Updating the sheet — adds 2 columns: 推荐改编形式 + 改写标题

How the rewrite engine works (key design decision)

Not pure rules (v0.1/v0.2 produced repetitive, non-fluent output). Not manual curation (v0.3 wasn't automatable). Instead: prompt-template-driven.

The skill writes a structured prompt to output//viral-rewrite/rewrite_request.md containing:

• Full persona JSON (coretags, voicesignature_phrases, constraints, etc.)
• All 30 TOP viral notes (title + likes + pattern + content excerpt)
• The 6-stratum guide as context
• Carol's 7 reference rewrites as style anchor
• Output format schema

Then the skill invokes Claude (the agent running this skill) to fill in 30 bespoke rewrites following the prompt. The skill parses Claude's response and merges back into a structured rewrites.json.

This pattern matches Anthropic best practice for high-degrees-of-freedom tasks: the skill provides constrained guidance + reference data, the LLM provides synthesis.

See [workflow.md](workflow.md) for the full prompt template.

Workflow detail

See [workflow.md](workflow.md).

Composition with other skills

• Required input: xhs-viral-pulse output (directory with analysis.json + report.md)
• Required input: xhs-persona-synth output (persona JSON)

Failure modes — feishu output is REQUIRED

The skill must end with a Feishu doc URL handed back to the user (the updated viral-pulse doc with §六 appended). If feishu push fails for any reason, stop and ask the user to fix the configuration. Do NOT silently degrade to local-only output.

| Failure | Action | |---|---| | lark-cli binary not in PATH | STOP. Tell user to install lark-cli per [setup/02installlarkcli.md](../../setup/02installlarkcli.md). | | lark-cli auth expired (LarkAuthExpired) | STOP. Tell user: lark-cli auth login --as bot | | Bot lacks scope (LarkScopeMissing) | STOP. Show the scope_url from the error; user grants in 1 click in 飞书 console. | | feishu_artifacts.json missing in viral-pulse output | STOP. Tell user to re-run viral-pulse first so the original Feishu doc exists. | | config.yaml missing feishu.folder_token | STOP. Tell user to edit config.yaml. |

Local markdown / JSON files saved during the run are intermediate artifacts — they are not the deliverable.

Examples

See [examples.md](examples.md) and [../../examples/viralrewritesample.md](../../examples/viralrewritesample.md).

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Jeorrysyd
• Source: Jeorrysyd/xhs-viral-decoder
• License: MIT

Install and usage instructions live in the source repository linked above.