前言¶
泛微 E-cology（E9）的审批仍主要在 OA 与企微里完成：查待办要切系统，看表单、关联事前申请、合同区块和审批记录往往要再开浏览器。若希望在与 AI 的对话里用自然语言拉列表、看完整详情，并在受控条件下执行通过/驳回/转发，需要一套把 OA 接口与 CLI 约定写进 Skill 的集成方式。下面介绍 SkillHub 上的 泛微OA审批Skill（@user_ab9d114c/yoa-audit-manager），它围绕 oa-audit-cli 封装企微扫码登录、流程列表与详情等能力；官方说明要求配置 OA 域名并完成扫码登录，且 requires_api_key=false，无需单独申请 API Key。
这是什么¶
泛微OA审批Skill 是社区发布、分类为 business-ops 的 Agent Skill（当前版本 v1.0.1，来源 community，发布者 user_ab9d114c）。一句话定位：在 Agent 会话中通过 oa-audit-cli 访问泛微 E-cology 审批相关数据与有限写操作，登录方式为企微二维码扫码。
它与已弃用的 ysb-oa-audit-manager 命名无关；安装与引用时应使用坐标 @user_ab9d114c/yoa-audit-manager，底层 CLI 为 oa-audit-cli（勿与旧 Skill 名混用）。
核心功能¶
以下能力来自 Skill 说明，并与 SkillHub 简介「E9-OA 审批、域名与扫码登录」一致。
登录与访问¶
- 配置 OA 域名后，通过 企微扫码完成登录（WeCom QR login）。
- 表单详情以接近浏览器的方式呈现，并提供 OA 浏览器访问链接（
viewUrl），便于对照线上页面。
流程列表¶
使用专用子命令拉取各类列表，不要用 workflow-todo 拉完整待办列表（该命令不适用于全量列表场景）。应使用：
| 场景 | 子命令 |
|---|---|
| 待办（在办） | workflow-doing |
| 已办 | workflow-done |
| 我发起 | workflow-my |
| 抄送 | workflow-cc |
流程详情¶
| 场景 | 子命令 |
|---|---|
| 待办详情 | workflow-todo-detail |
| 已办详情 | workflow-done-detail |
| 我发起详情 | workflow-my-detail |
| 抄送详情 | workflow-cc-detail |
| 通用流程详情 | workflow-detail |
详情输出通常包含：审批流表格（审批记录）、附件、发票（支持 OCR 识别）、关联事前申请（--with-related）、合同信息区块（是否有合同、合同原件、合同审批单）、流程监控等。
关联事前申请：对上述详情类命令，默认会展开嵌套的事前申请详情；若不需要，加 --no-with-related 跳过。
「待办及详情」：用户明确要求待办及详情时，必须执行 workflow-todo-detail，并将 完整 stdout 原文粘贴返回，不得摘要省略。
审批写操作¶
在 Skill 约定的门禁策略下，支持对单个流程执行通过、驳回、转发（approve / reject / forward），避免误操作批量流程。
触发关键词（Agent 选用本 Skill 的典型说法）¶
用户提到 OA 审单、YSB OA、待办/已办/我发起、抄送、事前申请、关联流程、合同信息、流程监控、发票识别、workflow-doing / workflow-done / workflow-cc 等表述时，Agent 应按 Skill 规则选用对应 CLI 子命令。
安装与启用¶
通过 SkillHub CLI 安装¶
先确认本机已安装 skillhub（安装方式见 SkillHub 安装说明）。安装技能时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。
command -v skillhub && skillhub --version
skillhub install @user_ab9d114c/yoa-audit-manager --dir <你的 Agent skills 目录>
常见路径示例（以官方安装文档为准）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
通过对话让 AI 安装¶
SkillHub 页面提供的提示词为：请根据 https://skillhub.cn/install/skillhub.md ，安装 @user_ab9d114c/yoa-audit-manager。
安装完成后，按 Skill 要求准备 OA 域名，并在首次使用时完成 企微扫码登录。
典型用法¶
下列为 Skill 规则下的可复现思路；具体参数以你环境中的 oa-audit-cli 帮助输出为准。
1. 查待办列表
在对话中说「列出 OA 待办」或让 Agent 执行 workflow-doing，不要用 workflow-todo 代替全量待办列表。
2. 看待办完整详情（含关联事前申请）
# 示意：Agent 在 Shell 中调用 oa-audit-cli 的 workflow-todo-detail
oa-audit-cli workflow-todo-detail <流程标识相关参数>
用户要「待办及详情」时，Agent 须将命令 完整标准输出贴回对话，不做概括。
3. 已办 / 我发起 / 抄送
- 已办详情：
workflow-done-detail - 我发起详情：
workflow-my-detail - 抄送列表与详情：
workflow-cc、workflow-cc-detail
4. 跳过关联事前申请
oa-audit-cli workflow-todo-detail ... --no-with-related
5. 在门禁允许时审批单条流程
在确认流程身份与操作意图后，使用 Skill 规定的单流程通过/驳回/转发能力（非批量）。
适用场景与注意¶
适合谁
- 日常在泛微 E9-OA 处理审批、需要把「查列表—看详情—对照合同与事前申请」放进 Cursor / Claude Code 等 Agent 工作流的人。
- 希望通过企微扫码而非手写 Cookie 脚本维持会话的团队（仍以 Skill 与 CLI 实际行为为准）。
限制与坑
- 域名与登录：未配置 OA 域名或未完成企微扫码，后续子命令无法正常工作。
- 列表与详情命令分工：全量列表用
workflow-doing/workflow-done/workflow-my/workflow-cc；不要用workflow-todo当列表入口。 - 视图参数：不要将
tabid作为--view传入。 - 详情完整性：
workflow-todo-detail等场景下，默认带关联事前申请；需要精简时用--no-with-related。 - 弃用名称：不要使用已弃用的
ysb-oa-audit-manager指代本 Skill。 - 写操作：通过/驳回/转发仅针对单流程且在 Skill 门禁下执行，避免在对话中模糊确认就批量操作。
SkillHub 页面统计（访问时快照）：评分 100000，下载 2169 次；标签 requires_api_key=false。
结尾¶
泛微OA审批Skill 把 E9-OA 的待办、已办、我发起、抄送与详情（含审批记录、附件、发票 OCR、合同与事前申请关联）收敛到 oa-audit-cli 与统一 Skill 规则里，适合在 Agent 里用口语化需求驱动查询，并在规则约束下处理单条审批。安装与说明以 SkillHub 为准：
- 技能页：https://www.skillhub.cn/skills/user_ab9d114c/yoa-audit-manager
- API 坐标页：https://api.skillhub.cn/user_ab9d114c/yoa-audit-manager
