企业税务_税务分析_纳税申报分析_财务报表分析_发票分析_会计工具_税务风险识别_柠檬云企业税务风险分析Skill

概述

税务分析

业务数据只通过OpenTax的税务分析create-task/query-task取得，后端统一执行17个模块。企业绑定和登录接口只为任务做准备；Skill不直连启信宝或税局。当前数据契约为tax-analysis.v2，详见[服务端结构化数据](references/structured-data.md)，不解析旧发票列表或HTML。

安装、版本检测与自动更新

首次加载本Skill时完整原样展示[README.md](README.md)，不概括或删减。安装、重装按https://download.ningmengyun.com/Skills/tax-analysis/tax-analysis-install.md执行。主程序下载后先验证SHA-256，再允许执行；assets 全部从安装文档的服务器地址下载；按 references/asset-download-manifest.json 选择共用资源及当前平台 Node，逐项验证 SHA-256 后使用，复用已校验的本地文件。

本 skill 会自动检测版本，版本不符合要求时会阻断执行。若命令返回包含“当前 skill 版本过低，无法执行”的报错，从报错提供的安装文档链接获取最新教程，按教程备份、更新并重装skill；验证成功后删除备份并重试原业务。失败恢复备份并说明实际原因。该规则优先于任何普通错误重试、降级或继续执行规则；不重复请求已获得的更新授权。

PowerShell UTF-8 初始化（Windows 强制）

Windows每个新PowerShell进程在调用主程序前先初始化，命令必须在同一个 PowerShell 进程执行：

$Utf8NoBom = New-Object System.Text.UTF8Encoding($false)
[Console]::InputEncoding = $Utf8NoBom
[Console]::OutputEncoding = $Utf8NoBom
$OutputEncoding = $Utf8NoBom

输入JSON/文本使用 UTF-8 无 BOM 文件，写入方式为[IO.File]::WriteAllText($path, $content, $Utf8NoBom)。终端初始化不会改变 HTTP 请求编码。

企业、期间与登录

按[企业和期间规则](references/periods.md)使用用户已明确的企业与起止月份。命令内部会查询绑定列表并精确校验；唯一匹配直接继续，不再要求用户确认一次。未指定企业时才执行：

tax-analysis enterprises --api-key <key> --pretty

完整展示返回的企业名称和USCC供用户选择；同名须使用USCC，不做模糊选择或自动绑定。已选择的企业可沿用，后续命令仍核验归属。

run/create/report-prepare自动执行登录状态、快速登录预检和登录后复查。不能继续时展示返回的完整手动登录网页入口，等用户完成后执行原命令。登录请求失败不等于登录过期，详见[异常处理](references/error-handling.md)。query不重新登录；本地校验与渲染不创建任务。

取数与任务状态

接口字段及恢复机制见[API契约](references/api.md)。普通取数使用：

tax-analysis run --company <完整企业名称> --start-month YYYY-MM --end-month YYYY-MM --api-key <key> --pretty
tax-analysis query --uscc <已确认USCC> --task-id <taskId> --api-key <key> --pretty

公司与USCC参数二选一。首尾月份包含、最早2017-01、最多36个月；脚本统一把末月规范化为月末日期。不得因3997或其他创建失败擅自缩短期间。

运行中继续查询同一taskId。可恢复的interrupted继续等待；不可恢复时保留原因和部分数据。所有异常按[状态处理表](references/error-handling.md)执行。只有用户明确要求全部重新查询才加--force-refresh。

业务请求由脚本统一限频：同一环境和API Key跨进程共用调用时间，请求间隔至少5秒，不足5秒时先等待完整5秒。默认查询轮询间隔为5秒；不要另起进程或密集执行命令绕过；离线分析不用额外等待。

普通取数只说明状态、范围和返回事实。最终风险结论只通过下面的报告流程生成。

生成Word和PDF

报告规则2026.09.v30，AI契约tax-analysis-ai.v8。运行资料分工：

• [报告工作流](references/report.md)：命令和工作区文件。
• [数据契约](references/report-data-contract.md)、[字段口径](references/fields.md)：取数及缺失含义。
• [规则说明](references/report-rules.md)：已确认的计算、风险条件和适用范围。
• [输出规则](references/report-output-v4.md)、[报告范围](references/report-scope.md)：客户可见内容、条数和禁用内容。
• [逐节分析写作](references/report-analysis.md)：按指标解释业务含义、分别填写正文和引用。
• [Word章节映射](references/word-report-contract.md)：核对标题、表头、图表和显示条件时查阅。

