Demo制作技能
概述
Demo制作技能是一个专业的演示场景构建与技能集成解决方案。当用户提供特定工作场景和任务步骤时，本技能能够：
- 场景分析：分析用户提供的场景，识别可自动化实现的环节
- Skill搜索匹配：在skillhub.cn搜索匹配度高、下载量高且通过安全测试的skill
- Skill安装：自动安装匹配的skill
- Skill测试：根据任务步骤进行skill测试并记录结果
- 演示文档生成：生成包含完整场景、故事背景、skill解决方案、demo展示的飞书文档
核心工作流程
1. 场景分析阶段
- 接收用户提供的场景描述和任务步骤
- 分析场景中的关键环节和可自动化点
- 识别各环节对应的skill需求类型
- 生成场景分析报告
2. Skill搜索匹配阶段
- 访问skillhub.cn搜索相关skill
- 根据匹配度、下载量、安全性进行筛选
- 评估各skill的功能覆盖范围
- 生成skill匹配报告
3. Skill安装阶段
- 使用
aily-skillhub工具安装匹配的skill - 验证skill安装状态
- 测试skill基本功能
- 记录安装结果
4. Skill测试阶段
- 按照用户提供的任务步骤测试各skill
- 记录测试过程、结果和产出物
- 生成测试报告和截图
- 评估skill的适用性和效果
5. 演示文档生成阶段
- 整合所有信息生成飞书文档
- 包含场景名称、故事背景、skill解决方案、demo展示
- 格式化展示场景、步骤、skill、测试结果、产出物
- 确保文档结构清晰、内容丰富、视觉效果专业
使用指南
何时使用本技能
- 用户需要构建发布会级别的演示demo时
- 需要将多个工作流程串联成完整演示场景时
- 需要搜索和测试特定场景下的最佳skill组合时
- 需要生成包含完整测试过程和结果的演示文档时
用户输入格式
用户应提供：
- 场景描述：如"产品经理办公"
- 任务步骤：如"需求分析、PRD撰写、原型图设计"
- 具体要求：如"需要搜索skill、安装测试、生成演示文档"
输出结果
本技能将生成：
- 场景分析报告：分析场景中的关键环节
- Skill匹配报告：推荐的skill列表和匹配度分析
- Skill测试报告：各skill的测试结果和产出物
- 演示文档：完整的飞书文档，包含所有环节
脚本使用说明
demo_maker.py
主脚本，协调整个demo制作流程。包含以下功能：
- 场景分析器
- skill搜索器
- skill安装器
- 测试执行器
- 文档生成器
scenario_builder.py
场景构建工具，用于：
- 解析用户提供的场景描述
- 识别关键工作环节
- 生成场景分析报告
skill_analyzer.py
skill分析工具，用于：
- 搜索skillhub.cn
- 评估skill匹配度
- 分析skill功能覆盖
- 生成skill推荐报告
demo_document_generator.py
演示文档生成工具，用于：
- 创建飞书文档结构
- 整合所有测试结果
- 格式化展示内容
- 添加图片和附件链接
clawhub_integration.py
skillhub集成工具，用于：
- 与skillhub.cn API交互
- 安装和管理skill
- 验证skill状态
参考资源
scenario_patterns.md
常见场景模式库，包含：
- 产品经理办公场景
- 市场营销分析场景
- 数据科学工作流
- 软件开发流程
- 项目管理场景
skill_templates.md
演示文档模板库，包含：
- 飞书文档模板结构
- 演示场景描述模板
- skill测试报告模板
- 产出物展示模板
feishu_doc_guide.md
飞书文档生成指南，包含：
- 飞书API使用说明
- 文档结构设计规范
- 图片和附件嵌入方法
- 表格和格式化技巧
clawhub_api.md
skillhub API参考，包含：
- API端点说明
- 搜索参数说明
- skill安装命令
- 错误处理指南
示例工作流程
示例：产品经理办公场景
- 用户输入：场景"产品经理办公"，任务步骤"需求分析、PRD撰写、原型图设计"
- 场景分析：识别需求收集、文档编写、设计展示三个关键环节
- Skill搜索：搜索"需求分析"、"PRD模板"、"原型设计"相关skill
- Skill安装：安装匹配度高的skill，如"aily-doc-project-kickoff-report"、"aily-doc-technical-solution"
- Skill测试：测试各skill功能，生成测试报告
- 文档生成：创建包含完整演示流程的飞书文档
质量保证
验证标准
- 场景分析准确性：确保识别所有关键环节
- Skill匹配度：确保推荐的skill与场景高度相关
- 测试完整性：确保所有任务步骤都得到测试
- 文档质量：确保文档结构清晰、内容完整、视觉效果专业
错误处理
- 如果skill搜索失败，提供备选方案
- 如果skill安装失败，记录错误并提供修复建议
- 如果测试失败，分析原因并提供替代方案
- 如果文档生成失败，提供手动创建指南
最佳实践
- 提前规划：在开始前明确用户需求和预期结果
- 分步执行：按阶段执行，确保每个阶段都完成后再进入下一阶段
- 详细记录：记录所有操作过程和结果，便于回溯和问题排查
- 质量检查：在每个阶段结束后进行质量检查
- 用户反馈：在关键节点征求用户反馈，确保方向正确
常见问题
Q: 如果找不到完全匹配的skill怎么办？
A: 可以尝试组合多个skill来覆盖所有功能，或者使用相近的skill进行功能扩展。
Q: 如何评估skill的下载量？
A: 通过skillhub.cn的统计信息查看下载量、评分和用户评价。
Q: 测试失败如何处理？
A: 分析失败原因，提供替代方案，记录详细错误信息。
Q: 生成的文档如何定制？
A: 可以根据用户需求调整文档结构、内容和格式，参考skill_templates.md中的模板。
更新日志
版本1.0 (2026-04-12)
- 初始版本发布
- 支持场景分析、skill搜索、安装测试、文档生成全流程
- 包含完整的脚本和参考资源库
注意：本技能需要访问skillhub.cn进行skill搜索和安装，请确保网络连接正常。部分操作可能需要用户授权或确认。