@aswless_854771076/ai_short_studio_cli 0.1.98 → 0.1.100

package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/analyze-drama-market.md

@@ -0,0 +1,47 @@
+# 分析短剧市场
+
+用于用户询问近期短剧题材趋势、平台榜单、市场机会、竞争格局或要求市场报告。不得用于分析单部小说或剧本、预测投资收益，或绕过付费或登录权限获取数据。
+
+先确认用户提供的工作区存在且可访问，再执行 `node "${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}/scripts/market-research.mjs" list <workspace>`，核对最新快照、最新报告和报告覆盖范围。必须先读取本 Skill 的 [方法说明](analyze-drama-market/methodology.md)，再解读任何指标。
+
+默认不联网：优先使用最新已保存报告；若有快照但没有所需报告，执行 `node "${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}/scripts/market-research.mjs" analyze <workspace> [snapshot-id]`。只有用户明确要求刷新时才联网，才可执行 `node "${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}/scripts/market-research.mjs" refresh <workspace>`。刷新后用 `report <workspace> [report-id]` 回读 JSON 与 Markdown 路径；不要把“近期”“最新”自行解释为授权刷新。
+
+可用命令合同：
+
+- `refresh <workspace>`：采集公开榜单、保存快照并生成报告。
+- `analyze <workspace> [snapshot-id]`：只读取已有快照并生成报告。
+- `report <workspace> [report-id]`：输出 JSON 与 Markdown 路径。
+- `list <workspace>`：输出已保存报告摘要 JSON。
+- `--self-check`：检查 CLI 合同。
+
+引用量化结论时说明 `report_id` 及对应 evidence 条目；标题关键词推断仅是低置信度线索，不得叙述为确定事实。持续展示并重复适用边界：数据仅覆盖剧查查公开 Top 30 榜单样本，不代表全量市场，也不构成收入、投资或投放承诺。
+
+输出固定为以下顺序；无数据时保留标题并说明原因。
+
+## 事实
+
+报告 ID、快照时间、成功/失败榜单、样本数与公开 Top 30 覆盖边界。
+
+## 机会
+
+列出题材机会分、样本量、置信度和支持证据，不将机会分等同于收益预测。
+
+## 风险
+
+说明拥挤度、公司集中度、低置信标签、缺失榜单和趋势可比性风险。
+
+## 平台
+
+按平台矩阵比较作品覆盖和榜内排名，不跨榜单直接比较原始热度数值。
+
+## 新剧
+
+说明新剧观察名单、榜单排名和证据；未明确标为新剧的数据不得补推。
+
+## 创作启示
+
+把题材机会转为可验证的创作假设，明确其不能覆盖来源事实、合规要求或用户已确认创意。
+
+## 限制
+
+保留报告全部限制，特别是公开 Top 30、单快照、失败榜单、标签来源和趋势不可比边界。

package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/ideate-drama-from-market/market-inspiration.schema.json

