Compétences Portfolio Buddy 2 - Architecture Reference
🏗️

Portfolio Buddy 2 - Architecture Reference

Sûr

Получить справочник по архитектуре Portfolio Buddy 2

Краткий справочник по структуре проекта Portfolio Buddy 2. Содержит иерархию компонентов, паттерны хуков, утилитарные функции и документацию по потоку данных для ускорения разработки.

Prend en charge: Claude Codex Code(CC)
⚠️ 62 Médiocre
1

Télécharger le ZIP du skill

2

Importer dans Claude

Allez dans Paramètres → Capacités → Skills → Importer un skill

3

Activez et commencez à utiliser

Tester

Utilisation de "Portfolio Buddy 2 - Architecture Reference". Как добавить новый компонент графика?

Résultat attendu:

  • • Создать компонент в src/components/
  • • Использовать Chart.js (не Recharts — он не используется)
  • • Импортировать тип графика и плагины из react-chartjs-2
  • • Подключиться к useMetrics или usePortfolio для получения данных
  • • Добавить в соответствующий раздел в App.tsx

Audit de sécurité

Sûr
v3 • 1/10/2026

Pure documentation skill containing only markdown reference material for Portfolio Buddy 2. No executable code, scripts, network calls, filesystem access, or external command execution. Safe for distribution.

1
Fichiers analysés
373
Lignes analysées
0
résultats
3
Total des audits
Aucun problème de sécurité trouvé

Score de qualité

38
Architecture
95
Maintenabilité
83
Contenu
21
Communauté
100
Sécurité
35
Conformité aux spécifications

Ce que vous pouvez construire

Ознакомление с кодовой базой

Понять структуру проекта, иерархию компонентов и поток данных при присоединении к новой команде проекта.

Добавление новых функций

Следовать задокументированным паттернам для добавления новых метрик, графиков, хуков и компонентов в кодовую базу.

Проверка соответствия архитектуре

Проверить, следуют ли предлагаемые изменения установленным паттернам управления состоянием, использования TypeScript и организации компонентов.

Essayez ces prompts

Просмотр дерева компонентов
Покажите мне иерархию компонентов для Portfolio Buddy 2. Каковы основные компоненты и как они вложены друг в друга?
Поиск использования хуков
Как использовать хук useMetrics? Какие данные он возвращает и как его вызывать в моём компоненте?
Отслеживание потока данных
Проведите меня через поток данных от загрузки CSV до отображения метрик. Какие функции и хуки задействованы на каждом этапе?
Добавление новой метрики
Каковы шаги для добавления нового расчёта метрик в Portfolio Buddy 2? Какие файлы нужно изменить?

Bonnes pratiques

  • Следуйте соглашению об именовании с префиксом use для кастомных хуков в src/hooks/
  • Используйте useMemo для дорогостоящих вычислений и useCallback для стабильных колбэков
  • Добавляйте JSDoc-комментарии для сложной логики и экспортируйте все интерфейсы для типобезопасности
  • Держите компоненты под 200 строк, выделяя подкомпоненты при увеличении размера

Éviter

  • Избегайте использования типа any в TypeScript — определяйте правильные интерфейсы для всех структур данных
  • Не устанавливайте и не импортируйте Recharts — Chart.js является установленной библиотекой построения графиков
  • Избегайте передачи пропсов через глубокие деревья компонентов — используйте кастомные хуки для разделения логики

Foire aux questions

Какую библиотеку построения графиков использует Portfolio Buddy 2?
Portfolio Buddy 2 использует Chart.js 4.x с обёрткой react-chartjs-2. Recharts установлен, но никогда не импортируется.
Каков целевой максимальный размер компонента?
Компоненты должны быть размером 200 строк или меньше. PortfolioSection из 591 строки помечен как приоритетный кандидат на рефакторинг.
Имеет ли этот навык доступ к моим файлам или проекту?
Нет. Этот навык предоставляет только справочную документацию. Он не читает, не записывает и не изменяет файлы в вашем проекте.
Какой подход к управлению состоянием использует проект?
Проект использует обычные хуки React (useState, useMemo, useCallback, useRef) без библиотек глобального состояния типа Redux или Zustand.
Какие инструменты поддерживают этот навык?
Этот навык работает с Claude, Codex и Claude Code. Он предоставляет руководство по архитектуре для всех этих AI-ассистентов.
Как обрабатываются данные от загрузки до отображения?
Данные проходят через: парсинг CSV, очистку валюты, загрузку Supabase, агрегацию usePortfolio, фильтрацию по датам, расчёт useMetrics, затем отображение в MetricsTable.

Détails du développeur

Structure de fichiers

📄 SKILL.md