evm-token-decimals
作者 affaan-mevm-token-decimals 可帮助你避免在各类 EVM 链上出现静默的精度不匹配 bug。适用于运行时查询 decimals、按链缓存、桥接代币精度漂移处理，以及面向后端开发、机器人、仪表盘和 DeFi 工具的安全归一化。
该技能评分为 78/100，说明它是一个扎实的目录收录候选，适合需要实用指导来避免 EVM 代币精度 bug 的用户。仓库提供了足够的操作细节，足以支持安装决策，不过用户应预期这是一个以文档为主的技能，配套资源有限，也没有安装命令。
- 用例清晰且价值高：可防止跨 EVM 链出现静默的精度不匹配，包括桥接资产和法币换算场景。
- 触发条件和工作流指引明确：说明了何时使用，并建议在运行时查询 `decimals()`，同时采用按链缓存。
- 正文内容充实，包含示例和结构化标题，比通用提示词更利于代理理解。
- 没有脚本、引用或补充资源，因此机器可执行支持较少，也缺乏更深入的验证材料。
- 没有安装命令，也没有仓库/文件引用，这可能让部分代理在采用和精确激活时不够直观。
evm-token-decimals 技能概览
evm-token-decimals 的作用
evm-token-decimals 技能可以帮你避开最常见的 EVM 数据坑之一：不要先假设 token 的 decimals，而要在运行时读取。它专为那些比“快速查个 token”更看重余额准确性、USD 换算和跨链归一化的任务而设计。
适合谁使用
这个 evm-token-decimals skill 很适合处理 ERC-20 余额摄取、构建资产组合视图、对账转账或驱动机器人与聚合器的 Backend Development 工作流。尤其当你的应用要同时面对多条链、跨链桥资产，或者 decimals 行为不一致的 token 时，它会更有用。
为什么在实践中很重要
decimals 的错误通常不会明显报错；它们会悄悄把结果放大 10 倍、100 倍，甚至 1e12 倍。evm-token-decimals 真正要解决的，是在数值进入仪表盘、模型或交易决策之前，通过运行时读取 decimals、按链缓存以及安全归一化，让 token 数学变得可信。
如何使用 evm-token-decimals 技能
安装并找到权威来源
先通过你的 skill manager 走一遍 evm-token-decimals install 流程，然后从 skills/evm-token-decimals/SKILL.md 开始看。先把整个文件通读一遍，再查看仓库里的示例代码，最后再按你的技术栈做适配。由于这个 skill 以单文件形式交付，是否安装更多取决于它的工作流是否与你的 token 处理路径匹配。
把粗略任务改写成可用提示词
evm-token-decimals usage 模式最适合在你明确写出 chain、token、语言和输出目标时使用。比如：“用 Python 写一个 helper，在 Base 和 Ethereum 上运行时读取 ERC-20 decimals，按 (chain_id, token_address) 缓存，并返回标准化的 Decimal 值用于资产组合估值。”这比“处理 token decimals”强得多，因为它给了 skill 生成正确、可复用代码所需的输入。
哪些输入最能提升结果
提供 token 地址、chain ID、目标语言，以及你需要的是余额、转账还是法币换算。如果你已经知道失败模式，也要直接说明：跨链桥 token 不一致、缺少 ABI、缓存过期，或者混合 decimals 聚合。这个 skill 在你给出真实集成约束时最强，而不是抽象意图。
建议遵循的实际工作流
先找出应用里所有把链上原始整数转成展示或定价逻辑的位置。然后为每个 token 和每条链添加运行时 decimals() 查询并缓存结果。接着在系统边缘完成金额归一化，而不是散落在临时视图里，这样下游代码才能始终使用一致的单位。这就是 evm-token-decimals guide 的核心模式，能有效避免静默漂移。
evm-token-decimals 技能 FAQ
evm-token-decimals 只适合 DeFi 应用吗？
不是。只要涉及 ERC-20 金额读取和比较，这个 skill 都有用：后端任务、钱包服务、索引器、会计流水和风控工具都包括在内。关键不是仅仅显示标签，而是你需要 token 数学在 decimals 上足够安全。
什么时候不该用这个 skill？
如果你的任务和 token 金额归一化无关，或者上游已经把 token 值标准化好了，就不要依赖 evm-token-decimals。如果你只是要给某个已知资产和链写一个一次性脚本，一个简单提示词可能就够了。
它比通用提示词好在哪里？
通用提示词往往会跳过链特定缓存、跨链桥资产漂移和运行时校验这些关键点。evm-token-decimals skill 会把你引向生产环境里最容易出 bug 的操作细节，尤其是当代码对单个 token 可用，却在整个资产组合上失效时。
对新手友好吗？
可以，只要你能描述应用里的 token 流程。你不需要很深的协议知识也能从 evm-token-decimals 中受益；但你需要知道余额从哪里进入系统、又在哪里被转换、缓存或展示。
如何改进 evm-token-decimals 技能
给这个 skill 提供精确的 token 场景
一开始就说明链、token 合约和使用场景，效果会更好。比如“为交易机器人规范化 Arbitrum 上的 USDC 余额”就比“帮我处理 decimals”更可执行，因为这个 skill 能据此推断链特定行为，以及执行所需的精度。
留意最常见的失败模式
最容易出错的是硬编码 decimals、缓存时不区分链，以及过早做单位转换。如果你把 evm-token-decimals 用在 Backend Development 中，应该要求代码在最终归一化步骤之前始终保留原始整数金额，并且在无法获取 decimals 时安全失败。
用真实边界案例反复迭代
拿到第一版输出后，先用一个 decimals 很特殊的 token、同一资产的跨链桥版本，以及至少一个多链场景去测试。如果代码或提示词还是默认“稳定币永远是 6 位 decimals”，就继续收紧需求，并要求更严格的校验路径。