@tikomni/skills 0.1.0

package/skills/creator-analysis/references/asr-orchestration.md

@@ -0,0 +1,33 @@
+# Creator ASR Orchestration
+
+## Primary Path
+
+- Read `references/service-guides/asr-u2-u3-fallback.md` first and follow the shared flow: U2 primary path -> 90-second soft observation -> 120-second hard fallback -> U3 -> back to U2.
+- Video items in creator or profile tasks must prefer batch ASR.
+- The per-batch request limit is 100 `video_download_url` values.
+- Do not treat one-by-one serial or one-by-one parallel ASR calls as the primary path for creator tasks.
+
+## Two-Level Source Order
+
+1. If the route directly returns `subtitle_raw`:
+   - map it to `asr_raw` first
+2. If `subtitle_raw` is unavailable:
+   - call ASR with `video_download_url`
+
+## Timeout and Fallback
+
+- 90 seconds: soft observation threshold.
+- 120 seconds: hard fallback threshold.
+- If the batch is still incomplete after 120 seconds, run upload-media fallback only for the unsuccessful subset.
+
+## Upload-Media Fallback
+
+1. Call the upstream request route and obtain a temporary upload URL.
+2. Download or stream-relay the no-watermark video resource.
+3. Call the completion route and obtain a publicly readable URL.
+4. Call ASR again with the public URL.
+
+## Failure End State
+
+- If the upstream media-upload route is unavailable, mark the unsuccessful subset as `analysis_eligibility=incomplete`.
+- Keep fact cards for items with `analysis_eligibility=incomplete`, but exclude them from sampling, sampled explanations, and `author_analysis_v2`.

package/skills/creator-analysis/references/config-templates/defaults.yaml

@@ -0,0 +1,60 @@
+schema_version: v1
+profile: default
+
+runtime:
+  base_url: "https://api.tikomni.com"
+  auth_env_key: "TIKOMNI_API_KEY"
+  timeout_ms: 60000
+
+storage_routes:
+  default:
+    root_dir: ""
+    runs_dir: "_runs"
+    results_dir: "results"
+    errors_dir: "_errors"
+  content_kind_card_type:
+    single_video: work
+    work: work
+    author_home: author_sample_work
+    author_sample_work: author_sample_work
+    author_analysis: author
+  card_type_routes:
+    work:
+      prefix: "CBV"
+      parts:
+        - "内容系统"
+        - "对标研究"
+        - "作品卡"
+    author:
+      prefix: "CBA"
+      parts:
+        - "内容系统"
+        - "对标研究"
+        - "作者卡"
+    author_sample_work:
+      prefix: "CBV"
+      parts:
+        - "内容系统"
+        - "对标研究"
+        - "作者样本卡"
+        - "{platform}-{author_slug}"
+
+naming_rules:
+  card_filename_pattern: "{prefix}-{author_slug}-{title_slug}{ext}"
+  json_filename_pattern: "{timestamp}-{platform}-{identifier}{ext}"
+
+asr_strategy:
+  poll_interval_sec: 3.0
+  max_polls: 30
+  submit_retry:
+    douyin_video:
+      max_retries: 2
+      backoff_ms: 1500
+    xiaohongshu_note:
+      max_retries: 0
+      backoff_ms: 0
+  u2_timeout_retry:
+    enabled: true
+    max_retries: 3
+  author_home:
+    batch_submit_size: 50

package/skills/creator-analysis/references/contracts/creator-card-fields.md

@@ -0,0 +1,23 @@
+# Creator Card Fields
+
+## Fixed Display Fields
+
+- `platform`
+- `platform_author_id`
+- `author_handle`
+- `nickname`
+- `ip_location`
+- `signature`
+- `avatar_url`
+- `fans_count`
+- `liked_count`
+- `collected_count`
+- `works_count`
+- `verified`
+- `snapshot_at`
+
+## Key Rules
+
+- The creator card is the fact container for creator-level data.
+- The creator-level analysis body comes from `author_analysis_v2`, not from platform process fields.
+- Platform-native IDs stay in the internal reference layer and should not appear in the final creator-card body.

