个人财务 Skill(AI 个人 CFO)
将银行、券商、税务、市场情报和社交情绪统一到一套 75 个工具的技能里,用确定性计算替代 AI 猜数字,管理你的全部个人财务。
加分项:SKILL.md 声明强制 finance_policy_check 前置、实盘需显式确认、禁止暴露密钥、默认 paper 环境、风险分级清晰。扣分项:策略引擎的实际执行代码未在证据中出现,仅是文档承诺;处理高度敏感的银行/券商/税务数据但无数据加密、留存与回滚说明;onboard.sh 需要用户执行未审计脚本;发布者未验证。
加分项:仓库包含 alpaca-trading 与 finance-core 的真实 vitest 测试文件,覆盖订单确认、限额、幂等存储、归一化等关键路径,错误信息具体。扣分项:静态评审不可执行,最大扩展 tax-engine(23 个工具)无测试证据;612 通过的声称无法核实;异常与失败反馈仅部分可见。
加分项:触发场景(When to Use)与 9 个工作流明确,工具目录结构清晰,可按需部分启用扩展。扣分项:未声明不适配边界;全部核心功能依赖 Plaid/Alpaca/IBKR/Finnhub/X 等海外服务,无中文支持,对中国大陆网络可达性构成实质障碍,需在此披露并扣分。
加分项:MIT 许可、版本号 2.0.0、分层文档(SKILL.md → references/ → api-*.md)、安装脚本、CLAUDE.md 开发者指引。扣分项:无 CHANGELOG、无明确维护责任人与更新路径、作者仅为 contributors、版本治理不完整。
加分项:设计目标明确(确定性计算、策略门控、快照存储),工作流可直接映射到用户任务,具有相对手工操作的边际价值。扣分项:静态评审无法验证输出正确性与可直接使用性;税务计算准确性(对正确性要求极高的领域)无独立证据;部分价值依赖多个付费 API 凭证,成本效益未论证。
加分项:仓库内有可审计的测试源码作为一手材料,README 声明 612 个测试且给出运行命令。扣分项:无可见 CI 工作流证据,测试通过状态不可独立复现,覆盖范围声称(55+ 文件)无法核对,营销性声明(40+ agents 兼容)无证据支持。
- 本评估为纯静态源码评审,未执行任何代码,所有分数置信度低。
- 策略引擎与审批门控仅见于文档,实际执行代码未在本次证据中,实盘交易风险需用户自行验证。
- 核心功能完全依赖 Plaid、Alpaca、IBKR、Finnhub、X 等海外服务,中国大陆网络可达性存在实质障碍,且无中文支持。
- 处理银行、券商与税务等高敏感数据,加密、留存与回滚机制未披露。
- onboard.sh 会在本机构建并注册插件,使用前应审计该脚本。
- 税务计算类工具(税负、TLH、AMT 等)准确性未经独立验证,税务决策务必咨询专业顾问。
- 无 CHANGELOG 与明确维护责任人,长期维护状态不明。
这个 Skill 能做什么,适合哪些场景?
这是一个面向 Agent Skills 协议的个人财务管理技能,包含 7 个扩展、75 个工具,版本 2.0.0,MIT 许可。它通过 Plaid 聚合银行账户,通过 Alpaca 执行交易,通过 IBKR 监控持仓,并内置覆盖 15 种 IRS 表格解析器和 8 个计算器的税务引擎。所有金额计算都由工具完成而非 LLM 心算,任何交易或税务操作前必须通过策略检查和审批闸门。仓库声称有 612 个测试全部通过,但依赖大量第三方 API 密钥,使用成本和配置复杂度较高。
调用 Plaid API 拉取账户余额、交易、投资和负债并归一化存储快照;调用 Alpaca 下单/撤单、查询持仓和市场数据(实盘需人工确认);通过 IBKR Client Portal 读取持仓、配置和净值曲线;运行税务引擎:解析 W-2、1099-B/DIV/INT、K-1、1040 及附表 A-E/SE、8949、6251,计算税负、寻找税损收割候选、校验洗售规则、比较 FIFO/LIFO/指定批次、估算季度预缴,并支持 CA/NY/NJ/IL/PA/MA/TX/FL 八州税和 AMT;从 Finnhub、SEC EDGAR、FRED、BLS、Alpha Vantage 获取新闻、财报、分析师评级和宏观经济序列;从 StockTwits、X 和 Quiver 获取社交情绪与国会议员交易记录;执行异常检测(异常交易、余额骤降、重复扣款)、订阅追踪、净资产/现金流汇总,并支持 openclaw cron 定时扫描和周报生成。
- 有多个银行和券商账户的个人,想通过自然语言查看合并净资产和每月现金流
- 美股投资者想在年底前寻找税损收割机会,同时自动校验洗售规则和批次选择
- 有 W-2、1099 和 K-1 等多份税表的纳税人,想让 AI 解析表格并估算季度预缴税
- 多券商持仓者(Alpaca + IBKR)想监控配置漂移并在偏离目标时收到警报
- 量化爱好者想结合 SEC 文件、公司新闻、StockTwits 情绪和国会议员交易披露做个股研究
- 想每天自动扫描异常交易、重复扣款和余额骤降并及时告警的用户
这个 Skill 有哪些优点和局限?
- 覆盖面罕见地广:银行、交易、持仓、税务、市场情报、社交情绪共 75 个工具,一个统一数据模型
- 强制确定性计算,税额、盈亏、净资产不用 LLM 心算,降低幻觉数字风险
- 内置策略引擎和审批闸门,实盘交易必须人工确认,还有 8 条硬性护栏
- 税务引擎深度大:15 个表单解析器加 8 个计算器,含 AMT、八州州税和洗售校验
- 仓库声称 612 个测试通过,且提供详尽的 references/ 文档
- 需要最多 9 种第三方 API 密钥,多数服务有付费额度,实际使用成本不低
- 定时任务和插件注册绑定 OpenClaw 运行时,非 OpenClaw 用户需要自行适配 cron
- IBKR 依赖本地 Client Portal Gateway 且需约每分钟心跳(ibkr_tickle),运维负担明显
- 交易类能力仅对接 Alpaca 和 IBKR,不支持其他券商;州税计算仅覆盖 8 个州
- 612 个测试通过仅为 README 自述,未见独立验证;文档中的免责声明明确其输出不构成财务建议
如何安装这个 Skill?
克隆仓库后运行一键引导脚本:git clone https://github.com/6missedcalls/personal-finance-skill.git && cd personal-finance-skill && ./scripts/onboard.sh。脚本会安装依赖、构建 7 个扩展、将每个扩展注册为 OpenClaw 插件(openclaw plugins install -l),并把技能符号链接到 ~/.openclaw/skills/。也可用 npx skills add <owner>/personal-finance-skill 安装(支持 -a claude-code -a cursor -a codex 指定 agent)。之后按需导出 API 密钥环境变量(PLAID_CLIENT_ID/SECRET、ALPACA_API_KEY/SECRET、IBKR_BASE_URL、FINNHUB_API_KEY、FRED_API_KEY 等,不需要全部)。除 OpenClaw 路径外,其他 agent 的具体安装细节源材料未完整说明。
如何使用这个 Skill?
启动后通过自然语言触发,例如:"帮我算当前净资产和本月储蓄率"、"找出我持仓里的税损收割机会并检查洗售风险"、"解析我的 1099-B 并估算今年税负"。也可配置定时任务,例如每周简报:openclaw cron add --name "Finance Weekly Brief" --cron "0 8 * * 1" --message "同步所有数据源,计算净资产变化,生成简报"。任何下单、转账或税务操作都会先经过 finance_policy_check;Alpaca 默认可用 paper 模式(ALPACA_ENV=paper)。
这个 Skill 与同类方案有什么区别?
README 将本技能与"大多数会编造数字的 AI 财务工具"作对比,卖点是无 LLM 心算和强制策略检查;此外它通过 Agent Skills 协议声称兼容 40+ AI agent(Claude Code、Cursor、Codex、Windsurf 等),这是相对单一平台财务插件的差异化点。源材料未提及其他具名竞品。