优E通-税务零申报
下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-out31vpi--youyitong-shuiwulingshenbao.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-out31vpi/youyitong-shuiwulingshenbao。- 通过优E通(YYT)办理与查询税务事项:报税、零申报、查询申报状态与任务记录、同步申报信息、登录电子税务局/税局、组织与税号及登录号管理、代扣代缴申报。当用户提到报税、零申报、税号、税局、登录号或"
- 优E通"
- 等,或用口语要求查/报某月税款时使用。适用于税务零申报场景。需用户已在 https://portal-new.yoyitong.com 注册并取得 API-KEY。
阅读全文 (展开查看完整说明)
概述
优E通 (YYT) 税务技能
两层结构:api/(原子 HTTP 接口) → workflow/(执行单元:路由 + 前置 + 调 API + 渲染)。
4 个 preflight workflow(选组织 / 选税号 / 选登录号 / 选个税单位)与业务 workflow 同层,被多个 workflow 复用。
workflow/_index.md集中维护触发词、必填槽位反问规则与路由总表。
何时调用我
出现以下任一信号时调用本技能:
- 关键词:"报税"、"申报"、"零申报"、"税号"、"税局"、"税企"、"个税"、"登录号"、"登录税局"
- 业务动作:查询组织/税号、切换组织/税号、查询申报情况、提交零申报、税局登录、个税单位管理、查询财务报表年报
- 产品名词:"优E通"、"YYT"、"yoyiitong"
调用流程(两层走法)
- 取 API-KEY:从记忆中读
yyt-api-key;不存在 → 提示用户输入并写入记忆 - 识别意图:读
workflow/_index.md的「路由总表」找到命中 workflow - 抽取槽位:根据命中 workflow 的「输入槽位」表,缺失必填项 → 按
_index.md §1反问直到合法 - 级联前置:执行 workflow 依赖的
select-*.md,获取上下文变量($ORG_ID、$TAX_ENTITY_ID、$PHONE_NO等) - 调 API:按 workflow 的「执行步骤」+
api/中的端点定义发起请求 - 格式化输出:严格使用
api/_enums.md中的映射,列表用 Markdown 表格,禁止空白表格;含图片按_index.md §4公式渲染
全局规则
| # | 规则 |
|---|---|
| 1 | 所有响应按 Content-Type: application/json; charset=utf-8 处理;非 JSON/超时统一报错,不 echo 英文 message |
| 2 | 列表 data 为空数组 → 友好提示("暂无数据"),禁止空白表格 |
| 3 | 组织/税号/个税单位名匹配:模糊相似度 + 唯一匹配自动取;多条疑似 → 列全表让用户选;零匹配 → 反问 |
| 4 | 年月、手机号、税号、数字必做格式校验,非法反复追问 |
| 5 | 同轮对话缓存组织ID、税号ID、登录号身份ID等变量复用;跨轮不缓存 |
| 6 | 写操作前必展示 body + 用户明确确认,涉及:新建税号、新建登录号、提交零申报、同步申报、新增雇员等 |
| 7 | 401 / 无权限 → 提示重新配置 yyt-api-key,不重试 |
目录速查
.
├── api/ # ① 原子 HTTP API(一文件 = 一个 endpoint)
│ ├── _conventions.md # 全局约定(认证、错误、重试、参数校验、上下文变量)
│ ├── _enums.md # 公共枚举(身份类型、地区代码、状态码映射)
│ ├── organizations/ # /base/* 组织接口(2 个 endpoint)
│ ├── tax-entities/ # /tax/* 税号接口(3)
│ ├── tax-accounts/ # /tax/* 税局登录号接口(3 + 4 个 auth endpoint)
│ ├── declarations/ # 申报、任务记录接口(4)
│ ├── financial-statements/ # 财务报表接口(1)
│ └── personal-tax/ # 个税单位、代扣代缴、生产经营接口(14)
│
└── workflow/ # ② 执行层:preflight + 业务 workflow(同一层)
├── _index.md # 路由总表 + 必填反问规则 + 反触发 + 图片公式 + 依赖图
├── select-organization.md # preflight(被多个业务 workflow 复用)
├── select-tax-entity.md
├── select-tax-account.md
├── select-personal-tax-unit.md
└── *.md # 共 27 个业务 workflow两层职责边界
| 层 | 输入 | 输出 | 不应包含 |
|---|---|---|---|
| api/ | HTTP 端点 | 原子调用模板(method/path/headers/body/response) | 业务判断、用户话术、流程编排 |
| workflow/ | 自然语言 + 上下文 | 用户可见输出(表格/话术/图片) | HTTP 端点字段细节(已在 api 完成)、新触发词列举(已归 _index.md) |