Communitygithub.com

KCNyu/clawock

Revisión multiagente de las carteras actuales de KCN. Inspirado en el marco TauricResearch/TradingAgents. Análisis en tres niveles (analistas → debate alcista/bajista → debate de riesgo + juez) con puntuación de confianza.

¿Qué es clawock?

Este skill implementa una revisión de cartera multiagente estructurada en tres niveles, claramente inspirada en el marco TauricResearch/TradingAgents. Los agentes del Nivel 1 (analistas) examinan en paralelo desde cuatro perspectivas técnicas y fundamentales: posición/mercado, fundamentales, noticias/sentimiento y vínculos entre mercados. El Nivel 2 enfrenta a un investigador alcista y uno bajista que leen los informes de los analistas y defienden posturas opuestas. El Nivel 3 replica el debate de gestión de riesgo con voces agresiva, conservadora y neutral, para que un Juez (gestor de riesgo) sintetice la decisión final. Está diseñado para revisiones posteriores al cierre, planificación de la siguiente sesión, decisiones de dimensionamiento previas a la entrada o cualquier momento en que un análisis de un solo paso resulte insuficiente. El Juez aplica un sistema de ponderación de fuentes de señal, verifica límites estrictos de apalancamiento y posición, y emite una puntuación de confianza (0-100%) para cada recomendación principal.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/KCNyu/clawock/tree/HEAD/skills/portfolio-swarm-review

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Revisión de Cartera Multiagente

Revisión de cartera multiagente. La estructura refleja el diseño de TauricResearch/TradingAgents: analistas (Nivel 1) → investigadores (Nivel 2) → debatientes de riesgo + juez (Nivel 3). Cada nivel es distinto en el resultado; el Juez sintetiza. (El repositorio de referencia ya no está clonado localmente; la estructura se registra aquí).

Lecturas obligatorias

En este orden:

  1. /root/.openclaw/workspace/MEMORY.md
  2. /root/.openclaw/workspace/portfolio.json
  3. /root/.openclaw/workspace/INVESTMENT_SOP.md
  4. /root/.openclaw/workspace/TOOLS.md para detalles de la cadena de datos
  5. ../daily-deep-brief/references/technical-playbooks.md antes de cualquier síntesis de adición/promedio descendente

