功能描述

财税税负测算专家技能。帮助用户计算商品含税定价、评估整体税负。支持增值税测算、四税联算（增值税+附加税+印花税+所得税）、整体税负分析等场景。用户提到税务、税率、含税定价、税负、增值税、所得税、发票、纳税人等测算问题时使用。

使用说明 (SKILL.md)

财税税负测算

Name: 1688 Finance Tax
Author: 1688aiinfra

统一入口：python3 {baseDir}/cli.py \x3Ccommand> [options]

命令速查

命令	说明	示例
`calc-vat`	商品含税定价（仅增值税）	`cli.py calc-vat --taxpayer-type SMALL_SCALE_TAXPAYER --invoice-requirement ORDINARY_INVOICE --invoice-tax-rate RATE_3_PERCENT --original-price 1000 --upstream-cost 600 --calculation-mode EXPECTED_PROFIT --expected-profit 400`
`calc-all-taxes`	商品含税定价（四税联算）	`cli.py calc-all-taxes --taxpayer-type SMALL_SCALE_TAXPAYER ... --registration-type LIMITED_COMPANY --city-tax-rate 7% --is-small-profit-enterprise true`
`calc-overall`	整体税负测算	`cli.py calc-overall --taxpayer-type SMALL_SCALE_TAXPAYER --annual-sales-amount 300 --annual-profit-amount 50 --registration-type LIMITED_COMPANY --city-tax-rate 7% --is-small-profit-enterprise true`
`configure`	配置 AK	`cli.py configure YOUR_AK`

所有命令输出 JSON：{"success": bool, "markdown": str, "data": {...}}

展示时直接输出 markdown 字段，Agent 分析追加在后面，不得混入其中。

工具码与命令映射

ClawHub 工具码	CLI 命令	说明
`ai_tax_calc_vat`	`calc-vat`	商品含税定价（仅增值税）
`ai_tax_calc_all`	`calc-all-taxes`	商品含税定价（四税联算）
`ai_tax_calc_overall`	`calc-overall`	整体税负测算

测算类功能通过 ClawHub 工具码调用（与上表 CLI 对应）。

意图识别与文档索引

根据用户提问意图，跳转到对应的业务流程文档：

用户提问意图	对应文档
商品含税定价、增值税测算、加价点数、含税报价计算	references/tax-calculation.md
四税联算、增值税+附加税+印花税+所得税、综合含税定价	references/tax-calculation.md
整体税负、年度税负、年度税费总额、税负率、企业综合税务成本	references/tax-calculation.md

执行前置（首次命中能力时必须）

首次执行 calc-vat 前：先完整阅读 references/tax-calculation.md
首次执行 calc-all-taxes 前：先完整阅读 references/tax-calculation.md
首次执行 calc-overall 前：先完整阅读 references/tax-calculation.md
同一会话内后续重复调用同一能力可复用已加载知识；仅在规则冲突或文档更新时重读。

通用规则

执行任何业务前，完整阅读并遵守 references/common/common-rules.md。其中对 对客中文、不暴露请求、免责声明、数据验证 等为硬性要求。

异常处理

任何命令输出 success: false 时：

先输出 markdown 字段（已包含用户可读的错误描述）
再根据关键词追加引导：

markdown 关键词	Agent 额外动作
"AK 未配置"	输出下方 AK 引导话术
"参数错误" / "400"	检查用户输入是否正确，引导修正
"限流" / "429"	建议用户等待 1-2 分钟后重试
"服务异常" / "500"	建议用户稍后重试
其他	仅输出 markdown 即可

AK 引导话术

"需要先配置 AK 才能使用财税测算功能。请登录 ClawHub，点击右上角钥匙按钮获取 AK，然后告诉我：'我的AK是 xxx'"

免责声明

每次回答末尾增加：

以上测算结果仅供参考，具体以税务机关与实务为准。

安全使用建议

要点与建议： - 功能简介：此技能确实实现了增值税/四税联算/整体税负测算，会将用户提供的参数打包、用 FINANCE_TAX_API_KEY 对请求签名后向 https://skills-gateway.1688.com 发起请求并返回格式化的中文结果。 - 必要凭据：技能需要提供 FINANCE_TAX_API_KEY（SKILL.md 的 primaryEnv），这是用于 HMAC 签名的访问凭据。仅在信任该网关并信任所提供 AK 时才配置。技能可选读取 FINANCE_TAX_USER_ID（非必需）以附加用户维度。 - 本地文件访问：实现会尝试读取两个本地位置作为回退：1) OpenClaw 配置文件 (OPENCLAW_CONFIG_PATH，默认 ~/.openclaw/openclaw.json) 以查找本技能的 apiKey 条目；2) 项目根目录的 .env 文件（tracker 模块在加载时解析并注入环境变量，但不会覆盖已存在的环境变量）。如果这些文件中包含其它敏感信息，建议在运行或安装前审查或移除不必要的条目。 - 网络与遥测：每次命令执行会向 skills-gateway 发起业务请求并上报一次埋点（/api/reportSkillsUsage/1.0.0）。这些行为是透明且与技能目的相关的，但会产生外部网络请求并带上签名的 AK，因此请在受信网络环境下使用。 - 若你担心隐私/泄露：不要将其他服务的密钥写入同一 .env 或 openclaw.json 中；仅为此技能生成并提供必要的 FINANCE_TAX_API_KEY；如不想读取本地文件，可在运行环境中明确设置环境变量并确保 openclaw.json/.env 不含敏感条目。 - 额外建议：如想进一步降低风险，可在隔离环境中运行或审计传出的请求（URL / 请求体中不应包含除测算参数外的本地文件内容）。

