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

.kiro/skills/change-annotation-audit/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: change-annotation-audit
+description: 对每次修改强制生成审计记录（docs/ai_audit/changes/...），并在每个被改文件写 AI_CHANGELOG、在逻辑变更处写 CHANGE 标记注释（包含日期、Prompt 与直接原因）。
+---
+
+# 目的
+把“为什么改、怎么改、怎么验”固化到可审计产物中，满足资金相关项目的严谨性要求。
+
+# 触发条件
+- 任何对代码或文档的实质修改（非纯格式化）
+- 特别是：逻辑改动、资金口径改动、接口契约改动、DB 结构改动
+
+# 必须产物（缺一不可）
+1) `docs/ai_audit/changes/<YYYY-MM-DD>__<slug>.md`
+2) 每个被修改文件内的 `AI_CHANGELOG` 条目
+3) 每个逻辑变更附近的 `CHANGE` 标记注释
+
+# 工作流
+## 1) Prompt 溯源
+- 确认本次修改有 Prompt-ID（来自 prompt_log.md）
+- 若没有，先补写 Prompt-ID，再继续
+
+## 2) 写审计记录（Per-change）
+使用模板：`assets/audit-record-template.md`
+- 必须写：原始原因（Prompt）、直接原因、改动方案简介、文件清单、风险/回滚/验证
+
+## 3) 写文件内 AI_CHANGELOG（Per-file）
+- 对每个修改的文件追加一条 AI_CHANGELOG
+- 选择适合语言/文件类型的注释风格（模板见 assets/file-changelog-templates.md）
+
+## 4) 写 CHANGE 标记（Block-level）
+- 对每处逻辑变更，必须在附近写 CHANGE 标记
+- 必须包含：intent、assumptions、边界条件（金额/舍入/精度）、验证提示
+
+# 模板
+- `assets/audit-record-template.md`
+- `assets/file-changelog-templates.md`

.kiro/skills/change-annotation-audit/assets/audit-record-template.md

@@ -0,0 +1,19 @@
+# 变更审计记录（Change Audit Record）
+
+- 日期/时间（Asia/Taipei）：
+- Prompt-ID：
+- 原始原因（Prompt 原文或 ≤5 行摘录）：
+- 直接原因（必要性 + 修改方案简介）：
+
+## 变更范围（Changed）
+- 模块/接口/表/关键文件：
+
+## 风险与回滚（Risk & Rollback）
+- 风险点：
+- 回滚要点：
+
+## 验证（Verification）
+- 至少 1 条可执行验证方式（测试/SQL/联调）：
+
+## 文件清单（Files changed）
+- ...

.kiro/skills/change-annotation-audit/assets/file-changelog-templates.md

@@ -0,0 +1,48 @@
+# 文件内 AI_CHANGELOG 与 CHANGE 标记模板
+
+## 通用 AI_CHANGELOG（建议放在文件头部或“变更记录”小节）
+- 2026-02-13 | Prompt: P20260213-101530（摘录：...）| Direct cause：... | Summary：... | Verify：...
+
+---
+
+## Markdown / 文档（放在文档末尾或“变更记录”小节）
+### AI_CHANGELOG
+- YYYY-MM-DD | Prompt: P...（摘录：...）| Direct cause：... | Summary：... | Verify：...
+
+---
+
+## JS/TS（块注释）
+/*
+AI_CHANGELOG
+- YYYY-MM-DD | Prompt: P...（摘录：...）| Direct cause：... | Summary：... | Verify：...
+*/
+
+// [CHANGE P...] intent: ...
+// assumptions: ...
+// edge cases / money semantics: ...
+// verify: ...
+
+---
+
+## Python（docstring/块注释）
+"""
+AI_CHANGELOG
+- YYYY-MM-DD | Prompt: P...（摘录：...）| Direct cause：... | Summary：... | Verify：...
+"""
+
+# [CHANGE P...] intent: ...
+# assumptions: ...
+# edge cases / money semantics: ...
+# verify: ...
+
+---
+
+## SQL（块注释 + 行注释）
+/*
+AI_CHANGELOG
+- YYYY-MM-DD | Prompt: P...（摘录：...）| Direct cause：... | Summary：... | Verify：...
+*/
+-- [CHANGE P...] intent: ...
+-- assumptions: ...
+-- money semantics: precision/rounding/currency ...
+-- verify: ...