OfficeCLI DOCX技能
让AI智能体通过命令行创建、读取、编辑Word文档，无需安装Microsoft Office。
技能文档要求用户自行安装二进制文件（通过curl/irm管道执行远程脚本），存在供应链风险，但提供了明确的回滚与校验方法（如用officecli --version验证安装），且文档强调数据流透明度（如save/close生命周期、非officecli程序读取前刷新），未发现明显的权限过度或数据外泄风险。但由于发布者未经核实，且安装脚本会执行远程代码，信任维度扣分。证据显示主要风险可见但权限、确认、隔离或恢复机制不完整，故给出15分。
技能文档提供了清晰的命令示例、错误处理建议（如逐步执行、检查退出码）和明确的QA流程（如view issues、validate），但未包含可执行的测试套件或CI验证结果，仅从文档无法确认关键路径可复现。静态审查无法验证实际执行，因此可靠性命中10分。
技能文档明确说明了触发条件（当涉及.docx文件时）、使用场景（创建、读取、编辑Word文档）、能力边界（如不支持计算TOC页码，需要Word刷新）和环境适配（支持多语言，包括中文，但安装脚本依赖海外服务器d.officecli.ai和github.com，在中国大陆网络可能无法访问）。综上，具备清晰的场景但边界和环境证据有限，故给12分。
文档结构清晰，包含安装说明、参数说明、示例和常见问题，并有明确的版本和变更管理（通过CI和npm发布），但缺少维护责任人和更新路径的明确说明，且发布者身份未经核实。文档可读但治理不完全，故给10分。
文档声称能完成创建、读取、编辑Word文档等任务，并提供了示例和验证步骤，但静态审查无法验证输出的直接可用性，且与手动或替代方案的边际价值对比证据不足。按照静态审查规则，有效性最高7分。
文档提供了部分可审计的原始材料（如CI工作流中包含smoke test，涉及创建、添加、get、close等命令，但未覆盖技能的关键路径如TOC、字段等），且没有提交测试套件可供验证。因此可验证性最高5分。
- 安装脚本通过curl/irm管道执行远程代码，存在供应链风险，建议校验发布者身份或下载后手动验证哈希。
- 核心功能依赖海外服务器（d.officecli.ai和github.com），中国大陆网络可能无法访问，影响安装和更新。
- 文档中的示例和验证声称未经独立测试，实际使用前请自行验证。
- 发布者未经官方验证，身份未知，请谨慎对待。
这个 Skill 能做什么，适合哪些场景？
OfficeCLI DOCX技能为AI智能体提供了一个基于命令行的Word文档编辑工具，使用语义路径和属性操作.docx文件，而不是直接操作XML。它支持从零创建文档、读取/解析现有文档、编辑文本和格式、添加表格、图片、页眉页脚、目录、域等，并内置了高质量渲染引擎和验证工具，确保输出文档符合视觉和结构标准。该技能强调帮助优先、增量执行和严格的质量保证流程，适合需要自动化生成或修改Word文档的智能体。
该技能驱动OfficeCLI命令行工具，能够执行以下操作：创建新的.docx文件；读取文档的结构（大纲）、文本、属性和统计信息；编辑段落、样式、表格、图片、图表、域、页眉页脚、目录；支持批处理命令、原始XML操作和文档验证。它通过语义路径（如/body/p[1]）和属性（如text、style、size）操作文档，并提供丰富的帮助命令和查询功能。
- 数据分析师需要从多个.docx报告中提取文本和结构，进行内容分析或汇总。
- 内容创作者想要根据模板自动生成格式化精美的报告或提案文档。
- 开发者在CI/CD流水线中，使用脚本批量修改或生成Word文档。
- AI智能体在生成文档后，需要视觉验证布局，并自动修复格式问题。
- 人力资源部门批量处理简历或合同模板，替换占位符并生成最终文件。
这个 Skill 有哪些优点和局限？
- 无需安装Microsoft Office，单一二进制文件，跨平台。
- 提供语义化命令行接口，比操作原始XML更简单。
- 内置渲染引擎，支持HTML和PNG输出，便于AI视觉验证。
- 强大的QA工具，包括验证、问题列表和视觉检查。
- 完整的文档结构支持，包括表格、图表、域、目录等。
- 需要额外的CLI工具，增加了依赖。
- 对于复杂格式（如复杂数学公式）可能需要使用原始XML，学习曲线较陡。
- 某些功能（如TOC页码计算）需要Word兼容引擎，否则需要人工干预。
- 文档中未提及测试套件或覆盖的Office版本范围。
如何安装这个 Skill？
该技能需要OfficeCLI命令行工具。安装方法：macOS/Linux运行 curl -fsSL https://d.officecli.ai/install.sh | bash，Windows PowerShell运行 irm https://d.officecli.ai/install.ps1 | iex。若失败，可从GitHub Releases下载二进制文件。技能文件存储在仓库的skills/officecli-docx/SKILL.md，可将其内容直接提供给AI智能体。
如何使用这个 Skill？
将技能描述和SKILL.md内容提供给AI智能体。基本工作流：设置文件变量 FILE="your.docx"，使用 officecli create 创建文件，officecli open 打开文件，然后用 officecli add 添加内容，用 officecli set 修改属性，最后用 officecli save 保存并 officecli validate 验证。例如：officecli add "$FILE" /body --type paragraph --prop text="Hello" --prop style=Heading1。