用途：处理飞书应用的用户授权，并尽量复用本地已有 token，避免重复弹出授权页；也用于排查 token 实际存储位置、补授权 scope 和删除指定用户的本地 token。
主要能力：发起飞书用户授权；自动挑选可复用用户记录，未指定 --open-id 时也能选择；当应用 scopes 多于本地已授权范围时只补缺失部分；分批授权后对 scopes 取并集保存，不覆盖旧批次；查看、刷新和删除 token。默认 token 存储在 ~/.feishu-auth/tokens/<appId>.json，若 config.json 配置了 storeDir 则改为 <storeDir>/tokens/<appId>.json。旧版 token 会尝试从 legacy 目录迁移。
使用方式：先准备 config.json，必填 appId、appSecret，可选 brand（默认 feishu）、storeDir、legacyStoreDir。默认不加入 PATH，可直接执行安装目录里的 bin，例如 ./.agents/skills/feishu-user-auth/bin/feishu-auth.js auth；全局安装可执行 ~/.agents/skills/feishu-user-auth/bin/feishu-auth.js auth。可自行创建软链到 ~/.local/bin 以使用 feishu-auth 命令名。常用命令包括 auth、user-auth、refresh-token、show-token、remove-token、system-token、system-auth，并支持 --batch-size、--open-id、--scope、--force、--config 等参数。
适用场景：给飞书应用做用户授权、排查反复弹窗、确认本地是否已授权某用户、补一批新 scopes 但保留旧授权、删除某用户本地 token 重新授权。
限制：本 skill 只负责发起授权与复用 token，不负责其他飞书业务功能；脚本不再依赖 FEISHU_APP_ID 等环境变量；实际可用命令、参数和配置字段以上述资料为准，其他平台、收费或效果信息暂未提供。