json-firs-fnnc-cli-patt

用途：评估外部金融/交易/paper trading CLI，为ict-engine、Hermes等系统设计json-first适配器、稳定错误分类与paper优先的流程；不适用于直接下真实单或盲信README接入实时交易。核心原则：先安全审查再看功能，默认只吸收agent contract而不吸收live execution。重点抽取JSON-first subprocess契约（stdout仅结构化payload、stderr仅诊断、退出码表达成败，如somecli <command> ... -o json 2>/dev/null）、稳定错误类别（api、auth、network、rate_limit、validation、config、io、parse，路由看category不看文案，retry仅限明确可重试类）、paper-first流程（有实时与模拟双面时默认先paper，live路径需额外确认与权限隔离）、机器可读工具契约（tool-catalog.json、error-catalog.json、CONTEXT.md、AGENTS.md、CLAUDE.md，用于参数schema、危险flag、认证要求、输出契约、重试指引）、以及已打包的多步工作流skill/recipe边界。落地建议：统一外部market-data/exchange适配器的JSON envelope与错误分类，让paper/backtest/sim与未来live路径对称，把常见研究流打包为skills/prompts，未来工具目录做成机器可读catalog。不建议默认吸收：live order execution、提现/转账/质押、共享MCP交易服务、任何未经用户明确批准的危险命令。评估模板：Verdict取learn/absorb/install/reject。可触真实资金、账户、提现、杠杆的工具视为高风险。产物可为repo文档note与架构边界规则，实际live集成仅在用户明确要求时进行。