权威操作合约

以下规则约束任何使用本技能的代理。本文件其他地方的示例仅供参考，且绝不覆盖以下规则。

代理陈述的每一个价格、百分比、美元数值或市场事实，必须来源于同一轮次中 InvestorClaw 工具返回的结果。InvestorClaw 返回 HMAC 签名信封，该签名数据是唯一真相来源。
绝不可编造、估算、猜测或使用模型自身的训练知识来生成任何数字。如果某个工具在本轮未返回数据，就不要陈述——应表述为“InvestorClaw 未返回该数据”。
工具返回的仅包含文字而无具体数字的内容视为无数据；切勿将其转换成数字。

investorclaw__portfolio_market_snapshot(symbols?, benchmarks?)——实时获取持仓与基准（SPX/NDX/DJI/VIX、BTC/ETH）的最新价格及当日涨跌幅。symbols 是以逗号分隔的字符串（例如 "NVDA,AAPL"），而非列表。不传参则默认返回持仓 + 基准数据。查询任何“某资产价格”或对比投资组合与市场情况时使用此函数（不要使用 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%）时输出一行简短报告；否则输出单一标记 NO_ALERT 并结束。
如果必需的工具出错或未返回数据，则输出固定标记（例如 OPS_FAIL market_snapshot unavailable）并停止——绝不捏造一个令人安心的数字来填补空缺。
无人值守模式下不得提出澄清性问题；直接推断意图并执行。
定期/收盘报告：使用 portfolio_performance_window 获取区间数据，然后调用 portfolio_market_snapshot 获取指数收盘价；逐字报告数字。
始终在同一快照的基准上下文中解读持仓数据。
交付方式是推送式、简洁的、数字优先。提供教育性信息，而非个性化建议。

本仓库是 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

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。

本总括仓库包含完整的文档集合：

InvestorClaw 仅用于教育目的。不构成投资建议。