package/skills/creator-analysis/references/contracts/work-card-fields.md

@@ -0,0 +1,32 @@
+# Creator Work Card Fields
+
+## Fixed Display Fields
+
+- `platform`
+- `platform_work_id`
+- `platform_author_id`
+- `author_handle`
+- `title`
+- `caption_raw`
+- `work_modality`
+- `published_date`
+- `digg_count`
+- `comment_count`
+- `collect_count`
+- `share_count`
+- `play_count`
+- `cover_image`
+- `source_url`
+- `share_url`
+- `primary_text`
+
+## Video-Only Additional Fields
+
+- `asr_raw`
+- `video_download_url`
+
+## Key Rules
+
+- Keep fact cards for all retrieved works.
+- The final work card should not expose `content_type`, `publish_time`, `create_time_sec`, `subtitle_raw`, `asr_source`, `asr_status`, or `asr_error_reason`.
+- If a video item cannot obtain `asr_raw`, keep the fact card but mark `analysis_eligibility=incomplete` and exclude that item from creator analysis.

package/skills/creator-analysis/references/platform-guides/douyin.md

@@ -0,0 +1,49 @@
+# Douyin Creator Guide
+
+## Read This First
+
+- Use this guide first for Douyin creator, profile, and account tasks.
+- The validated chain in this repository is profile input -> `sec_user_id` resolution -> creator profile -> paginated post list.
+
+## Preferred Creator Resources
+
+- nickname: `nickname`
+- handle: `short_id` / `unique_id`
+- IP location
+- avatar
+- fan count, liked count, work count
+
+## Preferred Work Resources
+
+- work ID: `aweme_id`
+- title / caption: `title` / `desc`
+- video download URL: prefer the no-watermark path
+- engagement metrics: digg, comment, collect, share, play
+
+## Preferred Route Chain
+
+1. Profile identifier resolution: `GET /api/u1/v1/douyin/web/get_sec_user_id`
+   - OpenAPI-required input: `url`
+   - The current implementation also sends `share_url` redundantly.
+2. Creator profile: `GET /api/u1/v1/douyin/app/v3/handler_user_profile`
+   - Required input: `sec_user_id`
+3. Paginated post list: `GET /api/u1/v1/douyin/app/v3/fetch_user_post_videos`
+   - Required input: `sec_user_id`
+   - Common pagination parameters: `max_cursor`, `count`, `sort_type`
+
+## Unified Fields To Fill
+
+- creator card: `platform_author_id`, `author_handle`, `nickname`, `ip_location`, `signature`, `avatar_url`, `fans_count`, `liked_count`, `works_count`, `verified`
+- work cards: `platform_work_id`, `title`, `caption_raw`, `published_date`, `digg_count`, `comment_count`, `collect_count`, `share_count`, `play_count`, `video_download_url`
+
+## Route Rules
+
+- If `sec_user_id` is already available, skip the resolution route.
+- Default to the latest-post pagination path. Do not search random feed routes first.
+- If batch U2 ASR is still incomplete after 120 seconds, follow `references/service-guides/asr-u2-u3-fallback.md` and use U3 fallback only for the unsuccessful subset.
+- If the profile chain still cannot supply key creator fields, go back to `references/api-capability-index.md` and the matching `references/api-tags/*.md` to find supplemental routes instead of giving up on the creator card.
+
+## Current Runnable Implementation
+
+- `skills/creator-analysis/scripts/author_home/adapters/platform_adapters.py`
+- `skills/creator-analysis/scripts/author_home/orchestrator/run_author_analysis.py`

package/skills/creator-analysis/references/platform-guides/generic.md

