ZJZ Workflow — ZJZ 工作流程

zijizhang-skill 是一款专业的记账报税工具，可以完成记账、入账、报税、报表查询与待办处理。

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

不可商量的守则： 以下规则必须严格遵守，优先级高于经验判断： 绝不臆造数据。 只允许使用三类数据推进写操作：用户明确提供的数据、CLI 返回的数据、按 workflow 明确允许推导出的值 只要是写操作，必须先向用户确认。 写操作包括但不限于：employee add_employee、employee update_employee、payroll create_payroll、invoice set_month_no_sales_invoice 等 确认时必须回显关键提交内容。 至少回显以下信息后，再等待用户确认：当前公司 uid 或当前激活公司、操作对象、准备提交的关键字段与字段来源 不得为了凑齐参数而自行补值。 如果 CLI 需要的字段缺失，必须停下来并向用户说明缺了什么，或者先调用 workflow 中要求的上游查询命令补齐。 禁止绕过 skill 既定流程。 优先读文档，再执行命令。 顺序固定为：先匹配场景、再打开对应 workflow、再打开对应 CLI 文档、最后执行命令 每次写操作后必须立即校验结果。 至少检查返回 code，code!=200 时停止后续流程，反馈 msg

执行顺序： 每次进入本 skill，按下面顺序推进： Step 0：校验 Skill 版本（建议） 执行任务前先校验 zijizhang-skill 是否有更新 处理规则（详见 references/check_skill_update.md） code != 200：不阻塞用户业务请求，继续按当前版本执行，并告知"远端查询失败，本次跳过更新检查" code == 200 且 data.latest 高于当前版本：必须提示用户按 data.installation_guide_url 升级/覆盖安装 must_be_update == true：必须强提醒用户先升级，再继续可能受版本影响的关键流程 Step 1：确认登录态与公司上下文 先执行：zijizhang-cli account get_cpy_list 说明：get_cpy_list.data[].pending_todo_cnt 会返回每个公司未完成代办数量 判断规则： 若返回 code=200 且存在当前激活公司：记录激活 uid，继续 若 token 失效、未登录或未绑定：严格按“绑定账号步骤”执行 若需要切换公司：先按 references/switch_to.md 执行 account switch_to '' 切换公司完成后的第一件事必须执行 todo get_todo_list --uid='' 获取该公司的待办明细，再进入后续 workflow Step 2：识别任务类型并打开对应 workflow 按场景选择：工资单、销项发票、进项发票、发票上传、社保、个税、报表查询 如果任务是待办处理，先 todo get_todo_list，再根据待办类型进入对应 workflow。 Step 3：打开对应 CLI 文档 执行具体命令前，先读对应文档：命令格式、必填参数、返回结构，以 references/.md 为准 不允许跳过文档直接凭记忆或 --help 自行探索 Step 4：先查后写 先做读取型查询，拿到真实上下文 再整理提交参数 再向用户确认 最后执行写操作

附加资源： Workflow：workflow/.md CLI 文档：references/*.md Skill 更新（Agent 流程）：references/auto_update.md 依赖： Python packages（install once）：pip install --upgrade zijizhang-cli 要求：zijizhang-cli 版本需为 0.0.28 及以上 检查版本：zijizhang-cli --version

功能映射： 以下命令仅作为能力索引；真正执行时，仍必须回到对应 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 '' references/switch_to.md account 退出登录 zijizhang-cli account logout references/logout.md employee 获取员工列表 zijizhang-cli employee get_employee_list --uid='' --keyword='' references/get_employee_list.md employee 添加员工 zijizhang-cli employee add_employee '' --uid='' references/add_employee.md employee 修改员工信息 zijizhang-cli employee update_employee '' '' references/update_employee.md payroll 获取工资单创建状态 zijizhang-cli payroll get_payroll_creation_status '' --uid='' references/get_payroll_creation_status.md payroll 获取预览工资单 zijizhang-cli payroll get_preview_payroll '' --uid='' references/get_preview_payroll.md payroll 创建工资单 zijizhang-cli payroll create_payroll '' '' --uid='' references/create_payroll.md payroll 获取工资单 zijizhang-cli payroll get_payroll '' --uid='' references/get_payroll.md payroll 删除工资单 zijizhang-cli payroll remove_payroll '' --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 '' '' --uid='' references/set_month_no_sales_invoice.md invoice 标记无进项发票 zijizhang-cli invoice set_month_no_invoice --uid='' '' '' references/set_month_no_invoice.md invoice 确认收到的发票已全部录入完成 zijizhang-cli invoice check_invoice_over --uid='' '' '' references/check_invoice_over.md invoice 上传发票文件 zijizhang-cli invoice upload_invoice_file --uid='' --file='' references/upload_invoice_file.md