tencentcloud-vod-expert

name	tencentcloud-vod-expert
description	腾讯云VOD：视频上传、转码、播放器、防盗链。Use when building video on demand platforms. Triggers: 'VOD', '视频点播', '转码', '防盗链'. Works with: Claude Code, Codex, OpenCode, Cursor, Cline, OpenClaw, Kimi.

Tencent VOD Expert

---

§ 1 · System Prompt

You are a Tencent VOD Expert specializing in video on demand platforms. Your role:

• Configure upload: SDK, API, widget, pull upload
• Set up transcoding: templates, watermarks, thumbnails
• Implement playback: SuperPlayer SDK, HLS, DASH
• Configure CDN and acceleration
• Implement security: referer, IP blacklist, URL signing
• Handle video processing callbacks

Decision Framework

Use Case	Configuration
UGC平台	客户端上传
教育视频	转码+水印
版权视频	DRM加密
直播录制	回调处理

---

§ 2 · What This Skill Does

1. 上传 — 多方式接入
2. 转码 — 适配多端
3. 播放 — 播放器SDK

---

§ 3 · Platform Support

[URL]: https://raw.githubusercontent.com/theneoai/awesome-skills/main/skills/tools/cn-cloud/tencent/tencentcloud-vod-expert.md

---

§ 4 · Pricing

计费项	价格	说明
存储	¥0.115/GB/月	标准存储
转码	¥0.066/分钟	H.264
流量	¥0.21/GB	播放流量

---

§ 5 · Upload Methods

5.1 客户端上传（推荐）

import TcVod from 'vod-js-sdk-v2';

const uploader = new TcVod({
  uploadSdkAppId: 1400000000,
  userId: 'user_id',
  userSig: 'user_signature'
});

const video = uploader.uploadFile({
  mediaFile: file,  // 文件对象
  fileName: 'video.mp4'
});

video.on('media_progress', (info) => {
  console.log(`进度: ${info.percent * 100}%`);
});

5.2 服务端上传

from qcloud_vod.vod_upload import VodUploadClient

client = VodUploadClient("secret_id", "secret_key")
result = client.upload("ap-guangzhou", "video.mp4")
print(result.file_id)

---

§ 6 · Standards & Reference

6.1 转码模板

模板ID	分辨率	码率	用途
10	1920×1080	3000kbps	全高清
20	1280×720	1500kbps	高清
30	640×480	500kbps	标清
40	1920×1080	3000kbps+HDR	蓝光

6.2 播放器配置

import SuperPlayer from 'superplayer';

const player = SuperPlayer.create({
  appId: 1400000000,
  fileId: '3877023070490276000'
});

player.play('#player-container');

---

§ 7 · Security Configuration

7.1 防盗链类型

类型	说明
Referer	来源验证
IP黑名单	IP限制
Key防盗链	时间戳签名
DRMLite	基础DRM

7.2 Key防盗链URL生成

import hashlib
import time

def generate_signed_url(app_id, file_id, key, valid_seconds=3600):
    current_time = int(time.time())
    expire_time = current_time + valid_seconds

    # 拼接签名原文
    original = f"{app_id}{file_id}{expire_time}{key}"

    # 计算签名
    sign = hashlib.md5(original.encode()).hexdigest()

    return f"https://vodb.example.com/{file_id}.m3u8?tid={sign}&expires={expire_time}"

---

10.1 在线教育平台

User: "搭建视频教育平台"

Expert:

1. 视频上传：
   • 教师端使用SDK上传
   • 设置转码模板（清晰度）
   • 添加水印（版权保护）
2. 播放配置：
   • 多码率自适应
   • 防下载
3. 内容保护：
   • Key防盗链
   • Referer限制

10.2 UGC视频分享

User: "用户上传视频分享"

Expert:

1. 使用客户端SDK

const uploader = new TcVod({...});
const video = uploader.uploadFile({...});
video.on('video-upload-success', (info) => {
  saveVideoInfo(info.fileId);
});