@@ -0,0 +1,46 @@
+# Generic Creator Guide
+
+## Goal
+
+Map an unfamiliar platform into the unified creator-card and work-card contracts and then complete the creator analysis flow.
+
+## Read Order
+
+- Start with `references/api-capability-index.md` to lock onto the relevant platform tag.
+- Read the matching `references/api-tags/<tag>.md` for route summaries, inputs, request bodies, and success-response summaries.
+- Prioritize routes related to `user / author / creator / profile / home / channel / posts / notes / videos`.
+- Add comment, media-download, subtitle, and extra-metric routes only when needed.
+
+## Minimum Mapping Checklist
+
+creator side:
+
+- `platform_author_id`
+- `author_handle`
+- `nickname`
+- `ip_location`
+- `signature`
+- `avatar_url`
+- `fans_count`
+- `liked_count`
+- `collected_count`
+- `works_count`
+- `verified`
+
+work side:
+
+- the required fields from the unified work-card field dictionary
+- for video items: `video_download_url`
+
+## Route Rules
+
+- The creator-profile chain must cover both creator information and paginated work-list retrieval. Do not stop at a profile-only route.
+- If the platform provides multiple profile routes or posts routes, prefer the variant with fuller fields and more stable pagination.
+- The work-list route must reliably provide `platform_work_id` and the main published-time and engagement fields before sampling or aggregation can begin.
+- If video items have no subtitles and no download path, mark ASR as infeasible at the route-selection stage.
+- If batch U2 ASR is still incomplete after 120 seconds, follow `references/service-guides/asr-u2-u3-fallback.md` and use U3 fallback only for the unsuccessful subset.
+
+## Current Runnable Implementation
+
+- `skills/creator-analysis/scripts/author_home/`
+- `skills/creator-analysis/scripts/core/`

package/skills/creator-analysis/references/platform-guides/xiaohongshu.md

@@ -0,0 +1,54 @@
+# Xiaohongshu Creator Guide
+
+## Read This First
+
+- Use this guide first for Xiaohongshu creator, profile, and account tasks.
+- The validated chain in this repository is profile input -> `user_id` / `xsec_token` resolution -> profile cascade -> post-list cascade.
+
+## Preferred Creator Resources
+
+- nickname
+- handle
+- IP location
+- avatar
+- fan count, liked count, work count
+
+## Preferred Work Resources
+
+- work ID: `note_id`
+- title / caption: `title` / `desc` / `content`
+- for video items, check native subtitles first
+- engagement metrics: digg, comment, collect, share, play
+
+## Preferred Route Chain
+
+1. Profile identifier resolution: `GET /api/u1/v1/xiaohongshu/app/get_user_id_and_xsec_token`
+   - OpenAPI-required input: `share_link`
+   - The current implementation also sends `share_url` and `url` redundantly.
+2. Profile cascade:
+   - `GET /api/u1/v1/xiaohongshu/app_v2/get_user_info`
+   - `GET /api/u1/v1/xiaohongshu/web_v2/fetch_user_info_app`
+   - `GET /api/u1/v1/xiaohongshu/app/get_user_info`
+   - Typical input: `user_id`, with `share_text` / `xsec_token` as needed
+3. Post-list cascade:
+   - `GET /api/u1/v1/xiaohongshu/app_v2/get_user_posted_notes`
+   - `GET /api/u1/v1/xiaohongshu/web_v2/fetch_home_notes_app`
+   - `GET /api/u1/v1/xiaohongshu/app/get_user_notes`
+   - Typical input: `user_id`, `cursor`
+
+## Unified Fields To Fill
+
+- creator card: `platform_author_id`, `author_handle`, `nickname`, `ip_location`, `signature`, `avatar_url`, `fans_count`, `liked_count`, `collected_count`, `works_count`, `verified`
+- work cards: `platform_work_id`, `title`, `caption_raw`, `published_date`, `digg_count`, `comment_count`, `collect_count`, `share_count`, `play_count`, `video_download_url`
+
+## Route Rules
+
+- If `user_id` is already available, skip the resolution route. Treat `xsec_token` as supplemental rather than universally required.
+- Try both the profile cascade and the posts cascade in order, and switch to fallback based on field completeness.
+- If batch U2 ASR is still incomplete after 120 seconds, follow `references/service-guides/asr-u2-u3-fallback.md` and use U3 fallback only for the unsuccessful subset.
+- If the profile-post chain still cannot provide stable fields, go back to `references/api-capability-index.md` and the matching `references/api-tags/*.md` for supplemental routes instead of sending half-complete data into creator analysis.
+
+## Current Runnable Implementation
+
+- `skills/creator-analysis/scripts/author_home/adapters/platform_adapters.py`
+- `skills/creator-analysis/scripts/author_home/orchestrator/run_author_analysis.py`

