Skill: shootofficial/zijizhang-workflow (version 0.0.4)

--- name: zijizhang-skill description: 本技能用于协助用户在「自记账」App 完成记账、报税与报表查询相关操作，支持绑定自记账账号、管理公司员工、银行回单入账、发票入账、生成报税工资单、处理社保申报、审账待办与资产负债表查询。即便用户未明确提及「自记账」App，只要需求涉及上述记账、入账、报税、报表查询或待办处理，也应触发此技能。 version: 0.0.4 --- # 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:` 值作为参数： ```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>' ``` 2. 待办分为**主流程**和**独立流程**两类： **主流程（严格按顺序逐项处理，前一项完成后再进入下一项）：** | 顺序 | 代办类型 | 说明 | 处理原则 | | --- | --- | --- | --- | | 1 | `EMPLOYEE` | 员工 | 先查 `get_employee_list`；若缺员工或入职日期不符合，再向用户确认后新增/修改 | | 2 | `PAYROLL` | 工资单 | 严格按照 `workflow/payroll.md` | | 3 | `BANK` | 回单/流水 | 严格按照 `workflow/bank.md` | | 4 | `SALES` | 销项发票 | 严格按照 `workflow/invoice_sales.md` | | 5 | `INCOME` | 进项发票 | 严格按照 `workflow/invoice_income.md` | | 6 | `AUDIT` | 审账 | 严格按照 `workflow/audit.md`（必须所有主流程前置项完成后才能审账） | **独立流程（用户要求时单独处理，不阻塞主流程）：** | 待办类型 | 说明 | 处理原则 | | --- | --- | --- | | `SOCIAL_SECURITY` | 社保 | 严格按照 `workflow/social_security.md` | | `GS` | 个税 | 严格按照 `workflow/individual_tax.md` 执行，会有多个月份的待办需逐一处理 | 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 表格格式 - 表头、分隔线、内容行**列数必须完全一致** - 空缺的内容可用空字符串填充 - 每一列必须对齐，不能缺失


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal:  | SkillSpector: suspicious (CRITICAL)