office-env-shell 是一个用于办公场景的工作区命令执行技能，主要用于在 Agent 工作区中运行命令，以支撑 Python 脚本处理、依赖安装和文档格式转换等任务。
用途 适用场景包括：运行 Python 处理 PDF 或表格、使用 pip 安装依赖、调用 pandoc 或 soffice 进行格式转换、批量重命名等。命令默认在工作区目录下执行。
前置检查 使用前需读取工作区 ENV.md 中的 C/D 档与 run 状态。如果尚未探测且任务依赖 run，应通过 office-env-setup 快速探测，或直接向用户确认。若 run 关闭，则不执行命令，改为采用 desktop/Markdown 降级方案，并向用户说明相关配置项。
主要能力与约束 该技能的命令执行受 aistream.tools.file.runEnabled、runTimeoutMs、maxCommandOutputChars 约束。输出过长时会被截断，此时建议将结果写入文件后再读取。资料给出的常见办公命令示例包括：python script.py；pip install --user pypdf pdfplumber python-pptx pandas openpyxl matplotlib；pandoc report.md -o report.docx；soffice --headless --convert-to pdf file.docx。在 Windows 环境下，需要注意路径引号，并优先使用相对于工作区的路径。
使用方式与安全要求 执行前应说明命令原文及其影响，包括会写入哪些文件、是否会联网执行 pip 等；对于删除、pip install、curl 上传等操作，需等用户确认后再运行。失败处理方面：run 被禁用时，参考 office-env-setup 并告知 runEnabled；找不到 python 时，尝试 python3 或 py -3，仍不可用则降级；pip 失败时，记录 stderr，不重复安装，并降级交付；命令不存在时（如 pandoc、soffice、qpdf），改用 Python 或 desktop 路径；超时时，拆分小脚本或增大 runTimeoutMs（需用户修改配置）。依赖对照可参考 office-env-setup 的任务降级表。
限制 禁止执行 rm -rf /、格式化磁盘、修改防火墙等危险操作，禁止未经确认就执行全局 pip install。