tushare-plugin-builder

用途：当用户提供 Tushare 文档 URL 或页面内容并要求生成插件时，把文档规格转换为本仓库的生产级插件；也可用于验证已有插件是否符合规范。主要能力：从文档提取接口名称、参数、输出字段及频率限制、分页等说明；按约定目录与文件结构（plugin.py、extractor.py、service.py、schema.json、config.json 等）生成插件；extractor 使用 tushare SDK 并以 proxy_context() 包裹调用，配合频率限制、超时与 tenacity 重试；plugin 实现 extract_data、validate_data、transform_data、load_data，插入 version 与 _ingested_at 列，trade_date 转为 Date；通过 get_category()/get_role() 指定分类与角色，通过 get_dependencies()/get_optional_dependencies() 声明依赖；service 至少提供日期范围与最新数据查询，使用参数化 SQL；schema.json 使用 ReplacingMergeTree 并按 toYYYYMM(trade_date) 分区。使用方式：先确认文档 URL 与 snake_case 插件名，再依次生成结构、建表、拉数、验证。关键命令包括 python .codebuddy/skills/tushare-plugin-builder/scripts/generate_create_table_sql.py 与 validate_plugin.py、verify_clickhouse_connection.py、run_plugin_test.py、verify_service_http.py、verify_mcp_tool.py 等，分别用于建表、综合验证、连接检查、ETL 入库与 HTTP/MCP 端点测试。适用场景：需要基于某 Tushare 接口快速生成含入库、查询服务与 Agent/MCP 调用的插件。限制：需可访问文档或提供内容；依赖配置不在 config.json 定义；具体版本、收费、价格与效果暂未提供。