OfficeCLI 技能
AI 代理通过单二进制工具读写和编辑 Word、Excel、PowerPoint 文件，无需安装 Office。
证据显示工具支持审查标记（mark/unmark）、批量操作有原子回滚、文档保护有绕过选项（--force），且无明显的恶意行为或数据外泄。但最大风险在于安装方式：推荐通过 curl 管道到 bash 或 PowerShell 直接执行远程脚本（https://d.officecli.ai/install.sh），缺乏固定的校验和或签名验证，且安装脚本会修改 PATH 并自动安装到多个 AI 代理，权限较大，用户未确认即执行。发布者未验证，来源身份不明。因此信任维度不能给高分，扣分原因：远程脚本安装风险、无校验和、自动修改系统配置、发布者未验证。
文档提供了大量命令和示例，但未包含任何测试套件或 CI 配置（未在提供文件中看到），因此无法从静态审查中验证关键路径是否真实可用。安装脚本本身可能失败或损坏，缺少错误处理说明。文档中多处提到'确认活体'但无实际证据。因此可靠性只能给低分，扣分原因：无测试证据、无 CI、关键路径仅凭文档说明。
技能针对明确的场景（AI 代理创建/编辑 Office 文档），使用范围清晰，有 L1/L2/L3 层次和专用技能指引。但语言支持主要面向英文和部分国际化，中文文档存在（README_zh，CONTRIBUTING.zh），但技能文件本身为英文。环境适配：安装依赖海外服务器（d.officecli.ai），可能在中国大陆网络不可达，且未提供国内镜像。触发条件较明确，但有过度声称（如'世界第一'）。因此给中等分，扣分原因：中文支持不完整、海外依赖、可能触发不准确。
文档结构良好，有分层架构（L1/L2/L3），提供安装、使用示例、常见陷阱、专门技能列表。许可证明确为 Apache-2.0，有贡献指南（CONTRIBUTING.md）维护责任明确（维护者管理）。但缺少版本号、变更日志或明确的更新路径；安装脚本未提供校验和。总体可读性好，但一些隐藏假设（如需要网络）未说明。因此给高分但不给满分，扣分原因：缺少版本/变更日志、安装依赖网络未明示。
文档声称能完成创建、读取、编辑、验证等任务，并提供了端到端工作流示例，输出格式为 JSON 结构化，适合 AI 使用。但静态审查无法验证实际效果，文档中的承诺可能夸大（如'最佳'），且依赖网络安装，若失败则无法完成任务。因此有效性给中等分，扣分原因：静态审查无法验证、依赖网络安装、输出可能需人工复核。
没有提供任何测试结果、CI 状态或独立第三方验证证据。安装脚本和二进制文件未提供哈希值或签名，无法验证来源。文档中虽有示例但不足以证明真实性。因此可验证性极低，扣分原因：无测试证据、无哈希/签名、仅作者声称。
- 安装方式存在高风险：`curl ... | bash` 和 `irm ... | iex` 会直接执行远程脚本，无校验和或签名验证，可能安装被篡改的二进制或执行恶意代码。建议先下载脚本审阅，或使用包管理器（如 brew/npm）安装，并验证官方发布的哈希。
- 自动更新和自动安装到多个 AI 代理（如 Claude Code、Cursor）会修改系统配置，可能在未明确告知用户的情况下改变代理行为。建议在安装时明确提示用户并允许选择禁用。
- 功能依赖海外服务器（如 d.officecli.ai）进行安装和更新，中国大陆用户可能因网络限制无法访问，且未提供国内镜像或离线包，导致安装失败或功能受限。建议提供国内下载源或代理方案。
- 文档中的功能声称（如'世界第一'、'最佳'）缺乏独立验证，应根据实际测试谨慎评价。
- 存在 `--force` 选项可绕过文档保护，可能被滥用；使用时应确保有授权。
这个 Skill 能做什么，适合哪些场景？
OfficeCLI 是一个面向 AI 代理的 Office 套件，提供单一二进制文件，无需安装 Microsoft Office 即可处理 .docx、.xlsx 和 .pptx 文件。它提供分层操作：读取视图（L1）、DOM 编辑（L2）和原始 XML 操作（L3），并支持结构化 JSON 输出。该技能帮助代理创建、检查、修改 Office 文档，包括添加图表、检查格式问题和批量操作。由于自带 HTML 渲染引擎，代理可以预览文档并修复视觉问题。
该技能通过 officecli 命令行工具提供完整文档操作：创建空白文档、读取文本/结构/统计/问题、以 JSON 获取节点、查询元素、修改属性（颜色、字体、布局）、添加/删除/移动元素、批处理多个操作、基于模板合并生成文档，以及通过 watch 实时预览。它支持从 L1 读取到 L3 原始 XML 编辑的三层操作。
- 报告自动化：开发者从数据库或 API 生成 Word 报告，自动填充数据。
- 批量处理：对大量文档执行查找替换或样式更新，例如替换所有 Heading1 文本。
- 演示文稿生成：AI 代理根据用户提示生成幻灯片，并立即预览以检查布局。
- 数据提取：从 Excel 或 Word 文档中提取结构化数据并输出为 JSON，供其他系统使用。
- 文档质量检查：在交付前验证文档并列出问题（格式、内容、结构）。
- 模板合并：使用 JSON 数据填充多个文档模板，生成一致的报告或发票。
这个 Skill 有哪些优点和局限？
- 单一二进制，无需安装 Office，跨平台（macOS、Linux、Windows）
- 分层设计（L1/L2/L3）允许从简单读取到深度 XML 编辑
- 内置渲染引擎生成 HTML/PNG 预览，帮助代理可视化并修复布局问题
- 结构化 JSON 输出，便于程序化处理
- 批处理模式原子性，支持失败回滚
- 模板合并和 dump 往返支持重用现有文档，节省 token 成本
- 需要安装外部二进制，首次使用需网络下载
- 高级功能（如某些图表、动画）可能有学习曲线
- 非 Office 格式（如 .doc、.hwpx）需要插件支持
- 文档提到某些平台（如 xlsx 的选择功能）未完全覆盖
- 没有提到官方测试套件或质量标准
如何安装这个 Skill？
安装 officecli 二进制：macOS/Linux 运行 curl -fsSL https://d.officecli.ai/install.sh | bash，Windows PowerShell 运行 irm https://d.officecli.ai/install.ps1 | iex。验证版本：officecli --version。安装后，agent 的 SKILL.md 会自动检测并配置 AI 工具。
如何使用这个 Skill？
直接使用 CLI 命令。例如创建幻灯片：officecli create deck.pptx，添加幻灯片：officecli add deck.pptx / --type slide --prop title="Q4 Report"。查看帮助：officecli help docx paragraph 以获取属性。为了实时预览，使用 officecli watch deck.pptx。对于复杂流程，使用批处理：officecli batch data.xlsx --input updates.json --json。
这个 Skill 与同类方案有什么区别？
与 python-docx、openpyxl 等库相比，OfficeCLI 提供统一的 CLI 和 JSON 输出，无需编写 Python 代码；与 LibreOffice 相比，它更轻量且面向 AI 代理。