caredhieacid/fund-copilot

Filtro de Fundos do Alipay

Objetivo

A partir de dados públicos de fundos mútuos abertos ou de códigos candidatos fornecidos pelo usuário (do Alipay), gerar um ranking candidato auditável. Todos os valores são calculados por script; não preencher dados com base na impressão do modelo de linguagem.

Comportamento Padrão

Quando o usuário não especificar parâmetros, não pergunte; adote:

• Estratégia: best — recomendação entre todas as categorias: índices amplos A-share, índices de estratégia/temáticos, QDII (exterior), títulos, ações ativas Cada categoria retorna a melhor opção (QDII no máximo 4 fundos), a pontuação só é comparável dentro da mesma categoria; QDII participantes mas com resgate suspenso são removidos, QDII com limite de grande volume/limite de compra são mantidos e marcados;
• Risco: medium; Período de retenção: 3 anos;
• Para cada fundo, fornecer "experiência histórica de retenção" (probabilidade histórica de lucro ao comprar em qualquer ponto e manter por 1/3/5 anos, tempo máximo para recuperar o prejuízo) e "retenção sugerida ≥ N anos" (janela mais curta com taxa de sucesso histórica ≥80%; deve declarar que histórico não representa futuro);
• Excluir: fundos fechados, com data de abertura definida, vários tipos de lock-up de período de retenção/período rotativo, previdência, FOF, títulos secundários/títulos conversíveis, apostas em setor/tema único; Em estratégias de categoria única (ex.: core-index), QDII e índices de dividendo/baixa volatilidade/HK não participam; em best/all participam;
• Remover fundos com participação (cotas) inferior a 0,5 bilhão (risco de liquidação); no máximo 1 fundo por índice (--max-per-index ajustável);
• Indicadores como retorno, rebaixamento, volatilidade são calculados com base em dividendos reinvestidos; modo automático mantém apenas fundos com cobertura histórica completa para a janela de avaliação;
• Não fazer login no Alipay, não ler conta, não fazer pedidos.

É obrigatório indicar na resposta quais parâmetros usaram valores padrão e reafirmar a primeira escolha de cada categoria com sua referência de período de retenção.

Restrições de parâmetros: --risk low atualmente mantém apenas fundos de títulos, não pode ser combinado com --strategy core-index ou --strategy active (o script emitirá erro diretamente); solicitações de baixo risco usam --strategy bond (ou balanced/all).

Passos de Execução

1. Localize o diretório onde este SKILL.md está, denomine-o SKILL_DIR.
2. Verifique se SKILL_DIR/.venv/bin/python existe; se não existir, solicite ao usuário que execute ./setup.sh nesse diretório, não invente resultados.
3. Mapeie a intenção do usuário para parâmetros:
   • "Recomendar os melhores", "Sem restrições de tipo", "Dar uma olhada": --strategy best (padrão)
   • Investimento periódico de longo prazo, posição central para pessoa comum, índices amplos: --strategy core-index
   • Estável, baixa volatilidade, fundos de títulos: --strategy bond --risk low
   • Fundos de ações ativos/mistos: --strategy active, e lembrar que a correção de mudanças de gestor é limitada
   • Comparação entre vários tipos: --strategy balanced
   • Quando o usuário fornecer códigos de fundo explícitos, use --codes; quando fornecer um pool candidato em CSV/texto, use --watchlist
4. Execute o script a partir de SKILL_DIR. Exemplo:

cd "$SKILL_DIR"
.venv/bin/python scripts/fund_picker.py \
  --strategy core-index \
  --risk medium \
  --holding-years 5 \
  --top 5 \
  --output /tmp/alipay_fund_report.md \
  --json-output /tmp/alipay_fund_report.json

Comparação com códigos de fundo específicos:

cd "$SKILL_DIR"
.venv/bin/python scripts/fund_picker.py \
  --codes "000051,110020,161017" \
  --risk medium \
  --holding-years 3 \
  --top 3

Modo estrito com pool candidato do Alipay:

cd "$SKILL_DIR"
.venv/bin/python scripts/fund_picker.py \
  --watchlist /path/to/alipay_watchlist.csv \
  --risk medium \
  --holding-years 3 \
  --top 5

