権威ある運用契約(Authoritative Operating Contract)
このスキルを使用するすべてのエージェントは、以下のルールに従わなければなりません。このファイル内のその他の例は、あくまで参考であり、決してこれらのルールを上書きしません。
データの完全性 — InvestorClawが唯一の信頼できる情報源であること
- エージェントが提示するすべての価格、パーセンテージ、金額、市場事実は、同一ターン内のInvestorClawツール結果から取得しなければなりません。InvestorClawはHMAC署名付きエンベロープを返します。その署名済みデータが唯一の信頼できる情報源です。
- いかなる数値についても、発明、推定、推測、またはモデル自身の学習知識を使用してはなりません。ツールがこのターンにデータを返さなかった場合、その数値を述べてはならず、「InvestorClawはそのデータを返しませんでした」と言わなければなりません。
- 具体的な数値を含まないツールの散文は「データなし」を意味します。それを数値に変換してはなりません。
現在のツールインターフェース(アンダースコア名前空間)
investorclaw__portfolio_market_snapshot(symbols?, benchmarks?)— 保有銘柄とベンチマーク(SPX/NDX/DJI/VIX、BTC/ETH)のリアルタイム価格 + 日中変動率。symbolsはカンマ区切り文字列(例: "NVDA,AAPL")であり、リストではありません。引数なし = 保有銘柄 + ベンチマーク。"Xの価格" を聞かれたとき、および市場と比較してポートフォリオを読み取るためには、このツール(portfolio_askではなく)を使用します。investorclaw__portfolio_performance_window(period=...)— 指定期間のリターン / 損益 / 騰落銘柄。period: 1d, 1w, 1mo, 1y, 5y, 10y, 20y, max、または自然言語フレーズ("today", "last week", "last year", "entire history")。investorclaw__portfolio_ask(question=...)— 分析 / 説明。
古い investorclaw.* ドット名前空間の以下の例は古くなっています。上記のアンダースコア形式が現在のツール名です。
自律的 / 常時稼働監視エージェント
無人エージェント(スケジュール型モニターおよびアラート通知エージェント、例:MarketWatchエージェント)については、上記の契約に加えて以下を遵守します。
- 各実行は最初にツール呼び出しから開始します。メモリから市場の質問に答えてはいけません。スケジュールされた「ポーリング」は
portfolio_market_snapshotを呼び出すことを意味します。 - 閾値スキャン:
portfolio_market_snapshotを呼び出し、次に、保有銘柄またはベンチマークが設定された変動(例:保有銘柄±3%、VIX±10%)を超えた場合にのみ、1行のみの簡潔なメッセージを出力します。超えない場合は、単一のNO_ALERTトークンを出力して停止します。 - 必要なツールがエラーを返した場合、またはデータを返さなかった場合は、
OPS_FAIL market_snapshot unavailableのような固定マーカーを出力して停止します。ギャップを埋めるために安心させるような数値を捏造してはいけません。 - 無人モードでは明確化の質問はせず、意図をマッピングして行動します。
- 定期的 / 営業時間終了時(EOD)レポート:先に
portfolio_performance_windowをその期間分呼び出し、次にportfolio_market_snapshotでインデックス終値を取得し、数値をそのまま報告します。 - 常に、同一スナップショット内のベンチマークとの関連で保有銘柄を読み取ります。
- 配信はプッシュ、簡潔、数値優先です。教育的であり、個別のアドバイスではありません。
InvestorClaw は何をしますか?
このリポジトリはInvestorClawの統括プロジェクトです — README、ライセンス、回帰テストハーネス、そして公開インターフェースを含みます。ClawHubが公開するエージェント可読なSKILL.mdは、ランタイムリポジトリにあります。
- Docker化されたv4.xランタイム + ClawHub公開SKILL.md:
mnemos-os/mnemos-ic-runtime - Claude Code / Claude Desktopプラグイン(コンテナ優先、このリポジトリ):
/plugin marketplace add argonautsystems/InvestorClaw— 他のランタイムと同じスキル + コンテナです。詳細は docs/GETTING_STARTED.md を参照してください。 - エンジンソース(Pythonアナライザー):
argonautsystems/ic-engine
インストール(v4.x Docker化ランタイム)
git clone https://github.com/mnemos-os/mnemos-ic-runtime.git ~/.investorclaw
cd ~/.investorclaw
mkdir -p portfolios
docker compose up -d
このcomposeは `ghcr.io/argonautsystems/ic-engine:4.7.7-cpu`(公開ホスト、認証不要)をプルし、`localhost:18090`(MCP + REST)および`localhost:18092`(ダッシュボード)で実行します。
完全なエージェント可読仕様(12ツールカタログ、初回実行タイムライン、ランタイム別設定ブロック、トラブルシューティング)については、公開されているランタイムリポジトリのSKILL.mdを参照してください。
ドキュメント
この統括リポジトリには、包括的なドキュメントセットが含まれています。
- README.md — 機能、クイックスタート、モデル + APIキーの推奨事項
- STONKMODE.md — ナレーション付きコメンタリーモード
- CAPABILITIES.md — 全機能カタログ
- PRIVACY.md — データ取り扱いポリシー
- DISCLAIMER.md — 教育目的の利用に関する免責事項
- SECURITY.md — 脆弱性情報開示
- CHANGELOG.md — リリース履歴
- docs/ — EODレポート、用語集、哲学、インストールモデル、COBOLテスト、MCPツールリファレンス、Stonkmodeアーキテクチャ + アバター凡例、Windowsセットアップガイド
- docs/references/ — 入力 / 出力 / スキーマ / コンサルティングLLM契約
ライセンス
- この統括リポジトリ:Apache 2.0(実質的なコード)+ MIT-0(SKILL.md、エージェントスキル成果物)。
- ファイルごとのSPDX-License-Identifierヘッダーが該当するライセンスを示します。
InvestorClawは教育目的のみです。財務アドバイスではありません。