初始提交：飞球 ETL 系统全量代码

.kiro/skills/steering-readme-maintainer/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: steering-readme-maintainer
+description: 当发生业务/ETL/API/鉴权/小程序交互等逻辑改动时，用于执行变更影响审查并同步更新 product/tech/structure/README 与审计记录。
+---
+
+# 目的
+将“逻辑改动→文档同步→审计留痕”流程标准化，减少漏更与口径漂移风险（资金相关场景优先保证可追溯与可复算）。
+
+# 触发条件（何时调用本 Skill）
+- 修改了业务规则/计算口径/资金处理（精度、舍入、阈值等）
+- 修改了 ETL/SQL 清洗聚合映射逻辑
+- 修改了 API 行为（返回结构、错误码、鉴权/权限）
+- 修改了小程序关键交互流程（校验、状态机、关键字段）
+
+# 工作流（必须按顺序执行）
+## 1) 分类：是否属于“逻辑改动”
+- 若不是逻辑改动：写明“无逻辑改动”，并说明为何（例如仅格式化/拼写修正/注释调整）。
+- 若是逻辑改动：进入下一步。
+
+## 2) Steering 与 README 同步（逐项评估）
+- `.kiro/steering/product.md`：业务定义/口径/资金规则是否变化？
+- `.kiro/steering/tech.md`：技术栈/运行方式/依赖/部署假设是否变化？
+- `.kiro/steering/structure.md`：目录/模块边界/职责是否变化？
+- `README.md`：运行方式、配置、环境变量、接口契约、联调步骤是否变化？
+
+> 规则：如果“对读者理解系统行为”有帮助，就应更新；不要为了追求“少改文档”而拒绝同步。
+
+## 3) 输出审计友好摘要（对话回复/审计记录都需要）
+- Changed：改了哪些模块/接口/表/关键文件
+- Why：原始原因（Prompt-ID + 摘录）与直接原因（必要性 + 方案简介）
+- Risk：风险点与回归范围
+- Verify：建议的验证步骤（测试/SQL/联调）
+
+## 4) 联动硬规则检查
+- 如果涉及 DB schema/表结构变化：必须同步更新 `docs/bd_manual/`（见 skill `bd-manual-db-docs`）。
+
+# 资产（可复制模板/清单）
+见：`assets/steering-update-checklist.md`

.kiro/skills/steering-readme-maintainer/assets/steering-update-checklist.md

@@ -0,0 +1,23 @@
+# Steering & README 同步清单（逻辑改动必查）
+
+## product.md（产品/口径）
+- 业务定义/指标口径/字段含义是否改变？
+- 涉及金额的精度/舍入/阈值规则是否改变？
+- 角色/权限模型是否改变？
+
+## tech.md（技术/运行）
+- 新增/变更依赖（框架、库、驱动）？
+- 配置项/环境变量/端口/服务启动方式是否改变？
+- 数据访问边界（ETL 库 vs 业务库）是否改变？
+- 性能/一致性/幂等/重试策略是否改变？
+
+## structure.md（结构/职责）
+- 新增目录/模块？
+- 模块职责或边界是否重新划分？
+- 新增集成点（队列、定时任务、外部系统）？
+
+## README.md（使用/联调）
+- 本地启动步骤是否改变？
+- 新增/变更配置项（.env 等）？
+- API 契约是否变化（路径、参数、返回、错误码）？
+- 小程序联调步骤是否变化？