Eessõna (käivitub oskuse alguses)

# Version check (silent if up to date)
python3 telemetry/version_check.py 2>/dev/null || true

# Telemetry opt-in (first run only, then remembers your choice)
python3 telemetry/telemetry_init.py 2>/dev/null || true

Privaatsus: See oskus logib kasutust kohalikult kataloogi ~/.ai-marketing-skills/analytics/. Kaugtelemeetria on ainult valikuline (opt-in). Koodi, failiteid ega repo sisu ei koguta kunagi. Vt telemetry/README.md.

AI Finance Ops

Kaks tööriista: CFO Briefing Generator ja Codebase Cost Estimator.

Tööriist 1: CFO Briefing Generator

Genereeri juhttaseme finantskokkuvõtted QuickBooksi eksportidest.

Töövoog

1. Failide sissevõtt

Aseta QuickBooksi ekspordifailid (CSV, XLSX, XLS) töökataloogi. Aktsepteeritud aruandetüübid (piisab suvalisest alamhulgast — ainuüksi kasumiaruanne on piisav):

• P&L Summary — tulu, COGS, kulud, puhaskasum (KÕIGE OLULISEM)
• P&L by Customer — tulu jaotus kliendi kaupa
• P&L Detail — tehingutaseme detail (XLSX)
• Balance Sheet — varad, kohustused, omakapital
• General Ledger — kõik kontotehingud
• Expenses by Vendor — kulude jaotus tarnija kaupa
• Transaction List by Vendor — detailne tarnija tehingute loend
• Bill Payments — AP maksete ajalugu
• Cash Flow Statement — tegevus-/investeerimis-/finantseerimisvood (XLSX)
• Account List — kontoplaan

2. Käivita analüüs

python3 scripts/cfo-analyzer.py --input ./data/uploads/ [--period YYYY-MM]

Valikud: - --input DIR — kataloog QB eksportidega - --period YYYY-MM — kirjutab üle perioodi sildi (vaikimisi: failidest automaatselt tuvastatud) - --history DIR — ajaloo kataloog MoM võrdluseks (vaikimisi: ./data/history/) - --no-history — ära salvesta ajalukku

Skript: 1. Tuvastab failitüübid automaatselt päiseid skaneerides 2. Parsib iga faili struktureeritud andmeteks 3. Arvutab kõik KPI-d (definitsioonid ja tervislikud vahemikud vt references/metrics-guide.md) 4. Laadib eelmise perioodi ajaloost MoM võrdluseks 5. Salvestab praeguse perioodi ajalukku 6. Väljastab vormindatud juhttaseme kokkuvõtte stdouti

3. Stsenaariumimudelid (valikuline)

Pärast CFO analüüsi modelleeri base/bull/bear stsenaariumid:

python3 scripts/scenario-modeler.py --input ./data/financial-latest.json

See genereerib 12-kuulised prognoosid: - Base case — praegune trajektoor jätkub - Bull case — kasvusihtmärgid saavutatud (uue toote tulu + uued kliendid) - Bear case — kaotad tippkliendid

4. Esita kokkuvõte

Skript väljastab vormindatud briefingu emoji olekunäitajatega (🟢🟡🔴), sobiv Slacki, e-posti või mis tahes sõnumikanali jaoks.

Failiformaadi detailid

Vt references/quickbooks-formats.md oodatavate CSV/XLSX veeruvormingute ja tuvastusheuristikate kohta.

Meetrikate läved

Vt references/metrics-guide.md tervislike vahemike, punase/kollase/rohelise lävede ja võrdluskonteksti kohta. Kohanda lävesid oma äri suuruse ja tüübi järgi.

Tööriist 2: Codebase Cost Estimator

Hinda koodibaasi täielikku arendusmaksumust.

Töövoog

Samm 1: Analüüsi koodibaas

Loe kogu koodibaas. Kataloogi koodiridade koguarv keele/tüübi järgi, arhitektuuriline keerukus, edasijõudnud funktsioonid, testide katvus ja dokumentatsiooni kvaliteet.

Samm 2: Arvuta arendustunnid

Rakenda tootlikkuse määrad failist references/rates.md. Arvuta baastunnid kooditüübi kohta, seejärel rakenda üldkulu kordajad arhitektuurile, silumisele, ülevaatusele, dokumentatsioonile, integratsioonile ja õppimiskõverale.

Samm 3: Uuri turuhindu

Kasuta veebiotsingut, et leida praegused tunnitasud asjakohastele spetsialiseerumistele. Ehita hinnatabel low / median / high projektitehnoloogiavirnale.

Samm 4: Arvuta organisatsiooniline üldkulu

Teisenda toored arendustunnid kalendriajaks, kasutades tõhusustegureid failist references/org-overhead.md. Näita hinnanguid ettevõttetüüpide lõikes (Solo kuni Enterprise).

Samm 5: Arvuta täismeeskonna kulu

Rakenda toetavate rollide suhted ja meeskonna kordajad failist references/team-cost.md. Näita rollide kaupa jaotus ning kokkuvõte kõigi ettevõtte etappide lõikes.

Samm 6: Genereeri kuluhinnang

Väljasta täielik hinnang malliga failist references/output-template.md. Kaasa kõik sektsioonid: koodibaasi meetrikad, arendustunnid, kalendriaeg, turuhinnad, insenerikulu, täismeeskonna kulu, üldkokkuvõte ja eeldused.

Samm 7: AI ROI analüüs (valikuline)

Kui koodibaas ehitati AI abiga, arvuta väärtus AI-tunni kohta failiga references/claude-roi.md. Määra aktiivsed tunnid git-ajaloo klasterdamisega, arvuta kiiruskordaja võrreldes inimarendajaga ning arvuta kulude kokkuhoid ja ROI.

Põhiprintsiibid

• Esita professionaalselt, sobivalt huvirühmadele
• Kaasa kindlustase (madal/keskmine/kõrge) ja peamised eeldused
• Too esile kõrgeima keerukusega alad, mis kulu juhivad
• Näita alati vahemikke (madal/keskmine/kõrge), mitte kunagi ühte arvu
• Otsi PRAEGUSE aasta turuhindu, ära kasuta vananenud andmeid