בנה מעקב תיק מניות עם Claude Code

מה אתה בונה

מנהל תיק מניות אישי — ללא גיליונות, ללא אפליקציות, ללא מנויים. אמור ל-Claude Code "קניתי 10 מניות של NVDA" והוא יעדכן את התיק שלך, יחשב את הרווח והפסד, יעקוב על המצב המס שלך, ויזכור הכל בין הפעלות. הכל מקבצי JSON במחשב שלך.

דרגה 1: צור את נתוני התיק שלך

צריך לנו מקום לשמור את ההחזקות שלך. קובץ JSON פשוט עובד בצורה מושלמת.

הנושא:

Create a folder ~/Dev/my-portfolio/ and inside it create a portfolio.json file. Add 5 sample stock holdings with these fields for each: ticker, name, quantity, buy_price, current_price, currency (USD). Use real stocks — AAPL, NVDA, TSLA, META, GOOGL. Make up realistic buy prices that are lower than current prices (I want to see green P&L). Also add a cash_balance field of 5000 and a last_updated timestamp.

Claude Code יוצר קובץ JSON מובנה עם ההחזקות שלך. זה כל מסד הנתונים שלך — אין שרת, אין SQL, רק קובץ במחשב שלך. לכל מניה יש הכל הדרוש כדי לחשב רווח והפסד: מה שילמת מול מה שזה שווה עכשיו.

נסה את זה: פתח את ~/Dev/my-portfolio/portfolio.json בכל עורך. אתה אמור לראות 5 מניות עם מחירי קנייה, מחירים נוכחיים וכמויות.

דרגה 2: בנה את הכישרון

אתה עומד לכתוב קובץ markdown שמלמד ל-Claude Code איך להיות מנהל התיק שלך.

הנושא:

Create a skill file at ~/.claude/skills/stock-portfolio.md. This skill triggers when I say /stock-portfolio or ask about my portfolio. When triggered, it should:
1. Read ~/Dev/my-portfolio/portfolio.json
2. Show a clean table with all holdings: ticker, quantity, current price, cost basis, P&L in $ and %, weight in portfolio
3. Show total portfolio value and total P&L
4. Show top winners and losers
Make sure the instructions tell Claude to always read the JSON file first before responding.

כישרון ב-Claude Code זה פשוט קבוצה של הנחיות כתובות בשפה רגילה. אתה לא כותב קוד — אתה כותב כללים כמו "כשהמשתמש שואל על התיק שלו, קרא את הקובץ הזה והראה טבלה." Claude עוקב אחרי הנחיות אלה כל פעם שהכישרון מופעל.

נסה את זה: התחל הפעלה חדשה של Claude Code (הכישרון מתגלה בעת הפעלה). הקלד /stock-portfolio. אתה אמור לראות טבלה מעוצבת עם כל 5 ההחזקות, הרווח/הפסד שלהם וסך הכל.

התיק שלך חי.

דרגה 3: עקוב אחרי העסקאות שלך

מנהל שלא יכול להקליט עסקאות אינו מנהל. בואו נוסיף פקודות קנייה/מכירה עם היסטוריית עסקאות קבועה.

הנושא:

I need two things:
1. Create a transactions.json file in ~/Dev/my-portfolio/ with an empty transactions array and a next_id counter starting at 1.
2. Update the skill file ~/.claude/skills/stock-portfolio.md to handle buy and sell commands:
   - When I say "bought 10 AAPL at $200", add a BUY transaction to transactions.json with date, ticker, quantity, price. Then update portfolio.json — add to existing position or create new one, recalculate average cost basis.
   - When I say "sold 5 NVDA at $250", add a SELL transaction with realized P&L calculated. Update portfolio.json — reduce quantity. If fully sold, move to a closed_positions array.
   - The transaction log is append-only — never delete entries.
   - After any buy/sell, show a confirmation with what changed.

החלטת העיצוב המרכזית כאן היא רישום להוסיף בלבד. כל עסקה מתולתלת לצמיתות — קניות, מכירות, תאריכים, מחירים, רווח/פסד מממומש. אתה לא מחק עסקה. זה נותן לך שובר דרכים שלם ומפחית את דוח המס.