Los activos activos frente a los salidos se determinan únicamente a partir de portfolio.json (shares > 0 / == 0); el resumen mantenido a mano que solía ser el paso 3 se desvió 3,5 meses y se eliminó (#1067).

Regla de datos frescos

Actualizar las cotizaciones antes de producir conclusiones:

/root/.local/bin/clawock analyze-us    # US 7-route fallback
/root/.local/bin/clawock analyze-hk    # HK Tencent + Eastmoney full-batch cross-check/fallback → stooq → yfinance

Si una pata está desactualizada, nombre el ticker exacto y limite la confianza en las conclusiones que la involucren. 00100 solo tiene Tencent — marcar explícitamente si esa pata falla. Vinculación KR: 07709/07747 están salidos, pero SKHY (SK Hynix ADR) se puede mantener — verificar portfolio.json en lugar de asumir que toda la cadena está muerta.

Agrupación de tenencias — leer cada ejecución, no codificar

Obtener el conjunto activo de portfolio.json (shares > 0). Estructura de grupos estable; el contenido varía:

  • US growth / single-name beta — nombres US activos no apalancados de crecimiento
  • US leverage ETF — cualquier cosa con is_leveraged_etf: true
  • US theme / special situation — nombres impulsados por catalizadores
  • HK lower-beta core — ETFs de índices/sectores (p. ej. 03032, 03033)
  • HK single-name — acciones individuales (p. ej. 00100 AI, 02208 wind)
  • HK leverage ETF — recetas 2x/3x (p. ej. 07226)

Detección de régimen (ejecutar primero)

Antes de cualquier análisis de roles, clasificar el régimen actual — esto calibra todo lo posterior:

RégimenDisparadorImplicación para el tamaño
Tendencia alcistaADX del índice > 25, MA20 > MA50, RSI 50-70 en todo el libroFavorable al momentum — los ETF apalancados se pueden mantener, recortar solo en sobrecalentamientos (RSI > 75)
Tendencia bajistaADX del índice > 25, MA20 < MA50, amplios mínimos decrecientesRisk-off — la decadencia de los ETF apalancados se acelera, preferir efectivo, no añadir
Rango lateralADX < 20, acción lateral, RSI mean-reverting alrededor de 50Jugadas de reversión a la media — solo T, fadear extremos
Volátil / cambio de régimenAlta varianza, stacks de MA en conflicto, caos de sentimientoReducir tamaño, ampliar stops, sin convicciones hasta que haya claridad

Proxys del índice: 纳指 / QQQ para el libro US growth; ^HSTECH para el libro HK tech-heavy.

Nivel 1 — Analistas (paralelo)

Cuatro roles de analista, ejecutados de forma independiente. Refleja tradingagents/agents/analysts/.

Analista 1 — Posición / Mercado

  • Para cada tenencia activa: precio vs costo, PnL $ y %, distancia al punto de equilibrio
  • Estado técnico: tendencia, RSI-14, postura MA20/50, soporte/resistencia inmediatos
  • Clasificar: core / tactical / weak / leverage-risk
  • Salida: veredicto de una línea por ticker + señalar el más fuerte y el más débil

Analista 2 — Fundamentales

  • Ganancias / tendencia de ingresos recientes para nombres no ETF
  • Instantánea de valoración (P/E, P/S vs sector e histórico)
  • Titulares del balance para nombres de situación especial (cash runway, deuda)
  • Para ETFs: salud del subyacente, prima/descuento NAV, decadencia desde la fecha de tenencia
  • Salida: por tenencia no ETF — "fair / stretched / cheap"; por ETF — "structurally OK / decay-risk now"

Analista 3 — Noticias / Sentimiento

  • Noticias de Finnhub desde scripts (analyze_*_stocks.py sin --no-news ya obtiene 7 días + sentimiento de palabras clave)
  • Para nombres US: Reddit (r/wallstreetbets + r/stocks JSON, sin autenticación) + Tavily news/X
  • Para nombres HK: 雪球 HK 评论区 + 富途社区 (scrapling StealthyFetcher) + Tavily 中文搜索
  • 南向资金 当日 net (búsqueda web) para el tono macro de HK
  • Salida por tenencia: puntuación de sentimiento -1 a +1 + 1–2 narrativas + divergencia vs precio señalada

Analista 4 — Vínculo entre mercados

  • Lado US: tono de 纳指 / 罗素 / SOX; hilos temáticos (stablecoin reg para CRCL, space/defense para RKLB, AI infra threads)
  • Lado HK: dirección de 恒科; flujo de 南向资金; política sectorial (风电 / AI / 监管)
  • Inter-mercado: relación US tech overnight → HK tech open; notar cuando el vínculo se rompe
  • Salida: etiqueta supportive / neutral / weak por cadena, señal inter-mercado única más importante

Nivel 2 — Investigadores alcista vs bajista

Refleja tradingagents/agents/researchers/. Se ejecuta después del Nivel 1; cada investigador lee los cuatro informes de analistas y defiende una postura.

Investigador alcista

  • Componer el caso más sólido de "mantener y añadir" usando los resultados del Nivel 1
  • Citar hallazgos específicos de los analistas como evidencia (no corazonadas)
  • Identificar qué tendría que ser cierto para que la posición funcione
  • Señalar específicamente el upside asimétrico (apalancamiento, fechas de catalizador, brechas sentimiento-vs-fundamentales)

Investigador bajista

  • Componer el caso más sólido de "recortar y evitar"
  • Citar hallazgos de riesgo específicos, matemática de decadencia, señales de sentimiento tope
  • Identificar el peor resultado plausible y qué lo desencadena
  • Refutar directamente el punto más fuerte del alcista

La salida es un fragmento de debate (no una lista de verificación), 100–200 palabras cada lado.

Nivel 3 — Debate de riesgo + Juez

Refleja tradingagents/agents/risk_mgmt/ + managers/risk_manager.py.

Voz de riesgo agresiva

  • Argumenta a favor de la captura del upside; presiona por el tamaño completo en nombres de convicción
  • Cita los puntos más fuertes del alcista
  • Señala específicamente dónde la voz conservadora pierde el costo de oportunidad

Voz de riesgo conservadora

  • Argumenta a favor de la preservación del capital; presiona por recortar en estructura débil
  • Cita los puntos más fuertes del bajista
  • Señala específicamente dónde la voz agresiva subestima el riesgo de cola

Voz neutral

  • Señala el punto medio — qué aumentar de tamaño, qué reducir, qué mantener
  • Requerido: elegir un lado para cada tenencia en disputa, sin salidas de "depende"

Juez (Gestor de riesgo)

Síntesis final. Ponderar las tres voces de riesgo dado:

  • La preferencia de riesgo documentada del usuario: aggressive (por workspace MEMORY.md), por lo que la voz agresiva obtiene peso a menos que su contraparte estructural sea fuerte
  • El régimen actual (de la detección de régimen anterior)
  • La frescura de los datos — cualquier pata desactualizada reduce la confianza

Decisiones de estrategia de salida por ticker. El mismo ticker puede tener decisiones separadas de core_position, intraday_t y risk_rebalance el mismo día:

  • Hold and watch — tesis intacta, sin acción
  • Trim on rebound — tesis debilitándose, esperar fortaleza
  • T-only — sin convicción nocturna, fadear extremos
  • Add only on trigger — disparador explícito (precio / cruce de MA / ganancias / política)
  • Cut — tesis rota, salir en la próxima oferta aceptable (usar con moderación)

Cada elemento: ticker + razón concreta + disparador/nivel concreto si corresponde.

Ponderación de fuentes de señal (driven_by edge — REQUERIDO)

No todas las fuentes de señal se han ganado el derecho de impulsar una decisión. Leer las métricas actuales del libro de contabilidad v2 (decision_metrics.by_driver, by_strategy y by_condition) y comparar n_episodes, beneficio promedio e IC de clúster de fecha. Nunca copiar una tasa puntual de un informe antiguo. Si n es pequeño o el IC cruza cero, llamarlo evidencia direccional solamente. Los catalizadores duros pueden impulsar una decisión táctica/de evento; el sentimiento suave solo ajusta la confianza. El desapalancamiento basado en políticas es una decisión separada de risk_rebalance con driven_by=risk_rule, no una afirmación de timing edge.

Para el tamaño de las llamadas activas, la confianza aportada es un campo de auditoría, no una probabilidad de ganancia. Hacer coincidir la action + driver + condition + regime propuesta contra decision_metrics.hierarchical_calibration.current_group_calibrators. Una fila exacta faltante o abstain=true normalmente contribuye con cero tamaño incremental. La única excepción de arranque en frío es un tramo de configuración técnica aprobado por paquete exactamente en min_tranche_shares, con las compuertas de tesis/riesgo/lote aprobadas y remaining_tranches > 0; esto crea evidencia prospectiva y no puede ampliarse ni repetirse mientras esté abierto. edge_supported=false después de evidencia suficiente desactiva esa excepción. De lo contrario, multiplicar el tamaño de señal propuesto por signal_size_multiplier y mostrar la probabilidad calibrada, el IC y el nivel de jerarquía resuelto. La tabla solo lleva filas con evidence_sufficient=true; los conteos omitidos residen en current_group_calibrators_omitted / omitted_abstain_reasons. Esto nunca cancela una acción de tope duro obligatoria de risk_rebalance + risk_rule, porque eso es política, no timing alpha.

Límites duros de posición/apalancamiento (REQUERIDO — anula la lógica de señal Y el régimen)

La caída fue un problema de construcción (US β≈4.4, 73% ETFs apalancados, HK 85% un factor), no un problema de señal. Incluso antes de que se aplique la ponderación de fuentes de señal, el Juez debe verificar estos límites duros contra el libro activo y emitir un recorte disciplinario/venta para cualquier infracción:

LímiteUmbralSi se incumple
Núcleo único no apalancado35–60% revisión; ≤60% obligatorioRevisar tesis en la banda; recortar solo por encima del 60%
Nombre único apalancado≤35%Intercambiar/reducir la pata apalancada
Clúster correlacionado medido≤70% con cobertura del libro ≥80%Reducir el clúster, miembro apalancado primero; los clústeres de un solo nombre no cuentan
ETFs apalancados (por pata)≤50%Recortar apalancamiento a ≤50%
US β vs S&P≤3.0Desapalancar (recortar ETFs apalancados primero, no el nombre único de alta convicción)
Stop de ETF apalancado único−18% vs costoStop duro → swap 2x→1x mismo factor (mantener exposición, detener decadencia)

Reglas: cada infracción debe producir una acción concreta en la síntesis del Juez (sin "observar"). Una fila de banda de revisión no apalancada del 35-60% es consultiva, no una infracción, y no debe convertirse en un recorte meramente por diversificación. Etiquetar las infracciones reales con driven_by=risk_rule (rebalanceo disciplinario, no noticias). Esta es la única excepción a un valor predeterminado de HOLD en tendencia alcista/riesgo activo — en una melt-up, recortar el apalancamiento hacia la fortaleza, no después de la caída. Desapalancar recortando ETFs apalancados (la fuente de β), nunca desmantelando la tesis de un nombre único de alta convicción. Las directivas de patas apalancadas usan el swap 2x→1x mismo factor (no liquidación) según brief_preflight.LEV_1X_SWAP; la reentrada 1x→2x solo con 🧭 régimen verde. Estos límites reflejan brief_preflight.compute_risk_guardrail / the brief's 「🚦 仓位/杠杆硬闸」 — mantener los umbrales sincronizados.

Leer risk_discipline.records junto con la salida del detector e informar para cada infracción abierta su ID estable, antigüedad, estado de reconocimiento y evidencia de ejecución. Una anulación local del plan no tiene autoridad; solo una anulación duradera, razonada y no vencida la tiene. Mientras un registro crítico/alto permanezca abierto, no recomendar añadir el mismo nombre, sleeve apalancado o factor. Las salidas siguen siendo legales, así como un par 2×→1× del mismo plan cuya exposición ajustada por factor disminuye.

Puntuación de confianza

Finalizar el informe con una puntuación de confianza por cada llamada principal, 0-100%:

ConfianzaCalibración
80-100%Los cuatro analistas se alinean, los casos más sólidos de ambos investigadores convergen, datos frescos, régimen claro
60-79%La mayoría de los analistas se alinean, un analista disiente, régimen claro
40-59%Analistas divididos, régimen mixto, o una pata de datos importante desactualizada
20-39%Señales en conflicto, se sospecha cambio de régimen, múltiples patas desactualizadas
< 20%No actuar basado en esta lectura; esperar claridad

Estructura final de salida

Encabezado

  • Régimen: {tendencia alcista / tendencia bajista / rango / volátil}
  • Frescura de datos: timestamp + cualquier ticker desactualizado marcado con ⚠️
  • Resumen del libro: PnL total US, PnL total HK, mayor ganador/perdedor

Nivel 1 — Informes de analistas

Cuatro subsecciones (Mercado, Fundamentales, Noticias/Sentimiento, Entre mercados). Cada una concisa — tablas donde hay datos, prosa donde hay juicio.

Nivel 2 — Alcista vs bajista

Dos párrafos, enmarcados lado a lado.

Nivel 3 — Debate de riesgo

  • Voz agresiva (párrafo)
  • Voz conservadora (párrafo)
  • Voz neutral (párrafo)

Síntesis del Juez

Decisiones de estrategia con ticker, strategy_id, acción, condición, driver y razón. Preservar estrategias simultáneas en lugar de forzar un solo veredicto combinado.

Llamadas de confianza

Lista con viñetas: "{Acción} {Ticker} — confianza XX% — {razón de una línea}"

Plan para la siguiente sesión

Plan concreto: qué observar primero en la apertura, qué tenencias importan más, disparadores de precio/macro que cambian la postura.

Reglas de estilo

  • Práctico, no académico
  • Cada afirmación vinculada a un ticker real en el libro actual
  • Los resultados de los cuatro analistas deben ser ÁNGULOS DIFERENTES, no el mismo contenido reformateado
  • Alcista/Bajista deben realmente discrepar en al menos una posición — si están completamente de acuerdo, el debate falló y el usuario debe saberlo
  • No permitir que un tema de alta convicción oculte una estructura deficiente (p. ej., "la historia de RKLB es fuerte" no significa que el RSI de hoy en 75 sea una compra)
  • Tablas para cualquier conjunto de 3+ puntos de datos
  • ⚠️ datos desactualizados marcados antes de que cualquier conclusión los use
  • Plan final lo suficientemente conciso para operar desde él

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados