Minimax DOCX

• You must eventually deliver a Word document (.docx file)
• Ensure the overall deliverable is professional and complete, not template filling
• Default to adding professional elements: covers, TOC, headers/footers, page numbers

⚠️ Pre-Execution Rules (Violating Any = Bug)

</Pre-Execution Rules>

Technology Stack

⚠️ Never mix these. Never use python-docx/docx-js.

Markdown ↔ DOCX Conversion Rules

⚠️ Critical Rules:

1. DOCX → MD loses information. Pandoc's docx-to-markdown is for basic text extraction ONLY. Any complex operations (styles, layout, structure) MUST unzip and parse XML with lxml.
2. MD → DOCX is one-way. Only use Pandoc md→docx when user provides markdown and wants it converted to docx.
3. Never round-trip. If you converted a user's DOCX to MD for viewing, that MD is READ-ONLY. Delivering it back as DOCX = data loss.

How to Read DOCX Content

⚠️ Pandoc docx→md Restrictions:

• Disabled by default — always prefer unzip + lxml to parse XML directly
• Only consider when you need plain text preview with NO subsequent operations
• Output markdown is for human reading only, forbidden for any programmatic processing
• For tables, styles, paragraph structure, etc., MUST use lxml to parse raw XML

⚠️ Never use convert_docx_to_md — loses formatting information.

Python Editing Setup

# From skill directory (auto-detected by oxml.py)
python3 -c "import sys; sys.path.insert(0, 'tools'); from core.markup import DocxSession, add_comment, insert_text"

</Technology Stack>

Reference Document Index

</Reference Document Index>

File Structure

minimax-docx/
├── SKILL.md                      ← Entry point (this file)
├── references/
│   ├── CodingGuide.md            → C# coding standards, API reference
│   ├── PitfallGuide.md           → Common mistakes, wrong vs correct patterns
│   ├── DesignGuide.md            → Design standards, colors, typography
│   └── EditingGuide.md           → Python editing tutorial (uses core.markup)
├── tools/
│   ├── oxml.py                   → Cross-platform entry script (build/validate)
│   ├── check_all.py              → Unified validation
│   ├── render_covers.py          → Background image generation (Morandi style)
│   ├── render_charts.py          → Complex charts via matplotlib
│   ├── color_schemes.py          → Python color palettes
│   └── core/                     → Python core library
│       ├── namespaces.py         → XML namespace definitions
│       ├── schema_fixer.py       → Element order auto-fix logic
│       ├── integrity.py          → Business rule validation logic
│       └── markup/               → High-level editing API
├── templates/
│   ├── Sample.cs                 → Complete example (cover→TOC→body→back cover)
│   ├── Quotes.cs                 → CJK content patterns (MUST READ)
│   ├── ColorSchemes.cs           → 21 color palettes
│   └── DocxEntry.cs              → Empty entry template
└── docxchecker/                  → OpenXML validator DLLs

</File Structure>

Build Process

Must use python3 tools/oxml.py build, never direct dotnet build && dotnet run.

Environment Setup

Before any build operation, you MUST ensure all dependencies are installed.

Step 1: Check Environment

python3 tools/oxml.py env   # Shows dependency status

Step 2: Initialize (if dependencies missing)

python3 tools/oxml.py init  # Auto-installs missing dependencies

Required Dependencies

Optional Dependencies

⚠️ If oxml.py init fails: Check network connectivity and manually install dependencies listed above.

Path Conventions (Dynamic)

The oxml.py script dynamically determines paths:

Run python3 tools/oxml.py env to see resolved paths.

</Build Process>

Design Standards (Required by Default)

核心原则：专业交付 ≠ 模板填充。 Unless user explicitly declines, these elements are MANDATORY:

⚠️ 缺少页眉页脚页码 = 半成品

Design Principles

• Low saturation colors (avoid Word default blue)
• ⚠️ White space is NON-NEGOTIABLE
  • Margins: Top≥90pt, Left/Right/Bottom≥72pt
  • Paragraph spacing: Body After≥10pt, Heading Before≥20pt
  • Line spacing: Body≥1.5x, never single-spaced
• Clear hierarchy (H1 > H2 > body)

Pagination Control

</Design Standards>

Key Schema Rules

Table Requirements

var table = new Table();
table.Append(new TableProperties(...));
table.Append(new TableGrid(           // Required!
    new GridColumn { Width = "4680" },
    new GridColumn { Width = "4680" }
));
table.Append(new TableRow(...));

Sample.cs Function Index

</Technical Reference>

Pre-Delivery Checklist

Validate with pandoc before delivery:

pandoc output.docx -t plain   # Verify content completeness

</Validation Checklist>