נסה את זה: אמור "קניתי 10 מניות של AMZN ב-195 דולר." בדוק ש-portfolio.json עכשיו יש 6 תפקידים ו-transactions.json יש את הערך הראשון שלו. ואז אמור "מכרתי 2 GOOGL ב-180 דולר" — אמת שהכמות קטנה והיה רישום עסקת מכירה עם הרווח או ההפסד.

דרגה 4: דע את המצב המס שלך

זו הדרגה שמשלמת לעצמה. ממש.

הנושא:

Update the skill file to add two new commands:
1. "tax" command — reads transactions.json, calculates total realized gains and losses for the current year, shows net P&L, estimates 25% capital gains tax, and identifies tax-loss harvesting opportunities (positions currently at a loss that could be sold to offset gains).
2. "analyze" command — reads portfolio.json and shows: concentration risk (any position over 10%?), top 5 holdings by weight, and overall portfolio health assessment.
The tax command should clearly show: total gains, total losses, net taxable amount, estimated tax, and how much you'd save by harvesting specific losses.

קציר הפסד מס הוא הקונספט שהופך את זה לערכי: אם יש לך רווחים ממומשים של 1,000 דולר והפסדים שלא מומשו של 800 דולר, מכירת ההפסדים האלה מקזז את הרווחים שלך — משפילה את הסכום החייב במס ל-200 דולר. התפקידים ה"אשפה" שלך הופכים לשומרי מס.

נסה את זה: אם מכרת GOOGL בשלב הקודם, כבר יש לך עסקה ממומשת. הפעל את פקודת המס — אתה אמור לראות את הרווח המממומש שלך, את המס המוערך ב-25 אחוז, וכל עמדות היושבות בהפסד שאתה יכול למכור כדי להקזז אותה. אם עדיין לא מכרת כלום, מכור תפקיד ראשון כדי שלדוח המס יהיה נתונים לעבודה איתו.

דרגה 5: תמונות וקביעות

שלב אחרון: תן לתיק שלך זיכרון בין הזמן ובין הפעלות.

הנושא:

Two final additions:
1. Create a snapshots/ folder in ~/Dev/my-portfolio/. Update the skill to add a "snapshot" command that saves the current portfolio state as snapshots/YYYY-MM-DD.json (today's date). Add a "compare" command that loads two snapshots and shows what changed — value difference, new/removed positions, P&L change.
2. Add a section to ~/CLAUDE.md (or create it if it doesn't exist) documenting this portfolio project — the folder path, the skill name, what data files exist, and what commands are available. This way Claude Code remembers this project exists in every future session.

תמונות הן הזיכרון של התיק שלך. קחו אחת היום, קחו אחת בשבוע הבא, והשווו אותן כדי לראות בדיוק מה השתנה — אילו עמדות גדלו, אילו התכווצו, מה הוספת או הסרת. הערך ב-CLAUDE.md מבטיח ש-Claude יודע על התיק שלך בכל שיחה עתידית, אפילו חודשים מחדש.

נסה את זה: הפעל את פקודת התמונה ובדוק ~/Dev/my-portfolio/snapshots/ עבור הקובץ של היום. ואז הבדיקה האמיתית: פתח הפעלה חדשה של Claude Code ושאל "מה בתיק שלי?" — Claude צריך לדעת בדיוק איפה להסתכל.

מה בנית

מערכת מעקב תיקים שלמה, פועלת כולה מהטרמינל שלך:

• מנהל החזקות עם חישובי P&L בזמן אמת
• רישום עסקאות שמתעדת לצמיתות כל קנייה ומכירה
• מחשבון מס עם המלצות קציר הפסד
• ניתוח תיק עם התרעות סיכון ריכוז
• תמונות להשוואת התיק שלך לאורך זמן
• זיכרון קבוע דרך CLAUDE.md — שורד בין הפעלות

אין מסד נתונים, אין backend, אין מנוי חודשי. רק קבצי JSON וקובץ כישרון שמלמד ל-Claude Code איך לנהל אותם.

קח את זה הלאה

• מחירים חיים: הוסף הנושא שמשתמש בחיפוש ברשת כדי לעדכן מחירי מניות לפני כל סקירה
• מטבע מרובה: עקוב אחרי עמדות במטבעות שונים ושמור על סיכון חילופי
• התרעות: הוסף כללים כמו "הזהר אותי אם עמדה כלשהי עולה על 15 אחוז מהתיק שלי"
• מעקב דיבידנד: הקליט תשלומי דיבידנד וחשב סך התשואה כולל הכנסה