技能介绍

要解决的问题

企业税申报流程通常横跨多个税种、多个任务状态和外部登录会话。如果直接拼接口、保存登录态或在日志中暴露税局账号，容易出现凭证泄露、重复提交和难以追溯的问题。这个技能把企业税申报收敛到企享云申报 MCP 的受控工作流中，重点处理申报准备、申报执行和申报后核验之间的状态衔接，并避免把敏感凭证明文写进对话、命令参数或普通日志。

工作方式

技能依赖 QXY_API_KEY 和内置 agent_login 会话。首次触发业务命令时，脚本会返回一次性 login_url，Agent 在后台启动 waitArgv 等待登录完成，再通过 resumeArgv 续跑原任务。用户只需要访问登录页，不需要提供税局手机号、密码、验证码或登录 Token。

核心调用分两层：

scripts/mcp_client.py：执行单服务、单工具原子调用，例如列出服务、查看工具 Schema 和调用指定工具。
scripts/declaration_workflow.py：执行申报闭环，覆盖 roster_entry、initialize_data、declaration_submission、pdf_download、declaration_query 和 missing_declaration_check。

申报闭环会处理周期字段、税种周期、轮询状态和 PDF 下载结果。企业级编排要求一次登录授权只绑定一个企业，多企业场景必须按企业拆分执行。输出时应保留当前脚本、模块、服务别名、tool 名称、关键业务参数、aggOrgId、taskId 和 businessStatus。

适用边界

该技能只适合走企享云申报 MCP 的受控链路，不应在脚本失败后切换到手写 curl、网页浏览或旧登录态。当前资料明确列出 BDA0610135 个人所得税 为已知不支持项。多租户或云端部署需要为 --login-context-id 和登录流目录做隔离，避免暴露原始会话证明、内部登录上下文或企业标识。