package/skills/creator-analysis/references/prompt-contracts/asr-clean.md

@@ -0,0 +1,28 @@
+# Prompt Contract · ASR_CLEAN
+
+## Inputs
+- `raw_content`
+- `asr_raw`（统一字幕/转写文本主字段）
+- `asr_clean`（遗留兼容字段，仅可作为附加输入）
+
+## Method (stable)
+1. 选择输入基底：优先 `asr_raw`，否则 `raw_content`，最后才允许兼容读取 `asr_clean`。
+2. 去噪清洗：移除明显口头禅、重复叠词、异常空白。
+3. 语义断句：按 `。！？；\n` 断句，并补齐句末中文标点。
+4. 分段规则：每句单独一行，每段 2~4 句，段间空一行。
+5. 保真约束：不新增事实、不改写核心结论、不输出提示词文本。
+
+## Output Format
+- 纯文本多段落：
+  - 每句一行
+  - 段间空行
+
+## Constraints
+- 不把清洗提示词写入正文。
+- 不生成“总结式改写”，仅做可读性清洗。
+- 不得凭空补充数据、观点和案例。
+
+## Fallback / Data-insufficient
+- 两个输入均为空：输出空字符串。
+- 断句失败：保留原文并补单句句号。
+- 超长段落：强制按 3 句一段切分。

package/skills/creator-analysis/references/prompt-contracts/author-analysis-v2.md

@@ -0,0 +1,46 @@
+# Author Analysis V2 Prompt Contract
+
+## Goal
+
+生成结构化的 `author_analysis_v2`，回答作者是谁、为什么可信、内容机制如何运作、能学什么、什么不能学。不要输出松散夸赞文案。
+
+## Allowed Inputs
+
+- 作者卡事实字段
+- 全量聚合结果
+- Sampled works 的统一事实字段：
+  - `platform_work_id`
+  - `title`
+  - `caption_raw`
+  - `work_modality`
+  - `primary_text`
+  - 互动指标
+  - 结构标签
+- 可选的 `sampled_work_explanations`
+
+## Hard Rules
+
+- 主分析文本始终使用 `primary_text`。
+- `title`、`caption_raw`、`asr_raw` 各自语义不同，不得混用。
+- 不把 `caption_raw` 当作字幕或 ASR fallback。
+- 不进行逐条作品 LLM topic classification。
+- 结论优先落在机制层，不写表面夸赞。
+- 证据不足时先降置信度，再收窄结论。
+
+## Required Output Modules
+
+- `author_positioning`
+- `trust_model`
+- `cognitive_engine`
+- `expression_hooks`
+- `content_mechanism`
+- `commercial_bridge`
+- `core_tensions`
+- `evidence_pack`
+- `clone_guidance`
+
+## Failure Guards
+
+- `sample_size < 5` 时不得标高置信度。
+- `sampled_work_explanations` 缺失时也必须返回完整的 `author_analysis_v2`，但要在 `evidence_pack` 中降低置信度或说明边界。
+- `analysis_eligibility=incomplete` 的作品不得进入证据样本。

package/skills/creator-analysis/references/prompt-contracts/author-analysis.md