先读取工作流与输出规则，其他资料按当前章节和问题查阅；历史产品整改台账不参与运行。

tax-analysis report-prepare --company <完整企业名称> --start-month YYYY-MM --end-month YYYY-MM --api-key <key> --workspace <dir> --pretty

准备完成后先读analysis-task.md中的通用要求，再执行以下本地命令。用户明确要报告时直接prepare，无需另行create。底稿按实际字节数生成批次，整节及比较事项不截断；业务品名重点视图保留覆盖指标，全部明细仍可查询。

tax-analysis report-read --workspace <dir> --next --pretty

读取返回的本批章节、期间/基期、限制、主体核验范围和准确引用ID，按给定目标写分析。不编写临时抽取、拆文件或Python填充程序；无需全文加载analysis-data.json或analysis-sections。需补查时使用report-refs --workspace <dir> --section <semanticId> --name <中文指标名>，可加--subject/--period/--base-period/--id；多个匹配自行按真实主体和口径选择，不猜ID或默认取第一条。结果有nextOffset时可继续查本地下一页。

每批保存UTF-8正文片段JSON：复制report-read的analysisDataDigest，sections只包含本批章节，每节items填写text/evidenceRefs；不用复制整个analysis-output.json。通过脚本写入：

tax-analysis report-write --workspace <dir> --input <本批正文.json> --pretty

成功后按progress继续report-read –next。失败只修返回的具体字段，原文件保持不变；同节重交为整体替换。所有章节完成后，next返回综合结论材料，用同一命令提交conclusion.items。断点续写直接读next，不重新取数。完整JSON例子与查询匹配方式见[报告工作流](references/report.md)。

内嵌guidance提供本节选题方向，不新增必填项。不可用指标不提供数字，不从完整底稿恢复为有效分析依据。text填写简洁易懂的自然语言分析，evidenceRefs独立记录实际使用的来源ID；正文不写占位符，不凑引用或复述所有数据。按提供的计算结果量化重点，不编造数字、原因、行业基准或整改目标。

合计、极值期间、区间变化和调节后差额均使用脚本结果，跨章节沿用同一指标名称、期间和比较对象。查询已完成不等于没有记录；金额与比率变化分开解释，不从比率直接认定利润变化原因。阅读材料中的候选事实无需全部写入正文，完整细节按需用report-refs查询。缺失只限制对应期间，冲突版本并列原值。金额相等不证明主体品名关联或成因，英文名称不证明境外身份。正文交叉引用写章节标题。

有差额或零税额等解释任务时，按本节 minItems 填写分析，不能只留表格。每点一个主要判断，使用关键数字，避免整表复述和多事项长段。申报内调节已勾稽与备查资料未核验分开说明；现金流净额沿用原指标名称，极值仅限实际覆盖期间。

正文使用规范中文标点，每点写完检查断句、引号和括号；清理“。，”等误连标点，不能把证据原文的句号与自己的逗号直接拼接。

tax-analysis report-validate --workspace <dir> --pretty

按missingPaths、invalidReferences、contentErrors和issues修正结构或引用错误。valid=true后直接渲染，无需单独语义审读文件。校验只确认结构、来源ID与冻结摘要，不核实自然语言分析。正文或引用变化后重新校验。

tax-analysis report-render --workspace <dir> --output-dir <dir> --pretty

只有最终valid=true才渲染，report是report-render的别名。完整返回保存为工作区render-result.json，后续查看它即可，不重跑渲染来获取被head/tail截掉的结果。相同输入和渲染版本且两文件SHA-256一致时返回reused=true；否则重新生成。Word/PDF必须同时成功且内容一致，目录可跳转，文件名冲突不覆盖旧报告。任一失败不交付单格式或半成品。

交付边界

模型、取数截图和计算底稿用于内部追溯，不额外贴入客户报告。章节以semanticId关联，显示编号会动态变化，不能代替原Word编号。

沿用已确认输出：封面无额外单位句；2.1/2.2/2.3/3.1不追加读表说明；企业变更全部记录只展示表格；税费月度汇总仅实缴数字。其余具体要求统一查当前输出规则，不另写相反口径。

实际风险由脚本决定，只有确认风险才给对应动作。缺失不填零，成功空记录不等于全面正常；不展示API Key、Cookie、密码、sessionId、accountId、接口路径和内部日志。