zijizhang-skill#

专业的记账报税工具，可完成记账、入账、报税、报表查询与待办处理。

When to Use This Skill#

• 用户提及自记账
• 用户需要处理工资单、员工、社保、银行回单/流水、发票、审账待办
• 用户希望申报个税、企业税、增值税、经营所得税、城建税、教育费附加、地方教育附加等税务事项
• 用户需要查询资产负债表、利润表等财务报表数据

Non-Negotiable Guardrails#

以下规则必须严格遵守，优先级高于经验判断：

1. 绝不臆造数据。 只允许使用三类数据推进写操作：

• 用户明确提供的数据
• CLI 返回的数据
• 按 workflow 明确允许推导出的值，例如“当前是 2026-04，用户说本期工资单，则 month 默认为 2026-03”

1. 只要是写操作，必须先向用户确认。 写操作包括但不限于：

• employee add_employee
• employee update_employee
• payroll create_payroll
• invoice set_month_no_sales_invoice
• invoice set_month_no_invoice
• invoice upload_invoice_file
• invoice invoice_choose_use
• social_security social_security_build_task
• social_security social_security_agree_tax
• social_security social_security_disagree_tax
• bank add_bank_account_number
• bank del_bank_account_number
• bank upload_bank_file
• bank choose_bank_use
• bank set_month_bank_no_water
• todo before_set_month_audited
• todo set_month_audited
• tax agree_gs_tax_rate
• tax disagree_gs_tax_rate

1. 确认时必须回显关键提交内容。 至少回显以下信息后，再等待用户确认：

• 当前公司 uid 或当前激活公司
• 操作对象，例如月份、发票、回单、员工、社保申报期
• 准备提交的关键字段与字段来源
• 哪些字段来自用户，哪些来自 CLI

1. 不得为了凑齐参数而自行补值。 如果 CLI 需要的字段缺失，必须停下来并向用户说明缺了什么，或者先调用 workflow 中要求的上游查询命令补齐。

