zijizhang-skill

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

When to Use This Skill

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

Non-Negotiable Guardrails

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

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

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

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

• 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

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

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

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

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

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

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

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

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

Execution Order

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

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

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

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：确认登录态与公司上下文

先执行：

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):

pip install --upgrade zijizhang-cli

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

检查版本：

zijizhang-cli --version

Feature Map

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

Usage

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

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. 先执行：

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

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

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

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

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

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

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

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

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

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

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

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

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

待办展示格式规范

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

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

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

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

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

规则：

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

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

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

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

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

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

Notes / Limitations

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