kanchi-dividend-review-monitor

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Kanchi Dividend Review Monitor

Kanchi 股息审查监控器

Overview

概述

Detect abnormal dividend-risk signals and route them into a human review queue. Treat automation as anomaly detection, not automated trade execution.
检测异常的股息风险信号,并将其导入人工审查队列。将自动化视为异常检测工具,而非自动交易执行工具。

When to Use

使用场景

Use this skill when the user needs:
  • Daily/weekly/quarterly anomaly detection for dividend holdings.
  • Forced review queueing for T1-T5 risk triggers.
  • 8-K/governance keyword scans tied to portfolio tickers.
  • Deterministic
    OK/WARN/REVIEW
    output before manual decision making.
当用户有以下需求时,可使用本Skill:
  • 对股息持仓进行每日/每周/季度异常检测。
  • 针对T1-T5风险触发器强制生成审查队列。
  • 针对投资组合代码进行8-K/治理关键词扫描。
  • 在人工决策前输出确定性的
    OK/WARN/REVIEW
    状态。

Prerequisites

前置条件

Provide normalized input JSON that follows:
  • skills/kanchi-dividend-review-monitor/references/input-schema.md
If upstream data is unavailable, provide at least:
  • ticker
  • instrument_type
  • dividend.latest_regular
  • dividend.prior_regular
提供符合以下规范的标准化输入JSON:
  • skills/kanchi-dividend-review-monitor/references/input-schema.md
若上游数据不可用,至少需提供:
  • ticker
  • instrument_type
  • dividend.latest_regular
  • dividend.prior_regular

Non-Negotiable Rule

不可违反的规则

Never auto-sell based only on machine triggers. Always create
WARN
or
REVIEW
evidence for human confirmation first.
绝不能仅基于机器触发器执行自动卖出操作。必须先生成
WARN
REVIEW
的相关证据,再由人工确认。

State Machine

状态机

  • OK
    : no action.
  • WARN
    : add to next check cycle and pause optional adds.
  • REVIEW
    : immediate human review ticket + pause adds.
Use
skills/kanchi-dividend-review-monitor/references/trigger-matrix.md
for trigger thresholds and actions.
  • OK
    :无需操作。
  • WARN
    :加入下一次检查周期,并暂停可选的新增持仓操作。
  • REVIEW
    :立即生成人工审查工单 + 暂停新增持仓操作。
请参考
skills/kanchi-dividend-review-monitor/references/trigger-matrix.md
获取触发阈值及对应操作。

Monitoring Cadence

监控周期

  • Daily:
    • T1 dividend cut/suspension.
    • T4 SEC filing keyword scan (8-K oriented).
  • Weekly:
    • T3 proxy credit stress checks.
  • Quarterly:
    • T2 coverage deterioration and T5 structural decline scoring.
  • 每日:
    • T1:股息削减/暂停。
    • T4:SEC文件关键词扫描(以8-K为主)。
  • 每周:
    • T3:代理信用压力测试。
  • 季度:
    • T2:股息覆盖率恶化检测,T5:结构性衰退评分。

Workflow

工作流

1) Normalize input dataset

1) 标准化输入数据集

Collect per ticker fields in one JSON document:
  • Dividend points (latest regular, prior regular, missing/zero flag).
  • Coverage fields (FCF or FFO or NII, dividends paid, ratio history).
  • Balance-sheet trend fields (net debt, interest coverage, buybacks/dividends).
  • Filing text snippets (especially recent 8-K or equivalent alert text).
  • Operations trend fields (revenue CAGR, margin trend, guidance trend).
Use
skills/kanchi-dividend-review-monitor/references/input-schema.md
for field definitions and sample payload.
收集每支股票代码对应的字段,整合至一个JSON文档中:
  • 股息相关字段(最新常规股息、上期常规股息、缺失/零值标记)。
  • 覆盖率字段(FCF、FFO或NII,已支付股息,比率历史)。
  • 资产负债表趋势字段(净债务、利息覆盖率、回购/股息)。
  • 文件文本片段(尤其是近期8-K或同类预警文本)。
  • 运营趋势字段(收入复合年增长率、利润率趋势、业绩指引趋势)。
请参考
skills/kanchi-dividend-review-monitor/references/input-schema.md
获取字段定义及示例负载。

2) Run the rule engine

2) 运行规则引擎

