Portfolio Risk Desk
Positioning
This skill should be presented externally as Portfolio Risk Desk. The internal identifier can remain intelligence-desk-brief where needed for filenames or metadata.
Purpose
This skill turns public market information into a portfolio-aware daily or on-demand analysis brief. It does not make decisions for the user. It maps a user's holdings and themes to simplified exposures, gathers supporting evidence, compares what changed over time, and explains the likely portfolio implications so the human can decide.
Every brief should begin by orienting the reader: clearly restate the portfolio or watchlist in scope and the industries or themes of interest before the analysis starts. The brief may still answer what happened, but its main job is to explain what to make of those changes for the user's exposures, drivers, and scenario risks.
This is a simplified public-markets research assistant, not an institutional-grade risk model. It produces factor-style decomposition, scenario analysis, peer read-throughs, and structured evidence from public information.
Architecture boundary
This repo is the skill package. It owns retrieval, normalization, ranking, synthesis, rendering, and the host handoff payload.
OpenClaw or ClawHub should own:
- - user authentication and workspace scoping
- provider secret management
- Redis-backed memory orchestration
- Notion API writes and persistence
- first-run Apify task bootstrap using the user's INLINECODE2
That means this skill generates the brief and a stable handoff contract, while the host is responsible for executing Redis and Notion side effects.
When to use
Use this skill when the user wants:
- - A daily or on-demand brief for a portfolio, watchlist, or theme that goes beyond summarization
- A portfolio-aware read on which exposures, factors, and risk drivers matter most right now
- A sector pulse for an industry such as semiconductors, AI infrastructure, cybersecurity, cloud software, luxury retail, or fintech
- Peer read-throughs from one company update to other names
- A concise explanation of what changed, why it matters, and how the risk map has shifted since the last brief
- A simple scenario lens such as rates up, oil down, AI capex slowing, or one major holding missing expectations
- Delivery of the brief through a host-managed Notion handoff
Do not use this skill for:
- - Trade execution
- Price targets or investment advice
- Fabricating missing evidence
- Hard claims without source support
- Claiming precise institutional-style factor or VaR modeling
Inputs
The skill accepts:
- -
portfolio_name (optional) - INLINECODE4 : list of tickers
- INLINECODE5 : list of tickers
- INLINECODE6 : list of industries or themes
- INLINECODE7 :
daily, on_demand, or INLINECODE10 - INLINECODE11 : integer, default 24 for daily and 72 for on-demand
- INLINECODE12 :
notion or INLINECODE14 - INLINECODE15 : integer, default 8
- INLINECODE16 (optional): index, peer basket, or prior brief comparison lens
- INLINECODE17 (optional): stress questions such as rates up 50 bps or a named company missing expectations
Operating rules
- 1. Gather evidence first, synthesize second.
- Separate facts from interpretation.
- Rank relevance by user holdings, theme match, recency, cross-name impact, and change versus prior briefs when memory exists.
- Prefer primary or direct-source material when available.
- If support is weak, say it is weak.
- Never recommend a trade. End with watchpoints, not commands.
- Include source links or source titles for every key item.
- Start the brief with a short user-focus snapshot that restates the portfolio or watchlist and the industries or themes being tracked.
- Treat news as supporting evidence, not the main product.
- Make explicit what changed, what exposures matter now, and what the user should monitor next.
Workflow
- 1. Resolve tickers, company names, industries, and user-priority themes.
- Map each holding or watchlist name to simplified exposures and factor buckets such as AI capex, semiconductor demand, rates sensitivity, consumer demand, China or regulatory exposure, supply-chain concentration, and earnings revision sensitivity.
- Pull macro, company, peer, and public-web signals through Apify-backed collection, with X used as a complementary fast-moving signal source when available.
- If live retrieval is enabled and task IDs are missing, bootstrap the user's saved Apify tasks from
APIFY_API_TOKEN. - Normalize the evidence into structured notes that separate facts, interpretation, and confidence.
- In OpenClaw, use memory tooling such as
memory_recall to retrieve prior relevant notes and prior brief context before final synthesis when memory is available. - Score items by relevance, recency, impact, and change in the portfolio risk map.
- Draft the brief in the required output template with exposures first, then changes, then scenarios, then evidence.
- In OpenClaw, persist the most important resulting brief context through memory tooling such as
memory_store so later runs can compare against it. - Deliver inline or emit a host-managed Notion handoff.
OpenClaw Memory Guidance
When running inside OpenClaw or ClawHub with Redis-backed memory tooling available:
- - Use
memory_recall before drafting the final brief to retrieve recent prior brief context for the same portfolio/watchlist and themes. - Prefer recalled brief summaries, dominant factors, top drivers, unresolved watchpoints, and recent high-signal items over generic conversation memory.
- Use
memory_store after producing the brief to persist:
- portfolio/watchlist and themes
- summary
- dominant factors
- top drivers and read-throughs
- risk-map changes
- unresolved watchpoints
- - Treat memory as a product aid, not as a license to make unsupported claims.
- If memory is unavailable or returns weak/noisy context, degrade gracefully and say the comparison is first-run or limited.
Stack roles
- -
Civic: host-level least-privilege OAuth layer that helps constrain what the agent can access or do on behalf of the user. - INLINECODE24 : host-managed memory layer for prior briefs, normalized evidence, change logs, and cross-day comparison.
- INLINECODE25 : broad public-web retrieval and scraping layer for company, macro, industry, and market evidence.
- INLINECODE26 : user-scoped saved tasks that can be created automatically during onboarding or set manually as a fallback.
- INLINECODE27 : complementary high-velocity signal layer for official accounts, management commentary, and market-adjacent chatter. For MVP, this can be collected through Apify-backed workflows, with direct integration evaluated later.
- INLINECODE28 : optional comparison point or future enhancement for testing richer retrieval quality and memory continuity over time. It should be framed as an evaluation path, not a core dependency.
- INLINECODE29 : host-managed persistence destination that consumes the handoff produced by this skill.
Output requirements
Every brief must contain these sections:
- - User focus snapshot
- Current exposure map
- Dominant factors
- What changed since last brief
- Key drivers and cross-holding read-throughs
- Scenario analysis
- Signal vs noise
- Open questions and watchpoints
- Evidence and sources
The executive summary should reiterate the portfolio or watchlist and the industries or themes so the user is immediately grounded in what the brief is about. It should also say what changed and what to make of it for the current portfolio risk map.
The exposure map should make dominant factors easy to scan, and every scenario should carry an explicit confidence level so the brief does not present speculative pathways too assertively.
Keep the brief concise, analysis-first, evidence-led, and explicit about uncertainty.
投资组合风险简报
定位
该技能对外应呈现为投资组合风险简报。内部标识符可在文件名或元数据需要时保留为intelligence-desk-brief。
目的
该技能将公开市场信息转化为具有投资组合意识的每日或按需分析简报。它不为用户做决策。它将用户的持仓和主题映射为简化的风险敞口,收集支持性证据,比较随时间发生的变化,并解释可能对投资组合产生的影响,以便人类做出决策。
每份简报在分析开始前,应首先引导读者:清晰重述范围内的投资组合或观察清单,以及感兴趣的行业或主题。简报仍可回答发生了什么,但其主要任务是解释这些变化对用户的风险敞口、驱动因素和情景风险意味着什么。
这是一个简化的公开市场研究助手,而非机构级风险模型。它生成因子式分解、情景分析、同行传导分析以及来自公开信息的结构化证据。
架构边界
本仓库是技能包。它负责检索、标准化、排序、综合、渲染以及主机交接负载。
OpenClaw或ClawHub应负责:
- - 用户认证和工作空间范围界定
- 提供商密钥管理
- 基于Redis的记忆编排
- Notion API写入和持久化
- 使用用户的APIFYAPITOKEN进行首次运行的Apify任务引导
这意味着该技能生成简报和稳定的交接合约,而主机负责执行Redis和Notion的副作用。
使用时机
当用户需要以下内容时使用此技能:
- - 针对投资组合、观察清单或主题的每日或按需简报,超越简单的摘要
- 具有投资组合意识的解读,说明哪些风险敞口、因子和风险驱动因素目前最为重要
- 针对半导体、AI基础设施、网络安全、云软件、奢侈品零售或金融科技等行业的板块脉搏
- 从一家公司更新到其他标的的同行传导分析
- 简明解释发生了什么变化、为何重要,以及自上次简报以来风险图谱如何变化
- 简单的场景视角,如利率上升、油价下跌、AI资本支出放缓或某主要持仓未达预期
- 通过主机管理的Notion交接交付简报
请勿将此技能用于:
- - 交易执行
- 目标价或投资建议
- 编造缺失的证据
- 缺乏来源支持的硬性断言
- 声称精确的机构级因子或VaR建模
输入
该技能接受:
- - portfolioname(可选)
- holdings:股票代码列表
- watchlist:股票代码列表
- themes:行业或主题列表
- brieftype:daily、ondemand或earningsreaction
- lookbackhours:整数,每日默认为24,按需默认为72
- deliverytarget:notion或inline
- maxitemspertheme:整数,默认为8
- benchmarkorcomparisonlens(可选):指数、同行组合或先前简报比较视角
- scenario_questions(可选):压力测试问题,如利率上升50个基点或某指定公司未达预期
操作规则
- 1. 先收集证据,后综合。
- 区分事实与解读。
- 根据用户持仓、主题匹配度、时效性、跨标的关联度以及与先前简报(如有记忆)的变化进行相关性排序。
- 优先使用一手或直接来源材料(如有)。
- 如果支持力度弱,则明确说明。
- 绝不推荐交易。以关注点而非指令结束。
- 每个关键项目均需包含来源链接或来源标题。
- 简报开头需包含简短的用户焦点快照,重述投资组合或观察清单以及正在追踪的行业或主题。
- 将新闻视为支持性证据,而非主要产品。
- 明确说明发生了什么变化、哪些风险敞口现在重要,以及用户接下来应关注什么。
工作流程
- 1. 解析股票代码、公司名称、行业和用户优先主题。
- 将每个持仓或观察清单名称映射为简化的风险敞口和因子类别,如AI资本支出、半导体需求、利率敏感性、消费需求、中国或监管风险敞口、供应链集中度以及盈利修正敏感性。
- 通过Apify支持的采集拉取宏观、公司、同行和公共网络信号,X(如有)作为补充的快速变动信号源。
- 如果启用了实时检索且任务ID缺失,则从APIFYAPITOKEN引导用户的已保存Apify任务。
- 将证据标准化为结构化笔记,区分事实、解读和置信度。
- 在OpenClaw中,在最终综合前(如有记忆可用),使用memoryrecall等记忆工具检索先前相关的笔记和先前简报上下文。
- 根据相关性、时效性、影响力和投资组合风险图谱变化对项目进行评分。
- 按照要求的输出模板起草简报,先写风险敞口,然后是变化,接着是情景,最后是证据。
- 在OpenClaw中,通过memorystore等记忆工具持久化最重要的简报上下文结果,以便后续运行可与之比较。
- 以内联方式交付或发出主机管理的Notion交接。
OpenClaw记忆指导
当在OpenClaw或ClawHub内运行且可使用基于Redis的记忆工具时:
- - 在起草最终简报前,使用memoryrecall检索同一投资组合/观察清单和主题的近期先前简报上下文。
- 优先使用回忆的简报摘要、主导因子、主要驱动因素、未解决关注点和近期高信号项目,而非通用对话记忆。
- 在生成简报后,使用memorystore持久化:
- 投资组合/观察清单和主题
- 摘要
- 主导因子
- 主要驱动因素和传导分析
- 风险图谱变化
- 未解决关注点
- - 将记忆视为产品辅助工具,而非做出无依据断言的许可证。
- 如果记忆不可用或返回弱/嘈杂的上下文,优雅降级并说明比较是首次运行或有限。
堆栈角色
- - Civic:主机级最小权限OAuth层,帮助约束代理可代表用户访问或执行的内容。
- Redis:主机管理的记忆层,用于存储先前简报、标准化证据、变更日志和跨日比较。
- Apify:广泛的公共网络检索和抓取层,用于获取公司、宏观、行业和市场证据。
- Apify任务:用户范围的已保存任务,可在入职期间自动创建,或作为回退手动设置。
- X:补充的高速度信号层,用于官方账号、管理层评论和市场相关讨论。对于MVP,可通过Apify支持的工作流程收集,直接集成留待后续评估。
- Contextual AI:可选的比较点或未来增强,用于测试更丰富的检索质量和随时间推移的记忆连续性。应将其定位为评估路径,而非核心依赖。
- Notion:主机管理的持久化目标,消费该技能生成的交接内容。
输出要求
每份简报必须包含以下部分:
- - 用户焦点快照
- 当前风险敞口图谱
- 主导因子
- 自上次简报以来的变化
- 关键驱动因素和跨持仓传导分析
- 情景分析
- 信号与噪音
- 未解决问题和关注点
- 证据和来源
执行摘要应重申投资组合或观察清单以及行业或主题,使用户立即了解简报内容。还应说明发生了什么变化,以及这对当前投资组合风险图谱意味着什么。
风险敞口图谱应使主导因子易于浏览,每个情景应附带明确的置信度水平,以免简报过于武断地呈现推测性路径。
保持简报简洁、分析优先、以证据为导向,并明确说明不确定性。