@@ -0,0 +1,49 @@
+# Prompt Contract · 作者对标分析（author-analysis）
+
+## User Prompt (Verbatim)
+
+```text
+你是“内容商业增长顾问 + 对标拆解师”。
+目标：基于作者主页资料与作品样本，输出作者对标分析 JSON。
+
+硬约束：
+1) 只输出 JSON 对象，不要 markdown，不要解释。
+2) 字段必须完整、类型必须正确。
+3) 不得捏造事实；缺数据时用“数据不足”或保守分值。
+4) 评分范围 0-100。
+
+输出 Schema：
+{
+  "author_portrait": "string",
+  "business_analysis": "string",
+  "benchmark_analysis": "string",
+  "business_score": 0,
+  "benchmark_gap_score": 0,
+  "style_radar": {
+    "选题": 0,
+    "表达": 0,
+    "结构": 0,
+    "节奏": 0,
+    "人设": 0,
+    "转化": 0,
+    "差异化": 0,
+    "稳定性": 0
+  },
+  "core_contradictions": ["string"],
+  "recommendations": ["string"]
+}
+
+口径：
+- 先给结论，再给理由。
+- recommendations 必须可执行，最多 5 条。
+- core_contradictions 必须是“现状冲突”而非空泛观点。
+```
+
+## Inputs
+- `author_profile`
+- `works`（含 `title/desc/asr_raw/subtitle_raw/asr_source/metrics/tags/content_type`）
+
+## Constraints
+- 仅基于输入推断，不得臆造。
+- 输出中文，简洁直接。
+- 缺数据时明确标注“数据不足”。

package/skills/creator-analysis/references/prompt-contracts/cta.md

@@ -0,0 +1,24 @@
+# Prompt Contract · CTA
+
+## Inputs
+- `asr_raw`（主字段）
+- `asr_clean`（遗留兼容字段）
+
+## Method (stable)
+1. 扫描 CTA 关键词句（评论/关注/私信/收藏/转发/领取/报名/咨询/下单）。
+2. 判定 CTA 类型：互动型 / 线索型 / 转化型。
+3. 提取关键动作句（默认取最后一个 CTA 句）。
+4. 计算 CTA 密度（CTA句数/总句数）。
+
+## Output Format
+- `CTA类型`：`互动型、线索型...`
+- `关键动作句`：`原句`
+- `CTA密度`：`x/y 句`
+
+## Constraints
+- 必须给出至少一个动作句或明确说明缺失。
+- 不得虚构转化链路。
+
+## Fallback / Data-insufficient
+- 字幕/转写文本为空：输出“数据不足”。
+- 无 CTA 句：输出“未检测到明确行动号召”，并给最小补全建议。

package/skills/creator-analysis/references/prompt-contracts/hook.md

@@ -0,0 +1,25 @@
+# Prompt Contract · Hook
+
+## Inputs
+- `title`
+- `asr_raw`（主字段）
+- `asr_clean`（遗留兼容字段）
+
+## Method (stable)
+1. 提取开头钩子：ASR 首句（无则用标题）。
+2. 提取中段钩子：ASR 中位句。
+3. 提取结尾钩子：最后一句含 CTA/召回词的句子。
+4. 开头钩子类型判定：疑问式 / 反常识式 / 场景代入式 / 陈述式。
+
+## Output Format
+- `开头钩子（类型）`：`原句`
+- `中段钩子`：`原句`
+- `结尾钩子`：`原句`
+
+## Constraints
+- 必须优先输出原话，不做大幅改写。
+- 结尾若无动作句要明确标注“未检测到明确结尾钩子”。
+
+## Fallback / Data-insufficient
+- 标题与 ASR 均缺失：三项输出“数据不足”。
+- 中段不足：输出“数据不足（中段文本不足）”。

package/skills/creator-analysis/references/prompt-contracts/insight.md

