Formora Survey Skill / Formora 问卷技能

Language note: Instructions are written in English followed by Chinese (中文说明在英文之后).
Survey and form content auto-follows the user's input language.
语言说明： 技能文档先英文后中文。问卷和表单内容会自动跟随用户输入语言。

---

Core rule / 核心规则

EN: Always use this sequence:

CODEBLOCK0

Never auto-publish before the user explicitly approves the generated content.

ZH: 严格遵守以下顺序：

CODEBLOCK1

未经用户明确确认，绝不自动发布。

---

Language rule / 语言规则

EN:

• - Chinese input → survey in INLINECODE0
• English input → survey in INLINECODE1
• Explicit request → use that language
• Do not force Chinese by default
• Use --language auto unless user specifies otherwise
• Distribution copy also follows the inferred language

ZH:

• - 用户用中文输入 → 问卷使用 INLINECODE3
• 用户用英文输入 → 问卷使用 INLINECODE4
• 用户明确要求某语言 → 按要求使用
• 默认不强制中文
• CLI 省略 --language 或使用 INLINECODE6
• 分发文案同样跟随语言

---

Create / edit / publish / 创建 / 编辑 / 发布

CODEBLOCK2

EN: After every preview, ask the user:

"Here is the generated draft. Does this look right? Tell me what to change. I will only publish after your confirmation."

ZH: 每次预览后，询问用户：

"这是生成的草稿，请确认。如需修改请告知，确认后我才会发布。"

---

Organic distribution / 有机分发渠道

CODEBLOCK3

EN: broadcast tries every configured channel, skips unconfigured ones, prints a JSON result summary.

ZH: broadcast 会尝试所有已配置渠道，跳过未配置的渠道，输出 JSON 汇总报告。

Channels / 渠道

Channel / 渠道	Config / 配置	Fallback / 未配置时
Telegram	INLINECODE9 + INLINECODE10	生成 Telegram 文案
Email

himalaya + FORMORA_EMAIL_TO | 生成邮件主题和正文 | | QR code / 二维码 | Always available / 始终可用 | — | | X | FORMORA_X_API_KEY/SECRET/ACCESS_TOKEN/ACCESS_TOKEN_SECRET | 生成 X 文案 |

---

Paid ads / 付费广告投放

EN: Paid ads are intentionally more restrictive. ads-plan is always safe. ads-launch requires explicit budgets, enforces shared caps, and creates campaigns paused by default.

ZH: 付费广告有更严格的限制。ads-plan 不花钱。ads-launch 需要明确的预算参数，执行共享上限检查，默认创建暂停状态的广告系列。

Budget caps / 预算上限

EN: Google Ads and Meta Ads share one combined cap:

• - Daily cap: 50 CNY (combined)
• Weekly cap: 100 CNY (combined)

ZH: Google Ads 与 Meta Ads 合计共享上限：

• - 每日上限：50 元（合计）
• 每周上限：100 元（合计）

Safety config / 安全配置

CODEBLOCK4

Ads commands / 广告命令

CODEBLOCK5

Credentials / 平台凭证

Google Ads:

FORMORA_GOOGLE_ADS_CUSTOMER_ID=...        # format: 123-456-7890 or 1234567890
FORMORA_GOOGLE_ADS_DEVELOPER_TOKEN=...
FORMORA_GOOGLE_ADS_CLIENT_ID=...
FORMORA_GOOGLE_ADS_CLIENT_SECRET=...
FORMORA_GOOGLE_ADS_REFRESH_TOKEN=...
FORMORA_GOOGLE_ADS_API_VERSION=v19        # optional override / 可选

EN: For live Google submit, --geo must include ISO country codes, e.g. US,CA or CN. Supported codes: US CA GB AU CN JP KR DE FR IN BR MX SG HK TW TH ID PH VN MY.

ZH: 实际投放时 --geo 必须提供 ISO 国家代码，如 US,CA 或 CN。

Meta Ads:
CODEBLOCK7

EN: Phase 3 complete: both Meta and Google Ads support live paused campaign creation when full credentials are configured.

ZH: 第三阶段完成：Meta 和 Google Ads 均已支持实际创建（默认暂停状态），需提供完整凭证。

EN: ads-stop actively pauses live campaigns on both platforms via their APIs.

ZH: ads-stop 会通过 API 主动暂停两个平台的实际广告系列。

---

Retrieve responses and export / 获取回答与导出

CODEBLOCK8

---

Interactive wizard / 交互式向导

CODEBLOCK9

---

Agent workflow / 智能体工作流程

CODEBLOCK10

---

Notes / 备注

• - EN: Prefer broadcast for organic distribution. Prefer ads-plan before any paid work. Budget caps are shared across Google + Meta, not per platform.
• ZH: 有机分发优先用 broadcast。付费推广优先用 ads-plan。预算上限是 Google + Meta 合计，不是每个平台单独计算。
• EN: Survey content follows user language. Skill docs stay in English + Chinese.
• ZH: 问卷内容跟随用户语言。技能文档保持英中双语。