MAIA 投资分析（Tododeia）
五个AI代理并行研究加密货币、股票、外汇与大宗商品，按风险画像生成双语互动市场报告——仅作教育分析，非投资建议。
正面：只读 SKILL_DIR 与可写缓存目录严格分离、强制教育免责声明、HTML 回退做了 JSON 转义与 XSS 加固、数据仅本地运行、可选 API 密钥为标准环境变量。扣分：README 推荐 curl|bash 一键安装（供应链风险且未经用户审查）、仪表盘无鉴权、依赖大量外部网络抓取（CoinGecko/Yahoo/Frankfurter），第三方数据完整性依赖运行时且无签名/校验，权限最小化在安装脚本上未完全体现。
正面：工作流步骤明确、日期统一捕获、回退梯子（主端点→备用→搜索→null）、部分失败规则、JSON 重试与损坏历史处理等错误路径写得很细。扣分：静态审阅无法执行复现关键路径；5 个子代理的实际输出质量依赖模型行为，无已提交的测试套件覆盖这些路径，失败反馈虽好但端到端稳定性未证实，故封顶于 10 之下。
正面：触发短语清单明确、风险画像交互确认、非适用边界（教育用途、非投资建议）声明清楚、Node 缺失时有 HTML 回退。扣分：核心功能完全依赖境外 API（CoinGecko、Yahoo、Frankfurter），在中国大陆网络可达性存疑且未披露应对；无中文支持；触发词偏宽泛（如 investment advice）可能误触发。
正面：MIT 许可、版本号 2.1.0 且 CI 强制 plugin. 与 SKILL.md 版本一致、CHANGELOG 被引用、README 双语且结构清晰、数据契约有 JSON Schema 并在 CI 校验。扣分：未提供 SKILL.md 仓库根路径的版本一致性核对细节（CI 脚本指向 SKILL.md 根路径而技能在子目录，可能存在脚本路径缺陷）、维护责任与更新路径仅依赖个人账号、未见 FAQ/已知问题清单细节。
正面：声称产出直接可用的双语交互报告，含样本数据、模板与 schema，链路设计完整，边际价值明确（自动化多资产研究）。扣分：静态审阅无法验证产出可直接使用；数据准确性依赖免费端点可能滞后；dashboard.png 等截图无法在本审阅中核实；成本（5 代理并行网络抓取）与收益比例未验证。
正面：CI 工作流真实存在，含 lint、build、ajv schema 校验、版本一致性与安装脚本语法检查，属可审计的一手材料。扣分：无针对技能关键路径（代理编排、回退梯子、部分失败规则）的测试；无第三方执行证据；历史准确率自承为本地启发式而非可审计记录；覆盖率薄，封顶于 5 之下。
- 核心数据源（CoinGecko/Yahoo/Frankfurter）在中国大陆网络可能不可达，技能未提供替代端点或本地缓存方案，大陆用户可能整条链路降级为 null。
- README 推荐的 curl | bash 一键安装会以用户权限执行未审查脚本，建议改用手动克隆并阅读 install.sh 后再安装。
- 仪表盘无鉴权，切勿暴露到公网；输出为教育性分析而非投资建议，历史准确率为本地启发式，不可作为业绩依据。
- 静态审阅未执行任何代码：5 代理编排、回退梯子与部分失败规则的实际行为均未经独立复现，首次使用请先小规模试运行并核对数据准确性。
这个 Skill 能做什么，适合哪些场景？
这是为 Claude Code 打造的多代理投资研究技能（v2.1.0），属于 Hainrixz/maia-skill 仓库中的 investment-analysis 技能。它先询问用户的风险偏好（保守/稳健/激进），然后并行派出四个行业研究代理（加密、股票、外汇、大宗商品），再由策略代理做跨行业综合、风险调整排名与组合配置，最终在本地渲染一个英/西双语的 Next.js 交互仪表盘。市场数据优先使用免费免密钥 API（CoinGecko、Yahoo Finance、Frankfurter），可选 Finnhub/Polygon 高级密钥；历史报告保存在本地缓存并做历史准确率追踪。全程强制展示教育免责声明，输出用分析性措辞而非买卖指令。
读取 references/agent-prompts.md 中的五个代理提示词；询问用户风险画像；从 CoinGecko / Yahoo v8 / Frankfurter 免密钥端点抓取价格（失败时按备选端点→WebSearch→null 的降级链），用 WebSearch 补充新闻与社交情绪；四个行业代理并行返回结构化 JSON（数值型数据契约）；策略代理汇总为宏观环境、组合配置、跨行业洞察、风险调整后的推荐；报告数据写入 ~/.claude/cache/tododeia（保留最近30份历史），另由翻译代理生成西班牙语版 report-es.；主路径用 Next.js 在 localhost:3420 提供服务，无 Node.js 时退回独立 HTML 由 Python http.server 在 8420 端口提供。
- 个人投资者每天或每周想获得覆盖加密、股票、外汇、大宗商品的全景市场简报
- 西语用户希望报告内容与界面都能切换英/西双语
- 想按保守/稳健/激进三种风险画像得到不同的配置与选股侧重
- 想追踪此前AI信号的准确率（本地启发式，非审计记录）
- 交易前想快速了解某类资产的社会情绪与关键新闻
- 在无 Node.js 的环境中用 Python 服务独立 HTML 报告
这个 Skill 有哪些优点和局限？
- 四行业代理并行研究 + 策略代理跨行业综合，结构化的数值数据契约并有 CI 验证
- 免密钥即可运行的混合数据源，含确定性降级链，部分行业失败也有明确兜底规则
- 完整的英/西双语：界面与报告数据均可在切换时翻译，数字与代码保持不变
- 安全与隐私考虑较全：CSP、XSS 加固的 HTML 兜底、数据仅存本地缓存、强制教育免责声明
- 可访问性完善（ARIA、键盘导航、reduced-motion），并可自定义代理提示词、风险乘数与样式
- 深度依赖 Claude Code 专属机制（Agent 工具子代理、AskUserQuestion），向其他平台迁移需改写编排逻辑
- 免费公开 API 数据可能滞后，部分品种只能退回搜索估算
- "历史准确率"是本地启发式，不是可审计的业绩记录
- 仪表盘无身份验证，README 明确警告不可暴露到公网
- 来源中没有测试套件或独立性能基准的证据；需要互联网连接，无网时价格全为 null
如何安装这个 Skill？
三种方式任选：1) 一行命令：curl -sL https://raw.githubusercontent.com/Hainrixz/maia-skill/main/install.sh | bash；2) Claude Code 插件：claude plugin install Hainrixz/maia-skill；3) 手动：git clone https://github.com/Hainrixz/maia-skill.git，然后 ln -s "$(pwd)/maia-skill/.claude/skills/investment-analysis" ~/.claude/skills/investment-analysis，并 npm install --prefix maia-skill/dashboard。可选设置 FINNHUB_API_KEY 或 POLYGON_API_KEY 获得更优质股票数据。仓库为 MIT 许可。注意：本仓库打包了2个技能，此处仅针对 investment-analysis 这一个。
如何使用这个 Skill？
在 Claude Code 对话中输入触发语，如 "Run an investment analysis"、"Analyze the markets"、"Run tododeia" 或西班牙语 "analiza mercados"。先回答风险画像问题，五个代理随后工作，报告在 http://localhost:3420 打开；首次打开需确认"教育用途，非投资建议"声明并选择语言。生成的数据写入 ~/.claude/cache/tododeia 而非当前项目目录。可用 /loop 24h /investment-analysis（每日）或 /loop 168h /investment-analysis（每周）安排定期报告。