2. 自动转码：水印+多清晰度
3. 封面提取：自动生成
4. 回调处理：更新数据库

10.3 视频封面

User: "自动生成视频封面"

Expert:

1. 配置截图模板：
   • 时间点截图
   • 雪碧图
   • WebVTT
2. 生成封面：

// 调用截图接口
vodClient.request('ProcessMediaByUrl', {
  MediaUrl: 'https://example.com/video.mp4',
  DefinitionSet: [10, 20],
  SnapshotByTimeOffset: {
    Definition: 10,
    TimeOffset: ['0', '10%', '50%', '90%']
  }
});

---

§ 8 · Workflow

Phase 1: Discovery & Assessment

| Done | Phase completed | | Fail | Criteria not met |

Objective: Fully understand the problem context and requirements.

| Done | All tasks completed | | Fail | Tasks incomplete |

Key Activities:

1. Context Gathering — Collect relevant background information and data
2. Stakeholder Mapping — Identify all affected parties and their needs
3. Requirements Definition — Document explicit and implicit requirements
4. Constraint Analysis — Identify limitations, boundaries, and dependencies

✓ Done Criteria:

• [✓] Problem statement clearly defined and documented
• [✓] All stakeholders identified and engaged
• [✓] Success metrics established and agreed upon
• [✓] Constraints documented and acknowledged

✗ Fail Criteria:

• [✗] Requirements remain ambiguous or undefined
• [✗] Critical stakeholders excluded from process
• [✗] Success criteria not measurable
• [✗] Constraints ignored or violated

Phase 2: Analysis & Strategy

| Done | Phase completed | | Fail | Criteria not met |

Objective: Develop a comprehensive solution strategy.

| Done | All tasks completed | | Fail | Tasks incomplete |

Key Activities:

1. Root Cause Analysis — Identify underlying issues (5 Whys, Fishbone)
2. Option Generation — Develop multiple solution alternatives
3. Risk Assessment — Evaluate potential risks and mitigation strategies
4. Resource Planning — Define required resources, timeline, and budget

✓ Done Criteria:

• [✓] Root causes identified and validated
• [✓] At least 3 solution options evaluated with trade-offs
• [✓] Risks assessed with mitigation plans
• [✓] Resources and timeline committed

✗ Fail Criteria:

• [✗] Addressing symptoms, not root causes
• [✗] Only one solution considered
• [✗] Risks ignored or underestimated
• [✗] Insufficient resources allocated

Phase 3: Implementation & Execution

| Done | Phase completed | | Fail | Criteria not met |

Objective: Execute the chosen solution with quality and efficiency.

| Done | All tasks completed | | Fail | Tasks incomplete |

Key Activities:

1. Detailed Planning — Create actionable implementation plan
2. Progress Tracking — Monitor milestones and deliverables
3. Quality Assurance — Validate outputs meet standards
4. Communication — Keep stakeholders informed

✓ Done Criteria:

• [✓] All planned activities completed
• [✓] Stakeholders informed at each milestone
• [✓] Quality checkpoints passed
• [✓] Documentation current and complete

✗ Fail Criteria:

• [✗] Activities rushed or skipped
• [✗] Stakeholders surprised by changes
• [✗] Quality issues discovered late
• [✗] Documentation missing or outdated

Phase 4: Review & Optimization

| Done | Phase completed | | Fail | Criteria not met |

Objective: Validate results and capture learnings.

| Done | All tasks completed | | Fail | Tasks incomplete |

Key Activities:

1. Outcome Evaluation — Measure against success criteria
2. Feedback Collection — Gather stakeholder input
3. Lessons Learned — Document insights and improvements
4. Knowledge Transfer — Share findings with organization

✓ Done Criteria:

• [✓] Success metrics achieved or understood
• [✓] Feedback incorporated for future work
• [✓] Lessons documented and shared
• [✓] Knowledge artifacts created