2. 禁止绕过 skill 既定流程。 只要本 skill 中已有对应 workflow/*.md 或 references/*.md，必须先按这些文件执行，不要用 zijizhang-cli --help、猜参数、试错式探索来替代正式流程。

3. 优先读文档，再执行命令。 顺序固定为：

• 先匹配场景
• 再打开对应 workflow
• 再打开对应 CLI 文档
• 最后执行命令

1. 每次写操作后必须立即校验结果。

• 至少检查返回 code
• code!=200 时停止后续流程，反馈 msg
• 若该流程是异步处理，还要按 workflow 继续查询状态

Execution Order#

每次进入本 skill，按下面顺序推进：

Step 0：校验 Skill 版本（建议）#

执行任务前先校验 zijizhang-skill 是否有更新，取本文件顶部 YAML 的 version: 值作为参数：

shell

zijizhang-cli updater check_skill_update '0.0.2'

处理规则（详见 references/check_skill_update.md）：

• code != 200：不阻塞用户业务请求，继续按当前版本执行，并告知"远端查询失败，本次跳过更新检查"
• code == 200 且 data.latest 高于当前版本：必须提示用户按 data.installation_guide_url 升级/覆盖安装（不要自行猜安装命令/来源，是个 zip 包，skill 在 zip 里）
• must_be_update == true：必须强提醒用户先升级，再继续可能受版本影响的关键流程

Step 1：确认登录态与公司上下文#

先执行：

shell

zijizhang-cli account get_cpy_list

说明： get_cpy_list.data[].pending_todo_cnt 会返回每个公司未完成代办数量（统计口径： todo get_todo_list.data.todo_list 中 state=0 的条目数；查询失败时为 null）。

判断规则：

• 若返回 code=200 且存在当前激活公司：记录激活 uid，继续
• 若 token 失效、未登录或未绑定：严格按“绑定账号步骤”执行
• 若需要切换公司：先按 references/switch_to.md 执行 account switch_to '<uid>'
• ⚠️ 切换公司完成后的第一件事必须执行 todo get_todo_list --uid='<uid>' 获取该公司的待办明细，再进入后续 workflow

Step 2：识别任务类型并打开对应 workflow#

按场景选择：

• 工资单： workflow/payroll.md
• 销项发票： workflow/invoice_sales.md
• 进项发票： workflow/invoice_income.md
• 发票上传： workflow/invoice_upload.md
• 社保： workflow/social_security.md
• 个税： workflow/individual_tax.md
• 报表查询：无独立 workflow，直接打开对应 CLI 文档，例如 references/get_report_zcfzb.md、 references/get_report_lrb.md

如果任务是待办处理，先 todo get_todo_list，再根据待办类型进入对应 workflow。

Step 3：打开对应 CLI 文档#

执行具体命令前，先读对应文档：

• 命令格式、必填参数、返回结构，以 references/*.md 为准
• 不允许跳过文档直接凭记忆或 --help 自行探索

Step 4：先查后写#

• 先做读取型查询，拿到真实上下文
• 再整理提交参数
• 再向用户确认
• 最后执行写操作

Additional Resources#

• Workflow: workflow/*.md
• CLI docs: references/*.md
• Skill 更新（Agent 流程）: references/auto_update.md

Dependencies#

Python packages (install once):

shell

pip install --upgrade zijizhang-cli

⚠️要求： zijizhang-cli 版本需为 0.0.28 及以上

检查版本：

shell

zijizhang-cli --version

Feature Map#

以下命令仅作为能力索引；真正执行时，仍必须回到对应 workflow 和 CLI 文档。

模块功能命令文档account创建登录授权链接zijizhang-cli account create_auth_url``references/create_auth_url.md``account获取可切换公司列表zijizhang-cli account get_cpy_list``references/get_cpy_list.md``account切换公司zijizhang-cli account switch_to '<uid>'``references/switch_to.md``account退出登录zijizhang-cli account logout``references/logout.md``employee获取员工列表zijizhang-cli employee get_employee_list --uid='<uid>' --keyword='<keyword>'``references/get_employee_list.md``employee添加员工zijizhang-cli employee add_employee '<data>' --uid='<uid>'``references/add_employee.md``employee修改员工信息zijizhang-cli employee update_employee '<employee_id>' '<data>'``references/update_employee.md``payroll获取工资单创建状态zijizhang-cli payroll get_payroll_creation_status '<month>' --uid='<uid>'``references/get_payroll_creation_status.md``payroll获取预览工资单zijizhang-cli payroll get_preview_payroll '<month>' --uid='<uid>'``references/get_preview_payroll.md``payroll创建工资单zijizhang-cli payroll create_payroll '<month>' '<data>' --uid='<uid>'``references/create_payroll.md``payroll获取工资单zijizhang-cli payroll get_payroll '<month>' --uid='<uid>'``references/get_payroll.md``payroll删除工资单zijizhang-cli payroll remove_payroll '<month>' --uid='<uid>'``references/remove_payroll.md``invoice获取销项发票列表zijizhang-cli invoice get_sales_invoice_data_list ...``references/get_sales_invoice_data_list.md``invoice获取进项发票列表zijizhang-cli invoice get_income_invoice_data_list ...``references/get_income_invoice_data_list.md``invoice标记无销项发票zijizhang-cli invoice set_month_no_sales_invoice '<year>' '<month>' --uid='<uid>'``references/set_month_no_sales_invoice.md``invoice标记无进项发票zijizhang-cli invoice set_month_no_invoice --uid='<uid>' '<year>' '<month>'``references/set_month_no_invoice.md``invoice确认收到的发票已全部录入完成zijizhang-cli invoice check_invoice_over --uid='<uid>' '<year>' '<month>'``references/check_invoice_over.md``invoice上传发票文件zijizhang-cli invoice upload_invoice_file --uid='<uid>' --file='<file>'``references/upload_invoice_file.md``invoice查询发票文件列表zijizhang-cli invoice invoice_file_list --uid='<uid>' --current='<current>'``references/invoice_file_list.md``invoice获取进项发票可选用途zijizhang-cli invoice invoice_can_choose_use_list ...``references/invoice_can_choose_use_list.md``invoice进项发票用途入账zijizhang-cli invoice invoice_choose_use ...``references/invoice_choose_use.md``social_security获取当月社保申报概览zijizhang-cli social_security social_security_now_month_report_info --uid='<uid>'``references/social_security_now_month_report_info.md``social_security获取社保历史记录zijizhang-cli social_security social_security_history_list --uid='<uid>' --current='<current>'``references/social_security_history_list.md``social_security获取社保明细zijizhang-cli social_security social_security_get_mx_data '<year>' '<month>' --sb_type='<sb_type>' --uid='<uid>'``references/social_security_get_mx_data.md``social_security创建社保申报任务zijizhang-cli social_security social_security_build_task '<year>' '<month>' --sb_type='<sb_type>' --uid='<uid>'``references/social_security_build_task.md``social_security同意社保税额并发起缴款zijizhang-cli social_security social_security_agree_tax '<year>' '<month>' --uid='<uid>'``references/social_security_agree_tax.md``social_security驳回社保税额zijizhang-cli social_security social_security_disagree_tax '<year>' '<month>' --uid='<uid>'``references/social_security_disagree_tax.md``tax获取当前需要申报的税种列表和申报情况zijizhang-cli tax tax_detail --uid='<uid>'``references/tax_detail.md``tax获取某个月份个税申报概览信息zijizhang-cli tax month_gs_report_info '<year>' '<month>' --uid='<uid>'``references/month_gs_report_info.md``tax获取某个月份个税明细数据zijizhang-cli tax gs_month_mx '<year>' '<month>' --uid='<uid>'``references/gs_month_mx.md``tax同意个税税额/费率（确认金额）zijizhang-cli tax agree_gs_tax_rate '<year>' '<month>' '<agree_type>' --uid='<uid>'``references/agree_gs_tax_rate.md``tax不同意个税税额/费率（驳回金额）zijizhang-cli tax disagree_gs_tax_rate '<year>' '<month>' --uid='<uid>'``references/disagree_gs_tax_rate.md``bank获取支持银行列表zijizhang-cli bank support_bank_list``references/support_bank_list.md``bank获取银行账号列表zijizhang-cli bank bank_account_number_list --uid='<uid>'``references/bank_account_number_list.md``bank添加银行账号zijizhang-cli bank add_bank_account_number --bank_id='<bank_id>' --bank_number='<bank_number>' --uid='<uid>'``references/add_bank_account_number.md``bank删除银行账号zijizhang-cli bank del_bank_account_number --bank_id='<bank_id>' --bank_number='<bank_number>' --uid='<uid>'``references/del_bank_account_number.md``bank上传银行文件zijizhang-cli bank upload_bank_file --uid='<uid>' --file='<file>' --file_type='<回单或明细>' --bank_account_number_id='<id>' --billing_cycle='<YYYY-MM-DD>'``references/upload_bank_file.md``bank查询银行文件列表zijizhang-cli bank bank_file_list --uid='<uid>' --current='<current>'``references/bank_file_list.md``bank获取银行回单/流水列表zijizhang-cli bank get_bank_bill_data_list --uid='<uid>' --current='<current>' --date_begin='<date_begin>' --date_end='<date_end>'``references/get_bank_bill_data_list.md``bank回单用途入账zijizhang-cli bank choose_bank_use '<bill_id>' '<rule_text>' --uid='<uid>'``references/choose_bank_use.md``bank标记无回单/流水zijizhang-cli bank set_month_bank_no_water '<year>' '<month>' --uid='<uid>'``references/set_month_bank_no_water.md``todo获取待办列表zijizhang-cli todo get_todo_list --uid='<uid>'``references/get_todo_list.md``todo审账前确认zijizhang-cli todo before_set_month_audited '<year>' '<month>' --uid='<uid>'``references/before_set_month_audited.md``todo提交审账zijizhang-cli todo set_month_audited '<year>' '<month>' --uid='<uid>'``references/set_month_audited.md``report获取资产负债表zijizhang-cli report zcfzb '<begin>' '<end>' --uid='<uid>'``references/get_report_zcfzb.md``report获取利润表zijizhang-cli report lrb '<begin>' '<end>' --uid='<uid>'``references/get_report_lrb.md

Usage#

在正式操作前，先检查是否已绑定账号：

shell

zijizhang-cli account get_cpy_list

get_cpy_list 会在公司列表中一并返回每家公司的 pending_todo_cnt（未完成代办数量）；如需查看代办明细，再执行 references/get_todo_list.md。

如果不能正常获取公司列表，或提示 token 过期，则按以下步骤绑定。

绑定账号步骤#

1. 打开 references/create_auth_url.md，执行创建授权链接
2. 打开授权链接并按页面提示登录
3. 打开 references/get_cpy_list.md，获取公司列表（包含 pending_todo_cnt）
4. 如需切换公司，打开 references/switch_to.md 并执行 account switch_to '<uid>'
5. ⚠️ 切换完成后立即执行 references/get_todo_list.md（ todo get_todo_list --uid='<uid>'），再总结给用户

Workflow#

工资单#

• 创建或查询工资单： workflow/payroll.md

发票#

• 销项： workflow/invoice_sales.md
• 进项： workflow/invoice_income.md
• 上传： workflow/invoice_upload.md

社保#

• 社保申报： workflow/social_security.md

银行回单/流水#

• 银行回单/流水处理： workflow/bank.md

个税#

• 个税待办处理： workflow/individual_tax.md

审账#

• 审账待办处理： workflow/audit.md

待办处理#

核心原则：用户说"处理代办"或类似意图时，agent 必须主动引导、逐项推进，直到全部完成。不要等用户逐项指定。

1. 先执行：

shell

zijizhang-cli todo get_todo_list --uid='<uid>'

1. 待办分为 主流程 和 独立流程 两类：

主流程（严格按顺序逐项处理，前一项完成后再进入下一项）：

顺序代办类型说明处理原则1EMPLOYEE员工先查 get_employee_list；若缺员工或入职日期不符合，再向用户确认后新增/修改2PAYROLL工资单严格按照 workflow/payroll.md3BANK回单/流水严格按照 workflow/bank.md4SALES销项发票严格按照 workflow/invoice_sales.md5INCOME进项发票严格按照 workflow/invoice_income.md6AUDIT审账严格按照 workflow/audit.md（必须所有主流程前置项完成后才能审账）

独立流程（用户要求时单独处理，不阻塞主流程）：

待办类型说明处理原则SOCIAL_SECURITY社保严格按照 workflow/social_security.md``GS个税严格按照 workflow/individual_tax.md 执行，会有多个月份的待办需逐一处理

1. 逐项引导流程（每项必须走完以下闭环）：

   a. 告知用户 当前处理的是第几项、是什么类型、当前进度（如"第 2/5 项：工资单"）

   b. 读取对应 workflow 文档，按文档步骤执行查询，收集必要信息

   c. 整理提交参数并向用户确认，回显关键信息

   d. 用户确认后执行写操作，检查结果 code

   e. 成功后告知用户 该项已完成，并询问是否继续下一项（默认自动继续，用户说"停"才停止）

   f. 失败时停止，反馈错误原因，等用户指示

2. 每处理完一项，重新查询待办列表确认状态，然后进入下一项。直到全部变为 state=1 或遇到失败/用户停止。

3. 全部完成后 向用户汇报总结：共处理 X 项，全部完成 / X 项完成 Y 项失败。

待办展示格式规范#

查询待办后，必须按以下格式展示给用户。格式分两种场景：

场景A：查询单家公司待办#

先显示公司名和记账期，然后用进度条+表格展示所有待办项：

text

**公司名** 记账期：YYYY年M月

| 状态 | 名称 | 说明 |
|:----:|------|------|
| ✅ | 员工信息 | 已添加1位员工 |
| ❌ | 申报5月社保 | 已缴纳社保费¥3,270.00，查看详情 |
| ✅ | 4月份工资单 | 查看工资单 |
| ✅ | 4月份回单 | 已录入3张，已全部录入 |
| ✅ | 4月份销项发票 | 无发票 |
| ✅ | 4月份进项发票 | 无发票 |
| ✅ | 提交审账 | 4月份已提交审账 |

规则：

• 状态列：✅ = 已完成（state=1），❌ = 未完成（state=0）
• 名称列：直接使用 name 字段
• 说明列：直接使用 desc 字段
• 未完成项排在前面，已完成项排在后面
• 表格上方显示进度条（完成数/总数）

场景B：查询多家公司待办汇总#

先显示汇总概览，再逐公司展开：

text

**待办汇总** 共5家公司，5项未完成

| 公司 | 未完成 | 已完成 | 未完成项 |
|------|:------:|:------:|----------|
| 珠海唤嚟科技 | 1 | 6 | 申报5月社保 |
| 珠海秀力科技 | 1 | 6 | 申报5月社保 |
| ... | ... | ... | ... |

若用户追问某公司详情，再切换到场景A格式。

Notes / Limitations#

• 所有金额单位均为元，不是分
• 涉及验证码、税额、用途、垫付人、银行账号等信息时，必须向用户确认，不能自行假设
• 如果 workflow 与 zijizhang-cli 发生冲突，以 zijizhang-cli --help 里面实际参数定义为准；但执行顺序仍应遵守 workflow
• 表格生成规则
  • 必须用标准 Markdown 表格格式
  • 表头、分隔线、内容行 列数必须完全一致
  • 空缺的内容可用空字符串填充
  • 每一列必须对齐，不能缺失