Poffice Office Craft 是一个智能体技能，用于在安装了 ArtCraft 命令行工具和 office-api 的 Poffice 主机上创建与编辑办公文档。
用途
该技能主要处理 Word、Excel、PowerPoint 和 PDF 的创建或编辑。它将文档发布到 Drive 并返回一个 Office open_url，便于用户在浏览器中打开和编辑。资料建议：富格式化需求使用 Craft CLI/MCP；简单模板可使用 Office API 加智能体密钥。
主要能力
服务器上提供四组命令行工具及对应 MCP 服务：Word 对应 wordcraft-cli 与 wordcraft-cli mcp；Excel 对应 gridcraft-cli 与 gridcraft-cli mcp；PowerPoint 对应 deckcraft-cli 与 deckcraft-cli mcp；PDF 对应 pdfcraft-cli 与 pdfcraft-cli mcp --root DIR。安装路径为 /opt/craft-cli/bin/，也可通过 /usr/local/bin 在 PATH 中调用。MCP 的输入输出根目录为 craft-workspace/（含 in/、out/）。
使用方式
鉴权方面，发布到 Drive 需要 API key。可由管理员在 Workspace → Settings → Agent API tokens 创建长期密钥，或使用主机上的 bootstrap 环境变量 POFFICE_AGENT_TOKEN。需设置 OFFICE_API_URL（如 https://office.poffice.online 或 http://office-api:8090）与 POFFICE_AGENT_TOKEN，并注意不要提交密钥。可用 curl 请求 /api/auth/agent 校验密钥。
在 Cursor 等 MCP 客户端中，项目配置位于 .cursor/mcp.json，包含 wordcraft、gridcraft、deckcraft、pdfcraft 四个服务器，安装后需重新加载 MCP。也可通过 claude mcp add 注册，例如为 wordcraft 指定 automation-read-root 与 automation-write-root。
命令行示例包括：wordcraft-cli convert craft-workspace/in/notes.txt craft-workspace/out/notes.docx；gridcraft-cli convert craft-workspace/in/data.csv craft-workspace/out/data.xlsx；gridcraft-cli eval '=SUM(1,2,3)'；deckcraft-cli --help 与 pdfcraft-cli --help。
发布到 Drive 并获取 open_url 有两种方式：使用辅助脚本 python3 scripts/poffice_office.py create-pptx 生成演示文稿，或用 publish 子命令发布已有文件；也可直接 POST /api/documents，携带 X-Api-Key 与 kind（pptx、docx、xlsx、pdf）。拿到返回的 open_url 后，用户登录 workspace 即可在浏览器中编辑。
推荐流程为：先用 Craft MCP 或 CLI 创建/编辑文档并输出到 craft-workspace/out/，再用 poffice_office.py publish 或 POST /api/documents 发布，最后把 open_url 交给用户。保存内容会自动同步到 Drive 与 Docs（Paperless）。
适用场景
适合需要由智能体自动生成或修改办公文档、并将结果发布到 Drive 供人工查看和继续编辑的流程，例如批量转换文本/CSV 为文档与表格、计算表格表达式、生成演示文稿以及产出 PDF。
限制
资料未提供具体价格、平台兼容范围、性能指标或详细使用步骤，相关内容暂未提供。该技能依赖已安装的 ArtCraft CLI 与 office-api 主机环境，发布到 Drive 需要有效的智能体 API key，密钥不应写入代码库。