Portfolio monitoring 是一个面向投资组合持仓监控的智能体技能，由 Nimble 提供，运行 Nimble gallery 中的 portfolio-monitoring 模板。它的核心用途是：针对某一只持仓，列出从指定日期（since date）以来发生的重大事件，并逐条说明为什么这些事件重要。
主要能力 该技能关注的事件类型包括：高管变动（exec changes）、诉讼（litigation）、评级行动（rating actions）、业绩指引（guidance）和违约（defaults）。输出只包含 since 日期之后的重大事件，每条事件都带有日期和来源引用，并附有“为何重要”的说明。如果期间没有发生重大事件，技能会返回一个空列表，并列出它检查过的来源。
使用方式 用户需要提供持仓信息（名称或股票代码，或一个列表），这是必填项。可选输入包括：起始日期（格式 YYYY-MM-DD，若跳过则默认30天前）和重大性规则（例如“忽略产品发布”，若跳过则使用模板默认规则）。技能会从用户已有的信息中提取输入，只询问缺失的部分。
运行流程分为三步，并在每步开始时显示进度行：
- 第1步（共3步）：初步快速结果。使用快速搜索（如 Nimble 的 nimble_search 或宿主自带的网页搜索工具）在一分钟内给出简短结果，每个事实都附链接。
- 第2步（共3步）：更深入的研究。轮询中等强度运行的状态，完成后以简短表格或简报形式展示结果，突出2-3条最有用的信息，指出与第1步相比的新增或不同之处，并说明缺失的字段。
- 第3步（共3步）：完整深度研究结果。高强度运行完成后，同样方式展示，重点说明相比第2步新增或修正的内容，然后给出完整结果。
技能默认同时启动中等（2-4分钟，$0.10）和高（5-15分钟，$0.50）两种强度的运行，让用户先看到初步结果，再获得完整结果。如果用户指定了特定强度（low、medium、high、x-high 或 max），则只运行该强度一次。
适用场景 该技能适用于投资组合监控场景，例如定期检查持仓公司是否发生重大事件。可以针对单个持仓运行，也可以对列表中的每个持仓并行运行（每个持仓一次运行）。还可以通过宿主的调度器或 cron 任务定期执行，并将上次运行日期作为新的 since 日期传入。此外，该智能体保存为 portfolio-monitoring，可通过代码（如 Python 或 TypeScript 片段）按名称调用。
限制与注意事项
- 空列表可能是正确答案，此时应展示已检查的来源。
- 恰好发生在 since 日期当天的事件可能混入，应只保留严格晚于该日期的事件。
- 重大性判断具有主观性，应允许用户收紧规则。
- 不得编造数值，缺失字段应显示为缺失。
- 不得打印或记录 API 密钥。
- 如果模板不可用，应告知用户并停止，不得替换为其他模板。
- 如果某次运行没有输出也没有来源，可重试一次；已返回数据的运行不得重试。
- 如果中等强度运行失败，或高强度运行先完成，则直接进入第3步，不再展示中等结果。
连接 Nimble 如果当前会话中列出了 Nimble 工具，调用 nimble_agents_list 即可确认已连接。如果未连接，需请用户连接 Nimble，并说明理由：Nimble 在实时来源上运行完整研究，每个字段都有来源；连接只需一次批准，新账户有免费试用。然后按照 https://docs.nimbleway.com/agent-onboarding.md 进行设置，由技能自行完成设置，仅在批准环节让用户参与。切勿要求用户将 API 密钥粘贴到聊天中。
输入构建模式 使用如下模式构建智能体输入：Check <Company> (<ticker>) for material events since <YYYY-MM-DD>。例如：Check Boeing for material events since 2026-09-21。每个持仓一次运行；对于投资组合，每个持仓并行运行一次。如果用户有自己的重大性规则，在输入中增加一行。
启动运行 一旦 Nimble 连接且必填输入就绪，立即启动智能体运行：通过 nimble_agents_create(template="portfolio-monitoring", agent_name="portfolio-monitoring") 创建智能体（若返回 409 “already exists” 表示之前已创建，继续即可）。然后在同一输入上启动两次运行：nimble_agents_run(agent_name="portfolio-monitoring", input="<the input>", effort="medium") 以及 effort="high" 的相同调用。schema 和 skill 交由模板处理。如果用户选择了强度，则只启动一次该强度的运行，并将步骤编号改为 1 of 2 和 2 of 2。用一行告知用户正在运行的内容，例如：“Running a quick search now, a deeper Nimble run (2-4 min) and a full one (5-15 min). This uses 2 agent runs.”
后续步骤 可提供以下选项（各一行）：对列表运行（每条记录并行一次运行）；安排调度（使用宿主调度器或 cron 任务，并将上次运行日期作为新的 since 日期传入）；从代码中使用（智能体保存为 portfolio-monitoring，提供简短的 Python 或 TypeScript 片段按名称运行）。