Communitygithub.com

1278147072-cell/a-share-financial-factor-report-skill

Skill do Codex para produzir relatórios aplicados em finanças com dados reais de ações A, gráficos em Python, construção de fatores, regressão/discussão de Alpha e entrega em Word.

O que é a-share-financial-factor-report-skill?

Este skill permite que agentes AI (como Codex) gerem relatórios completos sobre fatores financeiros de ações A (A-Share) chinesas, voltados para trabalhos de curso ou análises de investimento. Ele automatiza todo o fluxo: desde a escolha do fator (ex.: qualidade da margem bruta, giro de estoque, qualidade do ROE) com dados reais da API pública da East Money (东方财富), até a construção de gráficos em Python, validação de Alpha via regressão OLS com grupos de fatores, e uma seção conceitual de machine learning (Lasso, Ridge, Random Forest, XGBoost). O resultado é entregue como um relatório em Word (.docx), acompanhado de scripts Python reexecutáveis, arquivos CSV e gráficos PNG organizados na pasta `outputs/`. É especialmente útil para gerar relatórios acadêmicos ou profissionais que exigem transparência nos dados, metodologia clara (9 seções padrão) e interpretação cautelosa, evitando alegações excessivas sobre a existência de Alpha. O skill também oferece suporte a customizações como troca de fatores, expansão de amostra para ~300 empresas e empacotamento de código.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add 1278147072-cell/a-share-financial-factor-report-skill

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Relatório de Fator Financeiro de Ações A

Use este skill para produzir um relatório aplicado em chinês para trabalhos de finanças: um relatório de fator 财务指标因子 com dados reais de ações A, gráficos gerados em Python, construção de fatores, agrupamento/regressão/discussão de Alpha, explicação de fatores via aprendizado de máquina e entrega em Word.

Entregáveis Padrão

Crie estes itens, a menos que o usuário peça o contrário:

  • Um relatório .docx em outputs/.
  • Um script Python em outputs/ que recria dados, gráficos e arquivos de resultados.
  • Dados/resultados CSV em outputs/.
  • Gráficos PNG em outputs/.
  • Opcional: um ZIP dos arquivos de código quando o usuário solicitar “代码打包” ou “代码文件形式输出”.

Para trabalho com DOCX, use também o skill documents se disponível: gere com python-docx, renderize/verifique quando possível e informe se a renderização do LibreOffice não estiver disponível.

