mcpField
K
kanchi-dividend-review-monitor

kanchi-dividend-review-monitor

github.com/mphinanceデータ・データベース3283 回インストール5 日前に更新
リポジトリ

kanchi-dividend-review-monitor について

Kanchi Dividend Review Monitorは、配当リスクの兆候を検出し、売買を自動実行せずに保有銘柄を人の確認に回すスキルです。正規化された銘柄データにT1〜T5のルールを適用し、判定、根拠、レビュー報告を作成します。

主な機能

  1. 01T1〜T5の条件で配当リスクを評価
  2. 02OK、WARN、REVIEWの状態を割り当て
  3. 03複数の条件を重大度順に集約
  4. 04根拠と人手レビュー用チケットを作成
  5. 05JSONとMarkdownの報告を生成

活用シーン

  1. 01設定した頻度で配当保有銘柄を監視
  2. 02減配やSEC提出書類のキーワードを検出
  3. 03高リスク銘柄の人手レビューを準備
  4. 04同時に発生したアラートを整理・重複排除

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/mphinance/alpha-skills --skill kanchi-dividend-review-monitor

インストール後、Claude Code で/kanchi-dividend-review-monitorを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
agents/
openai.yaml
references/
input-schema.md
review-ticket-template.md
trigger-matrix.md
scripts/
build_review_queue.py
scripts/tests/
conftest.py
test_build_review_queue.py

詳細

Kanchi Dividend Review Monitor

概要

配当リスクに関する異常シグナルを検出し、人によるレビューキューに振り分けます。 自動化は異常検知として扱い、自動取引の実行とはみなしません。

使用する場面

このスキルは、ユーザーが次のことを必要とする場合に使用します:

  • 配当保有銘柄に対する日次/週次/四半期ごとの異常検知。
  • 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 を使用してください。

モニタリングの頻度

  • 日次:
    • T1 配当の減額/停止。
    • T4 SEC 提出書類のキーワードスキャン（8-K 向け）。
  • 週次:
    • T3 プロキシの信用ストレスチェック。
  • 四半期ごと:
    • T2 カバレッジの悪化および T5 構造的衰退のスコアリング。

ワークフロー

1) 入力データセットを正規化する

ティッカーごとのフィールドを 1 つの JSON ドキュメントに収集します:

  • 配当ポイント（最新の regular、直前の regular、欠落/ゼロのフラグ）。
  • カバレッジのフィールド（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) 優先順位付けと重複排除

複数のトリガーが発火した場合:

  • 監査証跡のためにすべての検出結果を保持します。
  • 最終状態は最も高い重大度にのみエスカレーションします。
  • トリガーの理由を 1 行のエビデンスとして保存します。
4) 人によるレビューチケットを生成する

各 REVIEW ティッカーについて、次を含めます:

  • トリガー ID とエビデンス。
  • 疑われる障害モード。
  • 次の意思決定のために必要な手動チェック。

references/review-ticket-template.md の出力形式を使用してください。

SEC 提出書類のガードレール

ライブの SEC フェッチャーを実装する場合:

  • 準拠した User-Agent 文字列（名前 + メールアドレス）を含めます。
  • キャッシュとスロットリングを使用します。
  • SEC のフェアアクセスに関するガイダンスを尊重します。

出力コントラクト

常に次を返します:

  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: 標準化された手動レビューチケットのレイアウト。

コメント

Markdown 対応