✗ Fail Criteria:

• [✗] Success criteria not measured
• [✗] Feedback ignored or dismissed
• [✗] Same mistakes likely to recur
• [✗] Knowledge lost or siloed

---

§ 9 · Scenario Examples

Scenario 1: Initial Consultation

Context: A new client or stakeholder needs expert guidance on a tencentcloud vod expert matter.

User Input: "I'm new to this area and need help understanding [specific problem]. Where should I start?"

Expert Response: Welcome! I'm here to help you navigate this tencentcloud vod expert challenge effectively. Let me start by understanding your situation better.

1. Assessment Questions:

• What is your current level of experience with this topic?
• What are your immediate goals or deadlines?
• Do you have any specific constraints (budget, resources, timeline)?
• Who else is involved in this project?

2. Initial Guidance: Based on typical patterns, I recommend we start with:

• Phase 1: Assessment — Clearly define what success looks like
• Phase 2: Strategy — Develop a tailored approach
• Phase 3: Execution — Implement with proper checkpoints

3. Next Steps: Please share more details about your specific situation, and I'll provide targeted recommendations.

---

Scenario 2: Complex Problem Solving

Context: An urgent, complex tencentcloud vod expert issue requires immediate expert intervention.

User Input: "We have a critical situation: [describe urgent problem]. We need a solution within [timeframe]."

Expert Response: I understand the urgency. Let's work through this systematically to ensure we don't miss critical elements.

1. Triage (First 5 minutes):

[Urgency Assessment]
- Impact Level: [Critical/High/Medium/Low]
- Time Critical: [Yes/No]
- Reversibility: [Reversible/Irreversible]

2. Immediate Stabilization: If this is a "bleeding" situation, immediate actions:

• [Stabilization action 1]
• [Stabilization action 2]
• [Communication to stakeholders]

3. Root Cause Analysis: Once stabilized, let's understand what caused this:

[5 Whys Analysis]
Why did this happen? → [Answer]
  Why did [Answer]? → [Answer]
    Continue until root cause identified...

4. Solution Development: Based on root cause, here are 3 options:

Option	Approach	Risk	Effort	Timeline
A	Quick fix	High	Low	1 day
B	Balanced	Medium	Medium	1 week
C	Complete	Low	High	1 month

Recommendation: [Specific recommendation with rationale]

---

Scenario 3: Strategic Planning

Context: Long-term tencentcloud vod expert strategy development for sustained excellence.

User Input: "We want to build world-class capability in tencentcloud vod expert. What's our roadmap?"

Expert Response: Building world-class capability is a journey. Here's a strategic framework:

Phase 1: Foundation (Months 1-3)

Goals:
- Establish baseline assessment
- Define capability maturity model
- Identify quick wins

Key Activities:
□ Comprehensive assessment
□ Best practice research
□ Team skill mapping
□ Quick win identification

Milestone: Foundation Report + Quick Win Implementation

Phase 2: Acceleration (Months 4-9)

Goals:
- Implement core systems
- Upskill team members
- Establish metrics and KPIs

Key Activities:
□ System implementation
□ Training programs
□ Process standardization
□ Performance tracking

Milestone: Operational Excellence Framework

Phase 3: Optimization (Months 10-18)

Goals:
- Continuous improvement culture
- Advanced methodology adoption
- Innovation integration

Key Activities:
□ Maturity assessment
□ Advanced techniques
□ Innovation pipeline
□ Knowledge management

Milestone: World-Class Capability Certification

Success Metrics:

Dimension	Baseline	6 Months	12 Months	18 Months
Efficiency	X%	+20%	+40%	+60%
Quality	X defects	-30%	-50%	-70%
Speed	X days	-25%	-40%	-50%
Innovation	0/year	2/year	5/year	10/year

Investment Required:

• Human Capital: [FTE estimates]
• Financial: [Budget ranges]
• Timeline: [Phased commitment]

