Agent Skills
返回列表
百分比工具

百分比工具

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_15292d5a/yjkj-cn-percentage-tool。

技能介绍

要解决什么问题

日常开发、报表和脚本里经常要算「A 占 B 的百分之几」、已知比例反推总量或部分,以及环比/同比式的增减百分比。手算或随手写 float 除法容易踩坑:精度、四舍五入、千分位展示各写一套,还容易把「增长 20%」和「变为原来的 120%」搞混。

技能如何工作

cn-percentage-tool 用纯 Python 标准库(含 argparse)封装几类常见算式,默认保留 2 位小数,并支持带千分位分隔符的格式化输出。

  • 占比:计算 A 是 B 的百分之多少
  • 反向:已知百分比与部分值,求整体
  • 比例:已知整体与百分比,求部分
  • 增减:计算增长或下降的百分比
  • 输出:在数值结果上控制精度与展示格式

无第三方依赖,也不依赖 API Key,适合本地 CLI 或嵌入同类 Python 工作流。

适用边界与注意点

工具面向确定性算术场景,不替代财务、税务等领域的合规舍入规则;若业务对「银行家舍入」或固定小数位有硬性要求,应在调用侧再校验。默认两位小数对展示友好,但科学计算或高精度场景需自行调整精度参数或改用 decimal 等方案。

使用场景

  • 写运维或数据脚本时,要把某指标数值与总量相除,得到「占整体的百分之几」并固定两位小数输出
  • 报表里已知完成额和达成率,需要反推本期目标总量,避免在 Excel 与脚本里各写一套公式
  • 对比本周与上周销售额,要算环比增长或下降百分比,并用于日志或简报里的可读文案
  • 批量生成说明文字时,需要把比例结果加上千分位分隔符,统一展示精度再写入 Markdown 或 CSV

适合人员

  • 维护内部 argparse 小工具的 Python 工程师,希望占比、反推和增减算式与输出格式保持一致
  • 每周整理 KPI 并要写环比/同比变化率的数据分析,需要可复用的计算与格式化逻辑
  • 用纯标准库写报表脚本的独立开发者,不想为简单百分比引入第三方依赖或 API
  • 负责把原始指标转成对外说明文案的产品运营,需要千分位与小数位统一的百分比表述