Risk Guard 风控守卫
在交易执行前提供硬性风控否决:校验信号、限制回撤、拦截不安全仓位,是 AIMM 对冲基金系统的最后一道安全闸门。
risk_guard 被定位为执行前的硬性风险否决门,无对外发送、无凭据访问、默认阻断加仓,安全意图清晰;但 SKILL.md 与 persona.md 未说明数据流最小化、异常时的降级行为、回滚/恢复路径及用户确认机制,扣分至此。
接口签名、查询参数与 JSON 输出结构定义自洽,仓库有 CI(ruff + pytest)与测试夹具,但未见针对 risk_guard 关键路径的具体测试,错误反馈与边界行为仅在 persona 中概述,静态审阅不给超过 10 分。
场景明确(交易信号风控把关)、触发条件与上下游位置(Policy Orchestrator 之后、执行之前)写明,输出格式给出;但非适用边界、输入校验细节及中文/网络可达性完全未讨论。
SKILL.md 简洁可读,依赖项列明,AGPL-3.0 许可明确,SECURITY.md 提供漏洞报告渠道;但该技能无版本号、无变更记录、无私有已知限制披露,仓库未展示维护者身份与更新承诺。
风控否决的门控设计有真实边际价值(README 声称硬否决),输出 schema 可直接消费;但静态审阅无法验证查询接口与 validate() 是否按声明工作,收益声明(回测数字)不可作为本技能证据。
仓库含 CI 工作流与 pytest 测试套件、可复现数据带 sha256 清单,属可审计的一手材料;但风险门控本身无测试覆盖证据,宣称结果无第三方佐证,静态审阅上限为 5。
- 该技能文件仅为接口说明,无实现代码或针对性测试证据,风控逻辑是否真正生效未经执行验证。
- 风控门控会阻断交易决策,但其失败模式(如依赖缺失、状态不可用时默认放行还是拒绝)未定义,使用前必须自行确认。
- 发布者身份未经核实;涉及真实资金场景时切勿依赖未经测试的风控声明。
- 核心功能依赖海外 LLM API(OpenAI/AtlasCloud)与 Binance Testnet,中国大陆网络可达性未验证。
- 未针对该技能提供中文文档与版本/变更记录,升级兼容性无保证。
这个 Skill 能做什么,适合哪些场景?
Risk Guard 是 AI Market Maker(AIMM)多智能体交易系统中的一个治理型技能,位于 src/agents/governance/risk_guard/。它作为执行前的硬性否决层:任何交易信号必须通过 validate(signal, portfolio_state) 的风控门检查,才能进入执行环节。它从 portfolio_management 读取组合状态、从 config/fund_policy.py 读取基金级风控限额、从执行引擎获取实时盈亏(PnL)。该技能随整个 AIMM 仓库以 AGPL-3.0 协议开源,依赖仓库的 Python 运行时与相关代理模块。
它读取当前组合状态(来自 portfolio_management)、基金级风控政策(config/fund_policy.py)和执行引擎的实时 PnL;对拟议交易调用 validate(signal, portfolio_state) 生成风控门结果;支持直接问答,例如'我当前回撤是多少?''现在开一个新的 BTC 多单安全吗?';通过 /risk_guard?ticker=BTC/USDT&side=long&size=0.5 这样的查询接口返回 approved/blocked 判定及每个风控门的逐项标志。
- 运行 AIMM 的量化交易者在信号生成后、执行前自动拦截超出基金风控限额的交易
- 实时监控多资产组合回撤,在回撤触及政策红线时阻止新开仓
- 交易前快速核查某笔具体仓位(如 0.5 规模的 BTC/USDT 多单)是否通过各项风控门
- 把风控否决作为强制治理点接入基于 LangGraph 的多代理交易工作流
这个 Skill 有哪些优点和局限?
- 拥有最终否决权,而非仅记录日志——README 明确强调这是真实的风控治理
- 输入来源清晰:组合状态、基金政策文件、实时 PnL,可追溯
- 查询接口返回逐项风控门标志,判定透明可审计
- 随完整开源系统提供,带回测与测试套件,可在 Binance Testnet 上纸面验证
- 不能脱离 AIMM 仓库独立使用,依赖 portfolio_management 与 fund_policy 等内部模块
- SKILL.md 未说明具体有哪些风控门或阈值逻辑,默认参数是否保守无从验证
- 主要面向加密货币(Binance Testnet);Futu 股票适配器是否接入 Risk Guard 未在文档中说明
- 采用 AGPL-3.0,若作为网络服务运行需履行开源义务
如何安装这个 Skill?
Risk Guard 不是独立安装的技能,而是随整个 AIMM 仓库提供:git clone https://github.com/olaxbt/ai-market-maker.git && cd ai-market-maker;pip install uv;先安装 TA-Lib C 库(推荐 conda install -y ta-lib -c conda-forge);再运行 uv sync --extra dev 和 uv run pre-commit install;配置 .env(Binance Testnet 与 OpenAI 密钥)。若通过 OpenClaw 使用,可运行 claw install https://github.com/olaxbt/ai-market-maker。该技能位于 src/agents/governance/risk_guard/。
如何使用这个 Skill?
在 AIMM 工作流中,信号经组合管理后自动传入 Risk Guard,只有通过才执行。也可通过查询接口直接访问:/risk_guard?ticker=BTC/USDT&side=long&size=0.5,返回 approved/blocked 及逐门标志。或用自然语言直接提问:'What's my current drawdown?' 或 'Is it safe to open a new BTC position?'。风控限额在 config/fund_policy.py 中配置。
这个 Skill 与同类方案有什么区别?
README 将本项目的 Risk Guard 与'仅做日志记录'的风控方案对比,强调其硬性否决权;未指名具体第三方竞品。