技能文档交付
- 作者仓库星标 3,406
- 作者仓库 claude-octopus
- 领域
- 文档
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @nyldn · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 命令执行
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
第 1 步:找到 Markdown 源代码
知识工作输出存储在: 列出最近的输出:
第 2 步:根据目的选择格式
问问自己:向利益相关者展示? → PPTX(直观、简洁) 全面的文档? → DOCX(详细、结构化) 最终发布? → PDF(存档,不可更改)数据/框架? → XLSX(表格、计算)
第 3 步:使用文档技能插件
文档技能插件提供以下功能: 对于 DOCX (Word): 对于 PPTX (PowerPoint): 对于 PDF:
第 4 步:应用专业造型
转换后,请考虑: 一致的格式 - 使用标题样式、项目符号层次结构 视觉层次结构 - 先要点,后细节 品牌对齐 - 根据需要添加徽标、颜色、字体 可读性 - 分解长段落,使用空格
> **Host: Codex CLI** — This skill was designed for Claude Code and adapted for Codex.
> Cross-reference commands use installed skill names in Codex rather than `/octo:*` slash commands.
> Use the active Codex shell and subagent tools. Do not claim a provider, model, or host subagent is available until the current session exposes it.
> For host tool equivalents, see `skills/blocks/codex-host-adapter.md`.
# Document Delivery for Knowledge Workers
Convert knowledge work outputs from markdown to professional office documents (DOCX, PPTX, XLSX).
## Overview
This skill helps you transform knowledge work results into polished, deliverable documents:
- **After empathize** → Export personas to PPTX decks or requirements to DOCX specs
- **After advise** → Convert strategic analysis to PPTX presentations or DOCX business cases
- **After synthesize** → Generate literature reviews as DOCX academic format or PDF
## Prerequisites Check
Before converting documents, verify the document-skills plugin is installed:
```bash
/plugin list | grep document-skills
```
If not installed:
```bash
/plugin install document-skills@anthropic-agent-skills
```
## Format Recommendations by Workflow
### Empathize Workflow → UX Research Outputs
**Best for PPTX (PowerPoint):**
- Persona decks for stakeholder presentations
- Journey map visualizations
- Research synthesis highlights
- Executive summaries
**Best for DOCX (Word):**
- Detailed persona documentation
- Research requirements specifications
- Interview transcripts and analysis
- User story documentation
### Advise Workflow → Strategic Analysis
**Best for PPTX (PowerPoint):**
- Strategy presentations for leadership
- Market analysis decks
- Competitive intelligence briefs
- Business case pitch decks
- Board presentations
**Best for DOCX (Word):**
- Comprehensive business cases
- Strategic recommendations reports
- Market research documentation
- Financial analysis reports
### Synthesize Workflow → Research Synthesis
**Best for DOCX (Word):**
- Literature review papers
- Research synthesis reports
- Academic research documentation
- Annotated bibliographies
- Technical white papers
**Best for PDF:**
- Final publications
- Archival versions
- Shareable research reports
## Conversion Guidelines
### Step 1: Locate Source Markdown
Knowledge work outputs are stored in:
```bash
~/.claude-octopus/results/
```
List recent outputs:
```bash
ls -lht ~/.claude-octopus/results/ | head -10
```
### Step 2: Choose Format Based on Purpose
Ask yourself:
- **Presenting to stakeholders?** → PPTX (visual, concise)
- **Comprehensive documentation?** → DOCX (detailed, structured)
- **Final publication?** → PDF (archival, unchangeable)
- **Data/frameworks?** → XLSX (tables, calculations)
### Step 3: Use Document-Skills Plugin
The document-skills plugin provides these capabilities:
**For DOCX (Word):**
```
Use the /document-skills:docx skill to convert markdown to Word format.
Supports headings, lists, tables, and formatting.
```
**For PPTX (PowerPoint):**
```
Use the /document-skills:pptx skill to convert markdown to PowerPoint.
Each ## heading becomes a slide, bullet points auto-format.
```
**For PDF:**
```
Use the /document-skills:pdf skill to generate PDF documents.
Ideal for final deliverables and archival.
```
### Step 4: Apply Professional Styling
After conversion, consider:
- **Consistent formatting** - Use heading styles, bullet hierarchies
- **Visual hierarchy** - Important points first, details later
- **Brand alignment** - Add logos, colors, fonts if needed
- **Readability** - Break up long paragraphs, use white space
## Common Conversion Patterns
### Pattern 1: Single Workflow → Single Document
User ran one workflow, wants one document:
```
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
```
### Pattern 2: Multiple Sections → Presentation
User wants to create a deck from research:
```
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
```
### Pattern 3: Batch Conversion
User wants multiple formats:
```
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
```
## Professional Styling Tips
### DOCX (Word) Best Practices
- Use built-in heading styles (Heading 1, Heading 2, etc.)
- Add table of contents for documents >5 pages
- Use bullet points and numbered lists appropriately
- Include page numbers and headers/footers
- Add executive summary at the beginning
- Use tables for structured data
### PPTX (PowerPoint) Best Practices
- One main idea per slide
- Use title slide with author/date
- 5-7 bullet points max per slide
- Use consistent fonts and colors
- Add slide numbers
- Include summary/next steps slide
- Use visuals where possible (charts, diagrams)
### PDF Best Practices
- Convert from DOCX after final review
- Ensure all fonts are embedded
- Optimize for screen or print
- Add metadata (title, author, keywords)
- Use bookmarks for navigation
## Example Workflows
### Example 1: UX Research Persona Deck
```markdown
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"
```
### Example 2: Strategic Business Case
```markdown
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"
```
### Example 3: Literature Review Paper
```markdown
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"
```
## Handling Edge Cases
### No Recent Workflow Output
If user requests export but no workflow was run:
```
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."
```
### Format Not Specified
If user doesn't specify 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?"
```
### Multiple Markdown Files
If multiple outputs exist:
```
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 Not Installed
If plugin missing:
```
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."
```
## Integration with Knowledge Mode
This skill is designed to work seamlessly with the three knowledge mode workflows:
```
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 activates automatically
5. Professional document delivered
```
## Best Practices
1. **Review Before Converting** - Check markdown quality first
2. **Choose Right Format** - Match format to audience and purpose
3. **Add Context** - Include dates, authors, version numbers
4. **Test Compatibility** - Ensure recipients can open the format
5. **Archive Sources** - Keep original markdown files
6. **Version Control** - Use descriptive filenames with dates
## Quick Reference Commands
```bash
# 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
```
## Getting Help
For questions about:
- **Document conversion** → Ask about specific format needs
- **Knowledge workflows** → See /octo:knowledge-mode
- **Document-skills capabilities** → See /document-skills:* skills
- **Styling and formatting** → Ask for best practices by format
*Document delivery skill for claude-octopus v7.3.0+*
章节与文件索引
按说明文件中的顺序排列。
概述
先决条件检查
移情工作流程 → 用户体验研究成果
建议工作流程 → 战略分析
综合工作流程 → 研究综合
文件/命令 -> /octo:* · skills/blocks/codex-host-adapter.md · .claude-octopus/results · Data/frameworks · headers/footers · author/date · summary/next · .claude-octopus/results/empathize-session-2026-01-18.md
内容校验值 -> da329c3d5092
当前原文的自动摘译,尚未人工审校。
概述
该技能可帮助您将知识工作结果转化为精美的可交付文档: 共情之后 → 将角色导出到 PPTX 平台或将需求导出到 DOCX 规范 建议之后 → 将战略分析转换为 PPTX 演示文稿或 DOCX 业务案例 综合之后 → 生成 DOCX 学术格式或 PDF 格式的文献综述
先决条件检查
在转换文档之前,请验证是否安装了文档技能插件: 如果未安装:
移情工作流程 → 用户体验研究成果
最适合 PPTX (PowerPoint):利益相关者演示的角色甲板 旅程地图可视化 研究综合亮点 执行摘要
建议工作流程 → 战略分析
最适合 PPTX (PowerPoint):领导力战略演示 市场分析平台 竞争情报简报 商业案例推介平台
综合工作流程 → 研究综合
最适合 DOCX (Word):文献综述论文 研究综合报告 学术研究文档 带注释的参考书目