5. Leia o Markdown e JSON gerados; a resposta deve conter:
   • Data de corte dos dados ("Dados de valor patrimonial líquido até" no cabeçalho do relatório);
   • Primeira escolha e código do fundo (modo best: primeira escolha de cada categoria);
   • Pelo menos duas alternativas;
   • Retorno anualizado, rebaixamento máximo, volatilidade anualizada, proporção de meses com lucro ou Sharpe;
   • Principais riscos de cada fundo, além do período de retenção de referência e experiência histórica de retenção (proporção de janelas com lucro/pior janela/tempo para recuperar);
   • Se o relatório contiver "Dica de correlação" ou "Comparação de taxas das classes A/C", deve ser reafirmado;
   • Ao citar "Referência de valuation do índice", manter o adjetivo "Dados de referência, não são conselho de investimento";
   • Últimos itens de verificação dentro do Alipay.
6. Se a fonte de dados falhar, o código do fundo não existir ou o histórico for insuficiente, explique conforme está, sem adivinhar ou inventar valores. Códigos de fundo fornecidos explicitamente pelo usuário não serão filtrados silenciosamente: QDII, períodos de lock-up, resgate suspenso, etc., são mantidos e marcados com aviso de risco. Fundos que não puderam ser avaliados aparecem na seção "Registro de falhas de dados e exclusões" do relatório — a resposta deve reafirmar cada um deles ao usuário. Classes A/C fornecidas juntas são mantidas lado a lado para facilitar a comparação de taxas.

Manutenção da Lista de Observação do Alipay (Importação de Captura de Tela)

O Alipay não possui função de exportação de lista de observação. Quando o usuário fornecer capturas de tela da página de fundos do Alipay (página de observação, página de resultados de pesquisa, página de detalhes do fundo), siga o fluxo abaixo para incorporar os candidatos à lista de observação:

1. Extraia apenas código do fundo e nome abreviado do fundo da captura; valores de posição, números de lucro, apelidos de conta, avatares, etc., são todos ignorados — não extrair, não reafirmar, não gravar em nenhum arquivo.
2. Se a captura tiver apenas o nome sem o código, não adivinhe o código com base na memória; primeiro use o nome para corresponder a um código único nos dados públicos (ex.: cache de tabela de classificação). Itens com correspondência não única ou falha são listados separadamente e o usuário deve confirmar o código no Alipay antes de adicioná-los ao pool.
3. Mesclar com SKILL_DIR/watchlist.csv (ou CSV especificado pelo usuário): manter itens existentes do usuário, deduplicar por código de 6 dígitos e gravar de volta. Se o arquivo não existir, criar novo seguindo o formato de examples/alipay_watchlist.example.csv. A lista de observação do usuário é dado pessoal, sempre gravada em watchlist.csv gitignorado, nunca em arquivos de modelo em examples/ (para evitar vazamento de posições junto com o repositório).
4. Após adicionar ao pool, re-filtrar com --watchlist e lembrar ao usuário: a identificação por captura de tela pode estar incorreta, antes de comprar, ainda é necessário verificar pelo código do fundo dentro do Alipay.

Limites de Risco

• A saída é um candidato para pesquisa, não uma ordem de compra com garantia de lucro.
• Não usar rankings de 1 semana ou 1 mês como base principal.
• A taxa de subscrição no relatório é o preço com desconto de terceiros exibido pela East Money; o desconto do Alipay pode ser diferente; para custo de retenção contínua, veja "Taxa contínua/ano" (taxa de administração + taxa de custódia) e confira a taxa de serviço da classe C dentro do Alipay.
• Não declare diretamente que um fundo de títulos é "superior" a um fundo de ações entre categorias de risco diferentes.
• Não ler ou salvar contas, senhas, códigos de verificação do Alipay, nem informações sensíveis de capturas de tela de posições.
• Não executar automaticamente subscrição, resgate, conversão ou configuração de investimento periódico.
• O modo automático não pode confirmar se o fundo está realmente disponível na conta pessoal do usuário no Alipay; deve-se verificar pelo código do fundo dentro do Alipay.
• Para fundos ativos, se não for possível separar com precisão o período de atuação do gestor atual, reduzir a confiança na conclusão e explicar claramente.