中国税务文员

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install china-tax-clerk
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 china-tax-clerk。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

中国税务文员是一款 AI 申报准备助手，适用于影响中国大陆居民企业和个人的常见税种。它支持增值税、附加税费、企业所得税、工资和奖金个人所得税、综合所得及常见印花税的工作流程。它会先确认纳税人和税期，再帮助核验源材料、应用计算规则，并将结果对应到申报字段。
作为 Openclaw Skills 税务工具之一，它着重确保数据可追溯、标明政策日期、分别检查资格并进行人工审核。其 Python 计算器只生成草稿，不会连接税务机关或提交申报表。初始适用范围有限；特殊情形需要另行研究政策并计算。该助手不声称拥有税务代理资质或政府授权。

应用场景

根据现有账目记录和佐证文件，准备可供审核的税务工作底稿。
估算常见增值税、附加税费、企业所得税、个人所得税、奖金、综合所得或印花税金额。
计算前检查纳税人信息、税期、申报周期、税务状态、资格或源材料是否缺失。
审核计算草稿，并核对源文件、调整项、计税依据、金额及申报字段。
为标准计算器未涵盖的特殊情形整理证据和政策问题。
归档申报回执，并区分草稿准备与官方受理或缴款。

工作原理

确认纳税人类型、所在地、税期、申报周期、税务状态及相关资格；不要假设个体经营者、合伙企业或个人工商户适用企业所得税流程。
复用现有记录，仅询问可能影响结果的缺失信息。保留原始文件，并对照来源核实提取的金额、发票号码和税率。
核查相关期间适用的政策和地方指引。记录来源、文件编号、条款、URL、适用性和审核日期；标记尚未重新核实的政策信息。
对支持的标准情形运行 Python 计算器，不要用心算代替。区分未知金额与零，并记录调整项和舍入差异。
准备草稿，将源项目关联至调整项、计税依据、计算税额和对应申报字段。酌情将结果标注为计算结果，或标注材料与政策已审核。
任何申报操作前，由获授权人员审核草稿。脚本不会连接税务机关；只有官方状态或回执能够佐证时，才报告已受理或已缴款。
归档输入、输出、佐证、政策引用、差异和处理状态；不得包含密码、验证码、API 密钥或不必要的完整身份号码。

配置指南

要求：Python 3.10 或更高版本。此技能使用 Python 标准库，无需安装其他软件包。请在技能目录中运行命令：
python3 scripts/calculate.py assets/examples.json
python3 -m unittest discover -s scripts -p 'test_*.py' -v
处理实际任务时，应分别保存输入 JSON 和输出；不要将演示数据当作实际申报工作底稿。有关支持的输入详情，请参阅计算器参考文档。准备申报前，请查看政策和工作流程参考文档，并针对每个税期及正式提交前核实当前国家和地方指引。如果无法在线核查政策，应将结果标记为“政策未经核实的估算”，而非“可提交”。计算器仅生成草稿，不会申报、修改、退还或缴纳税款。

数据架构

此技能将任务数据、计算器结果、证据和政策引用分别处理。实际任务应使用单独的输入和输出 JSON 文件；示例文件仅供演示，并非纳税人记录。所提供的文档未定义完整通用 JSON 架构，因此请根据计算器参考文档使用受支持字段，不要臆测未记录的字段。
数据或文件 用途
assets/examples.json 用于运行计算器的演示输入；并非实际申报草稿。
scripts/calculate.py 用于支持的标准情形的确定性计算接口。
scripts/test_*.py 计算器测试，可通过 unittest discovery 运行。
references/policies.md 用于核查规则、日期和资格的政策来源及指引。
references/workflow.md 材料收集和申报准备工作流程。
references/calculator.md 计算器接口和支持的计算详情。
references/tools.md 处理源材料的工具研究。
assets/workpaper-template.md 用于准备特定任务工作底稿的模板。
特定任务的输入和输出 JSON 实际计算及其结果的单独记录。
工作底稿应围绕纳税人和期间、计税依据、计算输入和输出、缺失信息和差异、申报字段对应关系、政策来源和审核日期以及处理状态进行整理。保留从原始文件或电子表格单元格到调整项、计税依据、税额和申报字段的可追溯链条。使用人民币元和小数表示；税额四舍五入至两位小数。发票级舍入与申报汇总舍入之间的差异应作为单独调整项列出，不要强行使总额相符。分别跟踪已生成、已录入、已受理、已缴款和已归档等状态；报告已受理或已缴款前，必须有证据佐证。

高级特性

通过 Python 3.10+ 脚本进行确定性计算，并提供基于 unittest 的测试命令。
按期间审查政策，区分发布日期、生效日期、失效日期、税期和申报日期，并优先参考官方来源及地方指引。
分别检查增值税小规模纳税人身份、小型微利企业资格以及地方税费减免，不会仅凭销售额低就推断符合资格。
从源文件或电子表格单元格，经调整项和计税依据到税额及申报字段映射，全程追溯。
基于证据进行舍入和核对，记录差异，而不强行使总额相符。
明确区分草稿准备与获授权申报：任何外部申报操作均需明确授权，提交申报不代表同时授权缴款。
对房地产、出口退税、差额计税、税收抵免与退税、核定征收、跨境或非居民事项、股权激励、研发费用扣除及特殊行业等领域，可收集文件并研究政策，同时明确标记不支持的计算。
安全保存记录，不包含密码、验证码、API 机密或不必要的完整身份号码。

name: china-tax-clerk description: 中国大陆企业计税与报税工作助手。用于增值税、附加税费、企业所得税、工资个税、年终奖、综合所得及常见印花税的资料核对、税额计算、申报底稿、申报复核和回执归档。遇到算税、报税、纳税申报、个税代扣、企业汇算时使用。 license: MIT-0