douyin-drama-commerce-skill

一个面向 AI Agent 的中文抖音短剧与内容电商技能。它把商品证据、短剧/直播创意、上线核验、合规边界和测量方案组织成可复用工作流，而不是提供“爆款”提示词或声称掌握不变的平台算法。

能力范围

• 短剧商品植入、分镜和系列内容规划
• 基于公开账号、内容和商品证据的达人/直播匹配
• 选品、卖点证据矩阵和内容适配评估
• 脚本、口播、直播环节和制作交付
• 发布/开播准备、平台当前信息核验和风险升级
• 指标定义、实验设计和复盘，不虚构业务表现

本技能不代操作账号，不规避审核或登录控制，不生成虚假订单/评价/指标，不把医疗、广告、法律或平台要求写成永久事实。完整边界见 SKILL.md。

结构

.
|-- SKILL.md
|-- references/
|   |-- compliance-safety.md
|   |-- current-platform-verification.md
|   `-- workflows.md
|-- scripts/
|   |-- drama_commerce_gen.py
|   `-- validate_repo.py
|-- evals/evals.json
|-- examples/scaffold.md
`-- tests/

SKILL.md 负责触发、路由和输出合同；详细内容按需从 references/ 渐进加载。

CLI

要求 Python 3.10+，无第三方依赖，无网络访问。

python3 scripts/drama_commerce_gen.py script "示例保温杯" \
  --type "日用品" \
  --audience "有自带饮品需求的通勤者" \
  --evidence "商品公开规格页：容量 350 mL（访问 2026-07-29）" \
  --duration 30 \
  --drama 测评 \
  --format markdown

JSON 输出：

python3 scripts/drama_commerce_gen.py script "示例保温杯" \
  --type "日用品" --audience "通勤者" --duration 30 --format json

可选 --budget 100.01 只生成确定性的规划占位分配（分为整数单位），不代表投放建议或收益预测。产品、受众、证据等输入会验证并在 Markdown 表格中转义。

准确输出示例见 examples/scaffold.md。示例中的产品和证据均明确标为演示输入。

质量检查

python3 -m unittest discover -s tests -v
python3 scripts/validate_repo.py
python3 -m compileall -q scripts tests
python3 scripts/drama_commerce_gen.py --help
python3 scripts/drama_commerce_gen.py script "示例杯" --type "日用品" --audience "通勤者" --duration 30 --format json

CI 在 CPython 3.10、3.11、3.12 和 3.13 上运行测试、编译和仓库验证。验证器检查必要文件、frontmatter、元数据与 eval 一致性、本地链接、JSON、疑似秘密和 CLI smoke。

贡献与安全

提交前阅读 CONTRIBUTING.md。安全问题请按 SECURITY.md 私下报告，不要在公开 issue 中粘贴凭据、个人数据或未授权账号资料。

许可证

仓库作者创作的内容按 MIT License 提供。引用的第三方平台文档和商标仍归各自权利人所有；本仓库不复制或重新许可其内容。