apify-generate-output-schema 是做什么的?
通过分析Apify Actor的源代码,为其生成输出模式(dataset_schema.json、output_schema.json、key_value_store_schema.json)。在创建或更新Actor输出模式时使用。
工作原理
该技能通过静态分析Actor的源代码,识别输出数据结构,并生成符合Apify Schema标准的JSON模式文件。它能够解析
- JavaScript / TypeScript:通过分析返回对象、函数参数和类型注释推断模式。
- Python:通过分析返回字典、数据类或pydantic模型推断模式。
使用方法
- 将技能添加到您的AI代理(如Claude Code、Cursor或Codex)。
- 提供Actor的源代码目录路径。
- 代理将生成
dataset_schema.json、output_schema.json和key_value_store_schema.json文件。 - (可选)检查生成的模式文件,并根据需要进行修改。
支持的平台
- Claude Code
- Cursor
- Codex
- 任何支持Custom Instructions的AI代理
要求
- Apify Actor源代码(支持JavaScript、TypeScript或Python)
- 可访问Apify CLI(
apify run) - Actor的依赖项已安装
示例
# 将技能添加到Claude Code
claude add-skill apify/apify-generate-output-schema
# 然后向Claude提问:
# “读取当前Actor的源代码并生成输出模式文件”
注意事项
- 模式是基于静态分析生成的,可能不涵盖所有动态情况。
- 建议在生产Actor中使用前手动验证模式。
- 如果Actor有复杂的条件逻辑或外部数据源,可能需要手动调整。