Dostarczyć spójny kontrakt źródła: wejście, normalizacja, błędy, output — plus punkt integracji w src/vesttracker/sources/ i zsynchronizowane docs/sources.md.
Constraints
warstwa pobierania nie miesza logiki domenowej z integracją źródła
znane pułapki, ograniczenia jakości danych i zależności od API zapisuj jawnie w docs/sources.md — nie ukrywaj ich w kodzie
nowe źródło = dokumentacja kontraktu w docs/sources.md + minimalny test, nie tylko kod
idempotentność: ponowny import tego samego pliku nie duplikuje transakcji (source_ref jako unikalny klucz)
Non-goals
nie wprowadza frameworka plugin-system dla "dowolnego źródła"
nie buduje retry/backoff na zapas jeśli źródło realnie tego nie wymaga
nie zmienia schematu DB razem z integracją — to osobny change set
Gotchas
format CSV XTB nie jest jeszcze znany — czeka na przykładowy plik; nie wymyślaj nazw kolumn przed jego analizą
cena złota wymaga dwóch API (Yahoo Finance GC=F + NBP USD/PLN) — oba mogą nie zwrócić danych dla weekendu lub święta; obsłuż fallback gracefully
obligacje skarbowe nie mają tickera na Catalyst — wycena wyłącznie analityczna, nigdy nie szukaj ceny rynkowej
price_cache ma unikalność (symbol, date, source) — przy zapisie używaj INSERT OR REPLACE
1---2name: source-integration3description: Source integration4---56# Source integration78## Cel910Dostarczyć spójny kontrakt źródła: wejście, normalizacja, błędy, output — plus punkt integracji w `src/vesttracker/sources/` i zsynchronizowane `docs/sources.md`.1112## Constraints1314- warstwa pobierania nie miesza logiki domenowej z integracją źródła15- znane pułapki, ograniczenia jakości danych i zależności od API zapisuj jawnie w `docs/sources.md` — nie ukrywaj ich w kodzie16- `Faza 1` ogranicza scope do: `xtb`, `gold`, `bond`, `manual`17- nowe źródło = dokumentacja kontraktu w `docs/sources.md` + minimalny test, nie tylko kod18- idempotentność: ponowny import tego samego pliku nie duplikuje transakcji (`source_ref` jako unikalny klucz)1920## Non-goals2122- nie wprowadza frameworka plugin-system dla "dowolnego źródła"23- nie buduje retry/backoff na zapas jeśli źródło realnie tego nie wymaga24- nie zmienia schematu DB razem z integracją — to osobny change set2526## Gotchas2728- format CSV XTB nie jest jeszcze znany — czeka na przykładowy plik; nie wymyślaj nazw kolumn przed jego analizą29- cena złota wymaga dwóch API (Yahoo Finance `GC=F` + NBP `USD/PLN`) — oba mogą nie zwrócić danych dla weekendu lub święta; obsłuż fallback gracefully30- obligacje skarbowe nie mają tickera na Catalyst — wycena wyłącznie analityczna, nigdy nie szukaj ceny rynkowej31- `price_cache` ma unikalność `(symbol, date, source)` — przy zapisie używaj `INSERT OR REPLACE`
Run npx skillmds@latest add aibot88/source-integration in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Source integration It is listed under Integrations & APIs on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
aibot88 (@aibot88) published this skill. Their other Agent Skills are listed on their SkillMD profile.
aibot88