功能分析

Type: OpenClaw Skill Name: 1688-finance-tax Version: 0.1.0 The skill bundle is a legitimate tax calculation tool for the 1688 platform, providing commands for VAT, overall tax burden, and multi-tax calculations. The code follows standard patterns for OpenClaw AgentSkills, including a CLI entry point (cli.py), modular capabilities, and a signed HTTP client (scripts/_http.py and scripts/_auth.py) that communicates with an official 1688 gateway (skills-gateway.1688.com). The configuration logic (scripts/capabilities/configure/) correctly handles API key management via environment variables or the local OpenClaw configuration file (~/.openclaw/openclaw.json), and the instructions in SKILL.md are strictly focused on guiding the agent through tax-related business logic and data validation.

能力标签

cryptocan-make-purchasesrequires-sensitive-credentials

能力评估

✓ Purpose & Capability

技能声明为财税测算，代码实现包含多个测算命令（calc-vat / calc-all-taxes / calc-overall）、参数校验和对外 HTTP 调用到 skills-gateway.1688.com，所需主凭据为 FINANCE_TAX_API_KEY 用于签名请求，这与技能目的高度一致。仅要求 python3，合理且必要。

ℹ Instruction Scope

SKILL.md 指示通过 python3 cli.py <command> 调用并要求先阅读 references 文档，运行时会向 1688 的 skills-gateway 发起 POST/GET 请求并返回业务结果，说明和代码行为基本一致。值得注意的是：代码在运行时会尝试读取两类额外来源以获取 AK（环境变量 FINANCE_TAX_API_KEY 优先，其次为 OpenClaw 配置文件 OPENCLAW_CONFIG_PATH 中的条目），并且 tracker 模块会在加载时解析项目根目录的 .env 文件并注入环境变量（不覆盖已存在的环境变量）。这些文件读取行为没有在 SKILL.md 的显式“执行前置”中列出，属于实现细节，应让用户知晓。

✓ Install Mechanism

无安装脚本（instruction-only 元数据），但包包含 Python 脚本，运行时在本地执行这些文件；没有从不受信任的 URL 下载、也未修改系统位置或安装外部二进制。无需额外包管理器或远程提取，安装风险低。

ℹ Credentials

主凭据 FINANCE_TAX_API_KEY 与调用网关并对请求签名的需求一致且必要。代码还会可选读取 FINANCE_TAX_USER_ID（ENV_USER_ID_NAME）和本地 .env / OPENCLAW_CONFIG_PATH 作为回退来源，这些是合理的实现便利但未在 SKILL.md 显式声明（FINANCE_TAX_USER_ID 未列为必需，仅为可选）。读取 OPENCLAW_CONFIG_PATH（用户主目录下的 openclaw.json）可能访问到本地网关配置文件以获取本技能的 AK 条目；这是功能性方便，但用户应确认该配置文件中不包含他们不愿外泄的其它敏感项。

✓ Persistence & Privilege

技能未请求 always:true，也不修改其他技能或系统级配置。它会在每次命令执行后向 skills-gateway 上报埋点（report_skill_usage），但上报失败被静默忽略；这是正常的遥测行为，权限范围限于网络请求并使用同一 AK 签名。

版本历史

v0.1.0

Initial release of 1688-finance-tax skill: - Provides expert tools for calculating product tax-inclusive pricing and overall tax burden. - Supports VAT calculation, combined calculation of four taxes (VAT, surtaxes, stamp tax, income tax), and overall tax analysis scenarios. - Command-line interface with commands for VAT pricing, combined tax pricing, and overall tax burden calculation. - Offers clear error handling and user guidance for issues like missing API keys or incorrect parameters. - Each response includes a required disclaimer for compliance.

元数据

Slug 1688-finance-tax

版本 0.1.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题

1688 Finance Tax 是什么？

财税税负测算专家技能。帮助用户计算商品含税定价、评估整体税负。支持增值税测算、四税联算（增值税+附加税+印花税+所得税）、整体税负分析等场景。用户提到税务、税率、含税定价、税负、增值税、所得税、发票、纳税人等测算问题时使用。它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 90 次。

如何安装 1688 Finance Tax？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install 1688-finance-tax」即可一键安装，无需额外配置。

1688 Finance Tax 是免费的吗？

是的，1688 Finance Tax 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

1688 Finance Tax 支持哪些平台？

1688 Finance Tax 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 1688 Finance Tax？

由 1688AiInfra（@1688aiinfra）开发并维护，当前版本 v0.1.0。

1688 Finance Tax