Fluxo de Trabalho

  1. Escolher ou confirmar o fator

    • Se o usuário disser “换一个指标” (trocar indicador), escolha um fator novo, não utilizado na thread.
    • Boas opções: 毛利率质量 (qualidade da margem bruta), 经营现金流质量 (qualidade do fluxo de caixa operacional), 存货周转 (giro de estoque), 应收账款质量 (qualidade das contas a receber), 应付账款议价 (poder de barganha com fornecedores), ROE质量 (qualidade do ROE), 资产负债率风险 (risco de alavancagem), 收入增长质量 (qualidade do crescimento da receita), 费用率控制 (controle de despesas), 估值因子 (fator de valuation).
    • Evite repetir empresas e indicadores, a menos que o usuário solicite continuidade.
  2. Usar dados reais de ações A

    • Prefira a interface pública 东方财富 quando a rede estiver disponível.
    • Para casos pequenos, use 3-4 empresas listadas em ações A com contraste setorial claro.
    • Para verificações de Alpha com amostra grande, use cerca de 300 empresas não financeiras de ações A para manter o tempo de execução gerenciável.
    • Exclua indústrias financeiras para fatores operacionais, a menos que o fator seja explicitamente específico do setor financeiro.
    • Informe a fonte de dados como 东方财富公开财务接口 / 2024 年年度报告口径 (API financeira pública da East Money / critérios do relatório anual de 2024) ao usar a API.
  3. Construir o fator

    • Crie de 2 a 4 métricas financeiras interpretáveis.
    • Padronize as métricas antes de combiná-las.
    • Mantenha a fórmula simples e explique os pesos em chinês claro.
    • Exemplo: Fator de Qualidade = 0,50 × Indicador Central Padronizado + 0,25 × Indicador Auxiliar 1 Padronizado + 0,25 × Indicador Auxiliar 2 Padronizado
  4. Gerar gráficos

    • No mínimo: um gráfico de barras da métrica central, um gráfico de barras da métrica auxiliar, um gráfico de dispersão/ranking do fator.
    • Se estiver fazendo Alpha: adicione gráfico de retorno por grupo e gráfico de coeficiente Alpha/Beta.
    • Use títulos e rótulos em chinês. Mantenha os gráficos legíveis dentro do Word.
  5. Validação de Alpha

    • Siga o requisito de imagem: não explique apenas uma empresa. Teste se o fator explica retornos amplos de ações ou tendências de preço.
    • Agrupe por fator em 5 grupos, compare retornos futuros.
    • Rode OLS: Return = α + β × Factor + controles + ε
    • Use controles como tamanho, ROE, alavancagem ou valuation quando disponíveis.
    • Interprete honestamente:
      • Se o grupo alto superar o grupo baixo e β for significativo/positivo: diga que o fator mostra evidência positiva de Alpha.
      • Se α positivo, mas β não significativo: diga que existe um intercepto de mercado/amostra, mas o fator em si não está comprovado.
      • Se o agrupamento e a regressão conflitarem: explique ambos e escolha uma conclusão cautelosa.
  6. Seção de aprendizado de máquina

    • Inclua uma seção conceitual de geração de fatores com ML, mesmo que o sklearn não esteja instalado.
    • Mencione Lasso, Ridge, Random Forest, XGBoost conforme apropriado.
    • Explique que ML combina múltiplas características financeiras para prever retornos futuros/ROE/melhora do fluxo de caixa.
    • Enfatize a lógica financeira e a validação fora da amostra para evitar overfitting.
  7. Estrutura do relatório Use esta estrutura de nove partes para trabalhos de curso:

    • 摘要、关键词 (Resumo, Palavras-chave)
    • 一、研究背景与问题提出 (I. Contexto da Pesquisa e Formulação do Problema)
    • 二、数据来源与处理口径 (II. Fonte dos Dados e Critérios de Processamento)
    • 三、指标构建与因子逻辑 (III. Construção dos Indicadores e Lógica do Fator)
    • 四、Python 图表与结果分析 (IV. Gráficos em Python e Análise dos Resultados)
    • 五、传统方法:分组与回归分析 / Alpha 检验 (V. Métodos Tradicionais: Agrupamento e Análise de Regressão / Teste de Alpha)
    • 六、机器学习方法生成综合因子 (VI. Geração de Fator Composto via Aprendizado de Máquina)
    • 七、公司案例解读 (VII. Interpretação de Casos de Empresas)
    • 八、投资应用建议与局限 (VIII. Sugestões de Aplicação em Investimentos e Limitações)
    • 九、结论 (IX. Conclusão)
    • 附件:数据与代码 (Anexo: Dados e Código)
  8. Extensão

    • Se o usuário solicitar 5000/5500/5700 字以上 (mais de X caracteres), verifique o comprimento final do texto do DOCX com python-docx.
    • Prefira expansão concisa através de metodologia, interpretação de Alpha, ressalvas setoriais e fluxo de ML, não com preenchimento.

Notas da API

Leia references/eastmoney-fields.md ao implementar ou modificar scripts de captura de dados.

Use scripts/factor_report_template.py como ponto de partida ao criar um novo script de métrica. Copie-o para o espaço de trabalho outputs/ ou work/ e adapte:

  • lista de empresas e campos
  • fórmula do fator
  • títulos dos gráficos
  • narrativa do relatório

Linguagem de Interpretação Comum

Use explicações em chinês claro:

  • “Alpha 是否存在” significa se o fator ainda gera retorno excedente após controlar variáveis comuns.
  • “因子对 return 有解释力” significa que grupos de fator alto/baixo mostram retornos futuros diferentes, ou que o β da regressão é significativo.
  • “不能证明 Alpha 存在” é aceitável e muitas vezes melhor do que alegações excessivas.
  • “该指标能解释经营质量,但短期不一定预测股价” é uma conclusão cautelosa válida.

Resposta Final

Forneça o link para o .docx final e os principais arquivos de suporte. Mencione:

  • fator selecionado e empresas
  • se o Alpha foi testado com amostra grande
  • conclusão principal
  • arquivos de código/dados/gráficos gerados

Habilidades Relacionadas