@@ -0,0 +1,47 @@
+# Prompt Contract · 洞察分析（insight）
+
+## User Prompt (Verbatim)
+
+```text
+=== 你的身份 ===
+一位见证了无数内容起落的观察者，曾亲手打造过刷屏级作品，也经历过石沉大海的落寞。
+你能透过表象看到人性的涌动，理解为什么有些内容能击中集体潜意识。
+=== 核心信念 ===
+爆款不是运气的产物，而是人性规律的必然显现。
+真正的洞察者不追逐热点，而是理解热点背后的情感暗流。
+=== 分析维度 ===
+- 情绪共振点：触发了哪根集体心弦
+- 认知势能差：创造了怎样的信息落差
+- 社交货币值：给了人们什么谈资筹码
+- 行动驱动力：激发了哪种传播冲动
+=== 洞察深度 ===
+像考古学家解读文物，你要揭示：
+- 表层吸引力（第一眼为什么会停留）
+- 中层粘性（为什么会看完）
+- 深层共鸣（为什么会转发）
+- 底层动机（满足了什么心理需求）
+=== 表达方式 ===
+如同品酒师描述佳酿——既有专业的解构，也有诗意的感受。
+用清晰的逻辑拆解成功密码，用生动的类比让洞察可感知。
+=== 独特价值 ===
+不做事后诸葛亮式的解释，而是提炼可复用的原理。
+让创作者读完后恍然大悟："原来爆款的秘密藏在这里。"
+=== 分析美学 ===
+呈现如解剖图般精准，又如水墨画般留有想象空间。
+既见树木（具体技巧），也见森林（传播规律）。
+=== 终极使命 ===
+帮助创作者建立"爆款直觉"——
+不是教他们追逐每一个热点，而是理解什么样的内容天生具有传播基因。
+```
+
+## Inputs
+- `title`
+- `asr_raw`（优先）
+- `raw_content`（`asr_raw` 缺失时回退）
+- `asr_clean`（遗留兼容字段）
+- 指标：`digg_count/comment_count/collect_count/share_count/play_count`
+
+## Constraints
+- 仅基于输入字段推断，不得臆造事实。
+- 输出为中文，短句、可执行、可追溯。
+- 缺数据时明确标注“数据不足”。

package/skills/creator-analysis/references/prompt-contracts/sampled-work-batch-explanations.md

@@ -0,0 +1,30 @@
+# Sampled Work Batch Explanations Prompt Contract
+
+## Goal
+
+对 sampled works 进行一次批量解释，补充单作品层没有的解释性字段。只允许一次批量调用，不允许逐条调用。
+
+## Allowed Inputs
+
+- Sampled works 的统一事实字段
+- 作品级结构标签
+- 聚合差异信息
+
+## Required Output
+
+顶层输出 `sampled_work_explanations`，以 `platform_work_id` 为 key。
+
+每个 sampled work 必须包含：
+
+- `why_it_worked_or_failed`
+- `copyable_elements`
+- `non_copyable_elements`
+- `emotional_triggers`
+- `cognitive_gap`
+- `commercial_signal`
+
+## Hard Rules
+
+- 只解释 sampled works，不解释全量作品。
+- 不得伪造作品中不存在的商业信号或情绪机制。
+- 不得把结果直接写成作者级结论；作者级结论归 `author_analysis_v2`。

package/skills/creator-analysis/references/prompt-contracts/structure.md

@@ -0,0 +1,25 @@
+# Prompt Contract · 结构（structure）
+
+## Inputs
+- `asr_raw`（主字段）
+- `asr_clean`（遗留兼容字段，不应被前置依赖）
+
+## Method (stable)
+1. 对每句进行结构标签检测：`钩子/冲突/转折/举证/CTA`。
+2. 统计各标签覆盖次数。
+3. 根据覆盖度判定模板：
+   - 覆盖 >=4：`钩子→冲突→转折→举证→CTA`
+   - 否则：`钩子→观点→补充说明`
+4. 输出缺失模块，作为改写优先级。
+
+## Output Format
+- `结构标签覆盖`：`钩子:a, 冲突:b, 转折:c, 举证:d, CTA:e`
+- `模板判定`：`...`
+- `缺失模块`：`模块1、模块2`（无则“无”）
+
+## Constraints
+- 所有判断必须来自句级关键词命中。
+- 不允许跳过缺失项输出。
+
+## Fallback / Data-insufficient
+- 无有效分句：输出“数据不足”，并提示“补充字幕/转写文本后再做结构标注”。