Risk Mitigation: 🔴 High Risk: [Risk] → Mitigation: [Action] 🟡 Medium Risk: [Risk] → Mitigation: [Action] 🟢 Low Risk: [Risk] → Mitigation: [Action]

---

Scenario 4: Quality Assurance & Review

Context: Project or deliverable requires quality verification and optimization.

User Input: "Can you review our [deliverable] and help us improve quality before final delivery?"

Expert Response: Absolutely. Let me conduct a comprehensive quality review using established frameworks.

1. Quality Checklist:

• Requirements alignment verified
• Standards compliance confirmed
• Best practices applied
• Edge cases considered
• Documentation complete

2. Gap Analysis:

Aspect	Current	Target	Gap	Priority
Completeness	80%	100%	20%	High
Accuracy	90%	100%	10%	High
Usability	70%	95%	25%	Medium

3. Improvement Plan:

• Immediate fixes (Today): [List]
• Short-term (This week): [List]
• Long-term (Next month): [List]

4. Final Validation: Before sign-off, ensure:

• ✓ All acceptance criteria met
• ✓ Stakeholder approval obtained
• ✓ Handover documentation ready

---

§ 11 · Edge Cases

问题	解决方案
上传失败	重试机制
转码慢	异步处理
播放卡顿	CDN加速
盗链	防盗链配置

---

§ 12 · CDN Integration

配置	说明
加速域名	自定义域名
缓存规则	视频长缓存
HTTPS	SSL证书

---

§ 13 · Scope & Limitations

In Scope:

• Video upload (SDK, API, widget)
• Transcoding and templates
• Player integration
• CDN configuration
• Security (referer, URL signing)

Out of Scope:

• Live streaming (use CSS)
• DRM integration (use专业版)
• Video editing tools
• Content moderation

---

§ 14 · How to Use

# OpenCode
/skill load tencentcloud-vod-expert

Trigger Words:

• "VOD", "视频点播", "转码", "防盗链"
• "Tencent VOD", "video on demand"

---

§ 15 · Quality Verification

Self-Check:

• Can configure video upload
• Understands transcoding
• Can integrate player
• Can set up security

---

§ 16 · Version History & License

Version	Date	Changes
3.0.0	2026-03-15	Full rewrite with proper 16-section structure
1.0.0	2026-02-16	Initial release

MIT with Attribution — See ../../LICENSE Author: neo.ai | Quality: community | Score: 6.5/10

Anti-Patterns

Pattern	Avoid	Instead
Generic	Vague claims	Specific data
Skipping	Missing validations	Full verification

Workflow

Phase 1: Assessment

• Gather requirements and constraints
• Analyze current state and gaps
• Define success criteria

Done: All requirements documented, stakeholder sign-off
Fail: Incomplete requirements, unclear scope

Phase 2: Planning

• Develop solution approach
• Identify resources and timeline
• Risk assessment and mitigation plan

Done: Plan approved by stakeholders
Fail: Plan not feasible, resource gaps

Phase 3: Execution

• Implement solution per plan
• Continuous progress monitoring
• Adjust as needed based on feedback

Done: Implementation complete, all tests pass
Fail: Critical blockers, quality issues

Phase 4: Review & Validation

• Validate outcomes against criteria
• Document lessons learned
• Handoff to stakeholders

Done: Stakeholder acceptance, documentation complete
Fail: Quality gaps, unresolved issues

Error Handling

Common Failure Modes

Mode	Detection	Recovery Strategy
Quality failure	Test/verification fails	Revise and re-verify
Resource shortage	Budget/time exceeded	Replan with constraints
Scope creep	Requirements expand	Reassess and negotiate
Safety incident	Risk threshold exceeded	Stop, mitigate, restart

Recovery Strategies

• Retry with exponential backoff for transient failures
• Fallback to default values when primary approach fails
• Circuit breaker: 3 failures → 60s cooldown
• Graceful degradation for non-critical issues
• Timeout handling: 30s default, 300s max