Run:
bash
python3 skills/kanchi-dividend-review-monitor/scripts/build_review_queue.py \
  --input /path/to/monitor_input.json \
  --output /path/to/review_queue.json \
  --markdown /path/to/review_queue.md
The script maps each ticker to
OK/WARN/REVIEW
based on T1-T5.
执行以下命令:
bash
python3 skills/kanchi-dividend-review-monitor/scripts/build_review_queue.py \
  --input /path/to/monitor_input.json \
  --output /path/to/review_queue.json \
  --markdown /path/to/review_queue.md
该脚本会根据T1-T5触发器将每支股票代码映射至
OK/WARN/REVIEW
状态。

3) Prioritize and deduplicate

3) 优先级排序与去重

If multiple triggers fire:
  • Keep all findings for audit trail.
  • Escalate final state to highest severity only.
  • Store trigger reasons as single-line evidence.
若多个触发器被触发:
  • 保留所有检测结果,用于审计追踪。
  • 仅将最终状态升级至最高严重级别。
  • 将触发原因存储为单行证据。

4) Generate human review tickets

4) 生成人工审查工单

For each
REVIEW
ticker, include:
  • Trigger IDs and evidence.
  • Suspected failure mode.
  • Required manual checks for next decision.
Use
skills/kanchi-dividend-review-monitor/references/review-ticket-template.md
output format.
对于每一个标记为
REVIEW
的股票代码,需包含:
  • 触发器ID及证据。
  • 疑似故障模式。
  • 后续决策所需的人工检查项。
请使用
skills/kanchi-dividend-review-monitor/references/review-ticket-template.md
定义的输出格式。

SEC Filing Guardrail

SEC文件防护规则

When implementing live SEC fetchers:
  • Include a compliant
    User-Agent
    string (name + email).
  • Use caching and throttling.
  • Respect SEC fair-access guidance.
当部署实时SEC数据抓取工具时:
  • 需包含合规的
    User-Agent
    字符串(名称 + 邮箱)。
  • 使用缓存和流量限制机制。
  • 遵守SEC公平访问指南。

Output Contract

输出约定

Always return:
  1. Queue JSON with summary counts and ticker-level findings.
  2. Markdown dashboard for quick triage.
  3. List of immediate
    REVIEW
    tickets.
必须返回以下内容:
  1. 包含汇总统计及单股票代码检测结果的队列JSON。
  2. 用于快速分类的Markdown仪表盘。
  3. 即时
    REVIEW
    工单列表。

Multi-Skill Handoff

多Skill协作

  • Consume ticker universe and baseline assumptions from
    kanchi-dividend-sop
    .
  • Feed
    REVIEW
    results back to
    kanchi-dividend-sop
    for re-underwriting and position-size review.
  • Share account-type context with
    kanchi-dividend-us-tax-accounting
    when risk events imply account relocation decisions.
  • kanchi-dividend-sop
    获取股票代码范围及基线假设。
  • REVIEW
    结果反馈至
    kanchi-dividend-sop
    ,以便重新进行风险评估及持仓规模审查。
  • 当风险事件涉及账户迁移决策时,与
    kanchi-dividend-us-tax-accounting
    共享账户类型上下文信息。

Resources

资源

  • scripts/build_review_queue.py
    : local rule engine for T1-T5.
  • scripts/tests/test_build_review_queue.py
    : unit tests for T1-T5 and report rendering.
  • skills/kanchi-dividend-review-monitor/references/trigger-matrix.md
    : trigger definitions, cadence, and actions.
  • skills/kanchi-dividend-review-monitor/references/input-schema.md
    : normalized input schema and sample JSON.
  • skills/kanchi-dividend-review-monitor/references/review-ticket-template.md
    : standardized manual-review ticket layout.
  • scripts/build_review_queue.py
    :用于T1-T5触发器的本地规则引擎。
  • scripts/tests/test_build_review_queue.py
    :针对T1-T5触发器及报告渲染的单元测试。
  • skills/kanchi-dividend-review-monitor/references/trigger-matrix.md
    :触发器定义、监控周期及对应操作。
  • skills/kanchi-dividend-review-monitor/references/input-schema.md
    :标准化输入 schema 及示例JSON。
  • skills/kanchi-dividend-review-monitor/references/review-ticket-template.md
    :标准化人工审查工单模板。