skill-doc-delivery

宿主：Codex CLI — 此技能最初为 Claude Code 设计，后适配至 Codex。 交叉引用命令在 Codex 中使用已安装的技能名称，而不是 /octo:* 斜杠命令。 请使用当前 Codex shell 和子 Agent 工具。在当前会话尚未提供相应功能前，不要声称某个提供商、模型或宿主子 Agent 可用。 有关宿主工具的等效项，请参阅 skills/blocks/codex-host-adapter.md。

为知识工作者交付文档

将知识工作成果从 Markdown 转换为专业的办公文档（DOCX、PPTX、XLSX）。

概述

此技能可帮助你将知识工作成果转换为精致、可交付的文档：

• 共情之后 → 将用户画像导出为 PPTX 演示文稿，或将需求导出为 DOCX 规格文档
• 提供建议之后 → 将战略分析转换为 PPTX 演示文稿或 DOCX 商业案例
• 综合之后 → 以 DOCX 学术格式或 PDF 生成文献综述

前置条件检查

转换文档前，请确认已安装 document-skills 插件：

/plugin list | grep document-skills

如果未安装：

/plugin install document-skills@anthropic-agent-skills

根据工作流推荐格式

共情工作流 → UX 研究成果

最适合 PPTX（PowerPoint）：

• 面向利益相关者演示的用户画像演示文稿
• 用户旅程图可视化
• 研究综合要点
• 执行摘要

最适合 DOCX（Word）：

• 详细的用户画像文档
• 研究需求规格说明
• 访谈记录与分析
• 用户故事文档

提供建议工作流 → 战略分析

最适合 PPTX（PowerPoint）：

• 面向领导层的战略演示文稿
• 市场分析演示文稿
• 竞争情报简报
• 商业案例提案演示文稿
• 董事会演示文稿

最适合 DOCX（Word）：

• 全面的商业案例
• 战略建议报告
• 市场研究文档
• 财务分析报告

综合工作流 → 研究综合

最适合 DOCX（Word）：

• 文献综述论文
• 研究综合报告
• 学术研究文档
• 注释书目
• 技术白皮书

最适合 PDF：

• 最终出版物
• 存档版本
• 可分享的研究报告

转换指南

步骤 1：定位源 Markdown

知识工作成果存储在：

~/.claude-octopus/results/

列出近期成果：

ls -lht ~/.claude-octopus/results/ | head -10

步骤 2：根据用途选择格式

请自问：

• 要向利益相关者进行演示？ → PPTX（直观、简洁）
• 需要编写全面的文档？ → DOCX（详细、结构清晰）
• 要发布最终版本？ → PDF（便于存档、不可更改）
• 涉及数据/框架？ → XLSX（表格、计算）

步骤 3：使用 Document-Skills 插件

document-skills 插件提供以下功能：

适用于 DOCX（Word）：

Use the /document-skills:docx skill to convert markdown to Word format.
Supports headings, lists, tables, and formatting.

适用于 PPTX（PowerPoint）：

Use the /document-skills:pptx skill to convert markdown to PowerPoint.
Each ## heading becomes a slide, bullet points auto-format.

适用于 PDF：

Use the /document-skills:pdf skill to generate PDF documents.
Ideal for final deliverables and archival.

步骤 4：应用专业样式

转换后，请考虑：

• 格式统一 - 使用标题样式和项目符号层级
• 视觉层级 - 重要内容在前，细节在后
• 品牌一致性 - 按需添加徽标、颜色和字体
• 可读性 - 拆分长段落，适当留白

常见转换模式

模式 1：单个工作流 → 单个文档

用户运行了一个工作流，希望生成一份文档：

User: "Export my latest synthesis to a Word document"

1. Check ~/.claude-octopus/results/ for most recent .md file
2. Identify it's from synthesize workflow
3. Recommend DOCX for academic report format
4. Use document-skills:docx to convert
5. Save to appropriate location

模式 2：多个章节 → 演示文稿

用户希望根据研究内容制作演示文稿：

User: "Create a PowerPoint from this research"

