资源

与 AI 助手集成

在编程助手中安装 Wealth Reader 官方 skill，让它按照本文档生成组件、callback 和数据更新集成。

什么是 skill

skill 是包含 SKILL.md 文件的文件夹。当任务符合其描述时，AI 助手会加载它。Wealth Reader 在公开仓库 https://github.com/Wealth-Reader/wealthreader-skills 中以 MIT 许可证发布开放的 Agent Skills 格式技能。

wealthreader-integration skill 涵盖：

组件和后端 callback 集成。
原生应用的重定向认证（OAuth）。
使用连接的 token 更新数据以及处理错误。

它不涵盖支付发起或银行连接器开发，也不能代替客户注册：您仍需在客户区配置 api_key、授权域名和 callback URL。

同一个文件夹可用于 Claude Code、Codex、Cursor、Antigravity、Gemini CLI、GitHub Copilot、Grok Build、Windsurf、OpenCode、Amp、Cline、Roo Code、Kiro，以及其他读取 SKILL.md 的 AI 助手。

使用一条命令安装

npx skills add Wealth-Reader/wealthreader-skills

安装程序会检测已安装的助手，并让您选择 skill 的复制位置。也可以使用工具自带的安装程序：

# GitHub CLI
gh skill install Wealth-Reader/wealthreader-skills wealthreader-integration --agent claude-code --scope user

# Gemini CLI
gemini skills install https://github.com/Wealth-Reader/wealthreader-skills.git --consent

# Amp
amp skill add https://github.com/Wealth-Reader/wealthreader-skills --global

手动安装

将仓库中的 skills/wealthreader-integration/ 文件夹复制到助手读取的目录，然后打开新会话。.agents/skills/（项目）和 ~/.agents/skills/（用户）是大多数 AI 助手读取的共享路径。Claude Code、Cline 和 Kiro 仅读取自己的专用目录。

AI 助手	项目目录	用户目录	调用方式
Claude Code	`.claude/skills/`	`~/.claude/skills/`	`/wealthreader-integration` 或自动
Codex (CLI, IDE, ChatGPT)	`.agents/skills/`	`~/.agents/skills/`	`$wealthreader-integration` 或 `/skills`
Cursor	`.agents/skills/` 或 `.cursor/skills/`	`~/.agents/skills/` 或 `~/.cursor/skills/`	选择器 `/` 或自动
Antigravity	`.agents/skills/`	`~/.gemini/config/skills/`	按名称提及 skill
Gemini CLI	`.agents/skills/` 或 `.gemini/skills/`	`~/.agents/skills/` 或 `~/.gemini/skills/`	自动; `/skills list`
GitHub Copilot	`.agents/skills/` 或 `.github/skills/`	`~/.agents/skills/` 或 `~/.copilot/skills/`	自动
Grok Build	`.grok/skills/` (也读取 `.claude/skills/`)	`~/.grok/skills/` 或 `~/.agents/skills/`	`/wealthreader-integration`
Windsurf	`.agents/skills/` 或 `.windsurf/skills/`	`~/.agents/skills/` 或 `~/.codeium/windsurf/skills/`	`@wealthreader-integration`
OpenCode	`.agents/skills/` 或 `.opencode/skills/`	`~/.agents/skills/` 或 `~/.config/opencode/skills/`	自动
Amp	`.agents/skills/`	`~/.agents/skills/` 或 `~/.config/agents/skills/`	自动
Cline	`.cline/skills/` (也读取 `.claude/skills/`)	`~/.cline/skills/`	`/wealthreader-integration`
Roo Code	`.agents/skills/` 或 `.roo/skills/`	`~/.agents/skills/` 或 `~/.roo/skills/`	自动
Kiro	`.kiro/skills/`	`~/.kiro/skills/`	`/wealthreader-integration`

这些路径已于 2026 年 9 月 5 日根据各工具的公开文档核对。最新表格始终位于仓库的 README 中。

使用方法

使用应用所采用的语言和框架提出集成请求。例如：

使用 wealthreader-integration skill，为我的应用添加 Wealth Reader 组件和后端 callback。获取账户与交易，并在本地测试，不要发起真实银行请求。

skill 引导 AI 助手遵循本指南中的接口契约，而不是根据其他开放银行或 OAuth API 猜测。每个流程都会读取对应页面：

组件和 callback：iframe：前端与 iframe：后端。
重定向：OAuth：后端。
数据更新与错误：API 参考和错误目录。

会检查什么，不会检查什么

使用合成数据和组件测试用户（MOCKDATA、MOCKOTP、MOCKLOGINKO）生成本地测试。不会自行执行真实银行连接。
验证 callback 数据在返回 {"status":"ok"} 前已持久化，postMessage 消息按来源过滤，且无效凭据不会进入重试循环。
对本文档未规定的生产控制（例如 callback 真实性验证），会指出需要解决的问题，而不是自行编造。上线前请与支持确认。

skill 绝不会在聊天中索取 api_key 或令牌。请将秘密保留在服务器端，不要放入前端、日志或代码仓库。本地测试通过并不能证明真实银行连接可以正常工作。

维护

skill 仅依据公开文档编写，并链接到各接口契约的来源。如发现与本指南不一致，请在仓库提交 issue。

最后更新于 2026-09-10