kanchi-dividend-review-monitor

Kanchi 股息审查监控

概述

检测异常股息风险信号，并将其转入人工审查队列。 将自动化视为异常检测，而非自动交易执行。

适用场景

当用户需要以下功能时，使用此技能：

• 对股息持仓进行每日／每周／每季度异常检测。
• 对 T1-T5 风险触发项强制加入审查队列。
• 针对投资组合代码扫描与 8-K／治理相关的关键词。
• 在人工决策前生成确定性的 OK/WARN/REVIEW 输出。

前置条件

提供符合以下要求的规范化输入 JSON：

• references/input-schema.md

如果上游数据不可用，至少提供：

• ticker
• instrument_type
• dividend.latest_regular
• dividend.prior_regular

不可妥协的规则

绝不能仅根据机器触发项自动卖出。 始终先生成 WARN 或 REVIEW 证据，供人工确认。

状态机

• OK：无需操作。
• WARN：加入下一轮检查，并暂停可选加仓。
• REVIEW：立即创建人工审查工单，并暂停加仓。

触发阈值和操作请参阅 references/trigger-matrix.md。

股息金额持平的频率说明

当 T6 仅由 freeze_flag／最新常规股息等于上一期常规股息触发时，应将其视为用于确认发放频率的 WARN，而非股息恶化的证据。许多季度派息的公司会在年度加息周期之间连续几个季度维持相同股息金额。在报告中，应表述为“确认下一次股息增长的节奏／检查前暂停可选加仓”，除非 T1/T2/T3/T4/T5 证据也支持升级，否则不要暗示股息削减或投资逻辑失效。

监控频率

• 每日：
  • T1 股息削减／暂停。
  • T4 SEC 文件关键词扫描（侧重 8-K）。
• 每周：
  • T3 代理信用压力检查。
• 每季度：
  • T2 覆盖率恶化和 T5 结构性下滑评分。

工作流

1）规范化输入数据集

在一个 JSON 文档中收集每个代码的字段：

• 股息数据点（最新常规股息、上一期常规股息、缺失／零值标记）。
• 覆盖率字段（FCF 或 FFO 或 NII、已支付股息、比率历史）。
• 资产负债表趋势字段（净债务、利息覆盖率、回购／股息）。
• 文件文本片段（尤其是近期 8-K 或同等警报文本）。
• 运营趋势字段（营收 CAGR、利润率趋势、指引趋势）。

字段定义和示例载荷请参阅 references/input-schema.md 。

2）运行规则引擎

运行：

python3 skills/kanchi-dividend-review-monitor/scripts/build_review_queue.py \
  --input /path/to/monitor_input.json \
  --output-dir reports/

脚本根据 T1-T5 将每个代码映射为 OK/WARN/REVIEW。 输出文件将保存到指定目录，并使用带日期的文件名（例如 review_queue_20260227.json 和 .md）。

3）确定优先级并去重

如果触发多个项目：

• 保留所有发现，以便审计追踪。
• 仅将最终状态升级到最高严重级别。
• 将触发原因保存为单行证据。

4）生成人工审查工单

对于每个 REVIEW 代码，包含：

• 触发项 ID 和证据。
• 疑似失效模式。
• 下一步决策所需的人工检查项。

请使用 references/review-ticket-template.md 的输出格式。

SEC 文件防护措施

实现实时 SEC 数据获取器时：

• 包含合规的 User-Agent 字符串（名称 + 电子邮件）。
• 使用缓存和限流。
• 遵守 SEC 公平访问指南。
• 在预定的投资组合审查中，如果上游文件片段为空，则使用 SEC company_tickers.json 和 https://data.sec.gov/submissions/CIK##########.json 列出每项持仓近期的 8-K／8-K/A 文件，然后扫描主要文件，查找 T4 关键词系列（Item 4.02、不应依赖、重述、重大缺陷、SEC 调查、传票、持续经营、审计师辞任、内部控制）。记录扫描时间范围、近期 8-K 数量，以及是否发现命中。将“未命中关键词”视为范围有限的 T4 扫描结果，而非全面的治理审查结论。

输出约定

始终返回：

1. 包含汇总计数和代码级发现的队列 JSON。
2. 用于快速分诊的 Markdown 仪表板。
3. 需要立即处理的 REVIEW 工单列表。

多技能交接

• 从 kanchi-dividend-sop 获取股票代码列表和基准假设。
• 将 REVIEW 结果反馈给 kanchi-dividend-sop，以便重新承保并审查持仓规模。
• 当风险事件意味着需要决定是否迁移账户时，与 kanchi-dividend-us-tax-accounting 共享账户类型背景信息。

资源

• scripts/build_review_queue.py：用于 T1-T5 的本地规则引擎。
• scripts/tests/test_build_review_queue.py：用于 T1-T5 和报告渲染的单元测试。
• references/trigger-matrix.md：触发条件定义、频率和操作。
• references/input-schema.md：规范化输入模式和示例 JSON。
• references/review-ticket-template.md：标准化的人工审查工单布局。