1. Locate the research markdown
2. Identify key sections (## headings)
3. Use document-skills:pptx to convert
4. Each ## heading becomes a slide
5. Recommend adding title slide and summary

模式 3：批量转换

用户需要多种格式：

User: "Create both a Word doc and PowerPoint from this strategy"

1. Locate source markdown
2. Convert to DOCX using document-skills:docx
3. Convert to PPTX using document-skills:pptx
4. Provide both file paths

专业样式技巧

DOCX（Word）最佳实践

• 使用内置标题样式（Heading 1、Heading 2 等）
• 文档超过 5 页时添加目录
• 适当使用项目符号和编号列表
• 添加页码、页眉和页脚
• 在开头添加执行摘要
• 使用表格呈现结构化数据

PPTX（PowerPoint）最佳实践

• 每张幻灯片只讲一个核心观点
• 使用包含作者和日期的标题幻灯片
• 每张幻灯片最多列出 5-7 个要点
• 使用统一的字体和颜色
• 添加幻灯片编号
• 添加总结/后续步骤幻灯片
• 尽可能使用视觉元素（图表、示意图）

PDF 最佳实践

• 最终审核后再从 DOCX 转换
• 确保嵌入所有字体
• 针对屏幕或打印进行优化
• 添加元数据（标题、作者、关键词）
• 使用书签方便导航

示例工作流

示例 1：用户体验研究用户画像演示文稿

Input: ~/.claude-octopus/results/empathize-session-2026-01-18.md

Output Goal: Stakeholder presentation

Steps:
1. Read the empathize markdown
2. Extract persona sections
3. Convert to PPTX using document-skills:pptx
4. Each persona becomes a slide
5. Add title slide and key insights summary
6. Save as "UX-Personas-2026-01-18.pptx"

示例 2：战略商业论证

Input: ~/.claude-octopus/results/advise-market-analysis-2026-01-18.md

Output Goal: Comprehensive business case document

Steps:
1. Read the advise markdown
2. Structure as: Executive Summary, Analysis, Recommendations, Appendix
3. Convert to DOCX using document-skills:docx
4. Add table of contents
5. Format tables and charts properly
6. Save as "Market-Analysis-Business-Case-2026-01-18.docx"

示例 3：文献综述论文

Input: ~/.claude-octopus/results/synthesize-ai-safety-2026-01-18.md

Output Goal: Academic paper format

Steps:
1. Read the synthesize markdown
2. Structure as: Abstract, Introduction, Literature Review, Gaps, Conclusions
3. Convert to DOCX using document-skills:docx
4. Apply academic formatting (citations, references)
5. Export to PDF for final version
6. Save as "AI-Safety-Literature-Review-2026-01-18.pdf"

处理边缘情况

没有近期工作流输出

如果用户请求导出，但尚未运行工作流：

Response: "I don't see any recent knowledge work outputs. Would you like to run:
- /octo:empathize (UX research)
- /octo:advise (strategic analysis)
- /octo:synthesize (literature review)

Then I can convert the results to your preferred format."

未指定格式

如果用户未指定格式：

Response: "I can convert this to:
- DOCX (Word) - Best for detailed documentation
- PPTX (PowerPoint) - Best for presentations
- PDF - Best for final deliverables

Which format would you prefer based on your use case?"

多个 Markdown 文件

如果存在多个输出文件：

Response: "I found several knowledge work outputs:
1. empathize-personas-2026-01-15.md (3 days ago)
2. advise-market-analysis-2026-01-18.md (today)
3. synthesize-research-2026-01-10.md (8 days ago)

Which would you like to convert?"

未安装 Document-Skills

如果缺少插件：

Response: "The document-skills plugin is required for conversion.
Install it with:

/plugin install document-skills@anthropic-agent-skills

Then I can convert your knowledge work to office formats."

与知识模式集成

此技能旨在与三种知识模式工作流无缝协作：

Knowledge Work Flow:
1. Run workflow: /octo:empathize (or advise/synthesize)
2. Review markdown output in ~/.claude-octopus/results/
3. Request conversion: "Export to PowerPoint"
4. This skill is used after explicit invocation
5. Professional document delivered

最佳实践

1. 转换前先审核 - 先检查 Markdown 质量
2. 选择合适的格式 - 根据受众和目的选择格式
3. 补充上下文 - 包含日期、作者和版本号
4. 测试兼容性 - 确保接收者能够打开该格式
5. 归档源文件 - 保留原始 Markdown 文件
6. 版本控制 - 使用包含日期的描述性文件名

命令速查

# List recent knowledge work outputs
ls -lht ~/.claude-octopus/results/ | head -5

# Check document-skills installed
/plugin list | grep document-skills

# Install document-skills
/plugin install document-skills@anthropic-agent-skills

# View specific markdown
cat ~/.claude-octopus/results/[filename].md

获取帮助

如有以下问题：

• 文档转换 → 询问特定格式的需求
• 知识工作流 → 参见 /octo:knowledge-mode
• Document-Skills 功能 → 参见 /document-skills:* skills
• 样式和格式 → 询问各格式的最佳实践

适用于 claude-octopus v7.3.0+ 的文档交付技能