package/skills/creator-analysis/references/prompt-contracts/style.md

@@ -0,0 +1,27 @@
+# Prompt Contract · 文风（style）
+
+## Inputs
+- `title`
+- `asr_raw`（主字段）
+- `asr_clean`（遗留兼容字段）
+
+## Method (stable)
+1. 分句后统计平均句长（短/中/长）。
+2. 统计疑问/感叹/陈述分布。
+3. 统计人设代词（我/你/我们/大家）与修辞触发词（不是/而是/其实/必须）。
+4. 输出“人设+句式+语气”三层结论。
+
+## Output Format
+- `句式结构`：`<类型>，平均句长约 X 字`
+- `语气分布`：`疑问 A / 感叹 B / 陈述 C`
+- `人设与修辞`：`人设代词命中 N 次，强调/转折词命中 M 次`
+
+## Constraints
+- 至少 2 个统计指标；禁止空泛描述。
+- 仅基于文本统计，不猜测作者背景。
+- 不输出表格。
+
+## Fallback / Data-insufficient
+- `asr_raw`（主字段）
+- `asr_clean`（遗留兼容字段） 为空：三项均输出“数据不足”。
+- 分句失败：标注“需人工复核”。

package/skills/creator-analysis/references/prompt-contracts/summary.md

@@ -0,0 +1,29 @@
+# Prompt Contract · 总结（summary）
+
+## Inputs
+- `topic_score`
+- `style_score`
+- `hook_score`
+- `structure_score`
+- `cta_score`
+- 各模块 `gaps`
+
+## Method (stable)
+1. 计算 5 模块平均分。
+2. 结论分级：
+   - `>=4.2`：可直接复用
+   - `3.4~4.19`：可用但需小幅优化
+   - `<3.4`：需重写关键模块
+3. 选择最低 1-2 个模块，输出针对性建议（优先 gaps）。
+
+## Output Format
+- `结论`：`综合评分 X/5，判定为“...”`
+- `建议`：最多 3 条，短句、可执行。
+
+## Constraints
+- 只输出“结论+建议”，不再拆“好/差/改写”。
+- 建议必须指向具体模块。
+
+## Fallback / Data-insufficient
+- 若分数无法计算：输出“数据不足，需先完成5模块分析”。
+- 若无 gaps：输出“继续做A/B测试验证Hook与CTA”。

package/skills/creator-analysis/references/prompt-contracts/topic.md

@@ -0,0 +1,29 @@
+# Prompt Contract · 选题（topic）
+
+## Inputs
+- `title`（作品标题，必填优先）
+- `asr_raw`（统一字幕/转写文本主字段）
+- `asr_clean`（遗留兼容字段，不应作为主依赖）
+- `category`（可选，已有分类）
+- `tags`（可选）
+
+## Method (stable)
+1. 按关键词命中做**基础类型三分**：流量型 / 人设型 / 营销型。  
+2. 结合标题+字幕/转写文本做**弱主题线索提取**（Top 3），不得输出 rigid 赛道归类。  
+3. 从问题词/痛点词提取**受众痛点**。  
+4. 输出必须给出命中证据，不得仅主观判断。
+
+## Output Format
+- `主题线索`：`词1、词2、词3`
+- `受众痛点`：`痛点1、痛点2`
+- `说明`：`仅为弱语义线索，不是 rigid topic 分类`
+
+## Constraints
+- 只使用输入数据推断，不引用外部知识。
+- 结论必须可追溯到词命中或句段。
+- 不输出表格。
+
+## Fallback / Data-insufficient
+- `title` 与 `asr_raw` 均缺失：输出“数据不足”。
+- 主题词命中为 0：输出“数据不足（未检测到显著主题词）”。
+- 痛点词命中为 0：输出“以降低门槛/快速落地为主（显性痛点词不足）”。