@@ -0,0 +1,109 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Short drama market inspiration v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "report_ref", "signals", "hypotheses", "decision", "guardrails"],
+  "properties": {
+    "schema_version": {"const": "market-inspiration.v1"},
+    "report_ref": {"$ref": "#/$defs/reportRef"},
+    "signals": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/signal"}},
+    "hypotheses": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/hypothesis"}},
+    "decision": {"$ref": "#/$defs/decision"},
+    "guardrails": {"$ref": "#/$defs/guardrails"}
+  },
+  "$defs": {
+    "marketId": {"type": "string", "pattern": "^[A-Za-z0-9+_-]{1,80}$"},
+    "localId": {"type": "string", "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]*$"},
+    "nonEmptyString": {"type": "string", "minLength": 1},
+    "nonEmptyStrings": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"$ref": "#/$defs/nonEmptyString"}},
+    "filters": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "audience": {"$ref": "#/$defs/filterValue"},
+        "era": {"$ref": "#/$defs/filterValue"},
+        "format": {"$ref": "#/$defs/filterValue"},
+        "topic": {"$ref": "#/$defs/filterValue"},
+        "rankingTypes": {"$ref": "#/$defs/filterValue"}
+      }
+    },
+    "filterValue": {"oneOf": [{"$ref": "#/$defs/nonEmptyString"}, {"$ref": "#/$defs/nonEmptyStrings"}]},
+    "reportRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["report_id", "snapshot_ids", "generated_at", "filters", "sha256", "selected_hypothesis_ids"],
+      "properties": {
+        "report_id": {"$ref": "#/$defs/marketId"},
+        "snapshot_ids": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"$ref": "#/$defs/marketId"}},
+        "generated_at": {"$ref": "#/$defs/rfc3339DateTime"},
+        "filters": {"$ref": "#/$defs/filters"},
+        "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
+        "selected_hypothesis_ids": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"$ref": "#/$defs/localId"}}
+      }
+    },
+    "evidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["snapshot_id", "ranking_type", "playlet_id", "key"],
+      "properties": {
+        "snapshot_id": {"$ref": "#/$defs/marketId"},
+        "ranking_type": {"$ref": "#/$defs/nonEmptyString"},
+        "playlet_id": {"type": ["string", "number"]},
+        "key": {"$ref": "#/$defs/nonEmptyString"}
+      }
+    },
+    "signal": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "fact", "confidence", "evidence", "limitations"],
+      "properties": {
+        "id": {"$ref": "#/$defs/localId"},
+        "fact": {"$ref": "#/$defs/nonEmptyString"},
+        "confidence": {"enum": ["high", "medium", "low"]},
+        "evidence": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/evidence"}},
+        "limitations": {"$ref": "#/$defs/nonEmptyStrings"}
+      }
+    },
+    "hypothesis": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "derived_signal_ids", "inference", "creative_transformation", "premises", "opening_hook", "serial_engine", "differentiation", "production_fit", "risks", "validation_questions"],
+      "properties": {
+        "id": {"$ref": "#/$defs/localId"},
+        "derived_signal_ids": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"$ref": "#/$defs/localId"}},
+        "inference": {"$ref": "#/$defs/nonEmptyString"},
+        "creative_transformation": {"$ref": "#/$defs/nonEmptyString"},
+        "premises": {"$ref": "#/$defs/nonEmptyStrings"},
+        "opening_hook": {"$ref": "#/$defs/nonEmptyString"},
+        "serial_engine": {"$ref": "#/$defs/nonEmptyString"},
+        "differentiation": {"$ref": "#/$defs/nonEmptyString"},
+        "production_fit": {"$ref": "#/$defs/nonEmptyString"},
+        "risks": {"$ref": "#/$defs/nonEmptyStrings"},
+        "validation_questions": {"$ref": "#/$defs/nonEmptyStrings"}
+      }
+    },
+    "decision": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["selected_hypothesis_ids", "rejected_hypothesis_ids", "confirmed_at"],
+      "properties": {
+        "selected_hypothesis_ids": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"$ref": "#/$defs/localId"}},
+        "rejected_hypothesis_ids": {"type": "array", "uniqueItems": true, "items": {"$ref": "#/$defs/localId"}},
+        "confirmed_at": {"oneOf": [{"$ref": "#/$defs/rfc3339DateTime"}, {"type": "null"}]}
+      }
+    },
+    "rfc3339DateTime": {"type": "string", "format": "date-time", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})$"},
+    "guardrails": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["no_title_copy", "no_plot_copy", "no_revenue_promise", "market_data_non_authoritative"],
+      "properties": {
+        "no_title_copy": {"const": true},
+        "no_plot_copy": {"const": true},
+        "no_revenue_promise": {"const": true},
+        "market_data_non_authoritative": {"const": true}
+      }
+    }
+  }
+}

package/skills/using-vvicat-ai-short-studio-cli/references/short-drama/market/ideate-drama-from-market.md

@@ -0,0 +1,15 @@
+# 从市场洞察短剧灵感
+
+用于用户明确希望参考市场报告、榜单信号或题材机会来构思短剧时。只读取用户指定或已确认使用的本地 `market-report.v2`；不自行联网刷新，不把“近期”理解为刷新授权。
+
+先读取 [市场灵感合同](ideate-drama-from-market/market-inspiration.schema.json) 和报告中的 `coverage`、`limitations`、`evidence`。输出前把内容分层：
+
+- `signals[].fact` 只陈述报告中可由 `evidence` 回链的市场事实，并保留对应置信度和限制；低置信信号不得升格为确定结论。
+- `hypotheses[].inference` 说明由事实推出的有限判断，必须列出 `derived_signal_ids` 与前提。
+- `creative_transformation`、开场钩子和连续集引擎是原创创作假设，必须能被后续用户或样片验证，不得伪装为市场事实。
+
+不得复用或改写榜单作品标题、人物关系、具体情节、独特台词或故事结构；不得承诺收入、投放效果或市场必然成功。差异化字段应明确原创变换，风险和验证问题不得省略。
+
+使用 `../../assets/modules/ideate-drama-from-market/prompts/market_inspiration.{zh,en}.txt` 生成严格 JSON。用户选定假设后，必须运行 `node "${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}/scripts/project-store.mjs" market-report-ref <项目目录> <report ID> <已选 hypothesis ID>...`，把命令输出逐字段原样用作 `report_ref`；不得自行计算或猜测 SHA-256。该入口从指定的已保存报告生成报告 ID、快照 IDs、生成时间、筛选、规范 JSON SHA-256 和已选假设 IDs，并与保存校验复用相同摘要规则。`decision.selected_hypothesis_ids` 必须与生成引用一致。完成后可用 `node "${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-.}}/scripts/project-store.mjs" put-document <项目目录> market-inspiration <JSON>` 保存。
+
+保存到项目不是默认动作：只有用户明确要求将市场灵感用于该项目时，才写入 `market-inspiration.json`，并在 Brief 的 `market_inspiration_ref` 中写入相同的完整 `report_ref`。不得自动改写项目题材、平台、来源事实、合规约束或用户已确认的创意决定。