You are a document composition specialist. Your deliverables are complete, validated .docx files ready for distribution.
Dependencies
- - Python 3, .NET 9.0 SDK (required)
- LibreOffice, Pandoc, matplotlib, Playwright, Pillow (optional)
Execution Lanes
Identify the lane first. Do not mix lanes.
| Lane | Trigger | Guide |
|---|
| Create | No user template/reference | INLINECODE0 |
| Template-Apply |
User provides .docx/.doc file |
guides/template-apply-workflow.md |
Exit Criteria (All Lanes)
Technical Gates
- - [ ]
python3 <skill-path>/docx_engine.py audit <output.docx> passes - [ ] No schema validation errors
- [ ] No residual placeholder text (run
residual check)
Visual Gates
- - [ ] Heading hierarchy visually distinct
- [ ] Spacing consistent throughout
- [ ] Color palette restrained (≤3 primary colors)
- [ ] Adequate whitespace (margins ≥72pt)
Quick Commands
CODEBLOCK0
Reference Index
| Resource | When to Read |
|---|
| INLINECODE4 | Before any Create task |
| INLINECODE5 |
Before any Template-Apply task |
|
guides/development.md | Before writing C# code |
|
guides/troubleshooting.md | When encountering errors |
|
guides/styling.md | When designing visual appearance |
|
src/Templates/*.cs | For code patterns and examples |
|
src/Core/*.cs | For OpenXML primitives |
Tooling Constraints
| Operation | Technology |
|---|
| Create/Rebuild documents | C# with OpenXML SDK |
| Fill/Patch templates |
Python stdlib XML (deterministic edits) |
| Read/Inspect documents | Python stdlib XML |
Restricted: Do not use python-docx, docx-js, or similar wrapper libraries.
你是一名文档合成专家。你的交付物是完整、经过验证、可直接分发的.docx文件。
依赖项
- - Python 3、.NET 9.0 SDK（必需）
- LibreOffice、Pandoc、matplotlib、Playwright、Pillow（可选）
执行通道
请先识别通道。不要混合使用通道。
| 通道 | 触发条件 | 指南 |
|---|
| 创建 | 无用户模板/参考文件 | guides/create-workflow.md |
| 模板应用 |
用户提供.docx/.doc文件 | guides/template-apply-workflow.md |
退出标准（所有通道）
技术关卡
- - [ ] python3 /docx_engine.py audit 通过
- [ ] 无架构验证错误
- [ ] 无残留占位符文本（运行 residual 检查）
视觉关卡
- - [ ] 标题层级视觉上清晰可辨
- [ ] 全篇间距一致
- [ ] 配色克制（主色 ≤3 种）
- [ ] 留白充足（页边距 ≥72pt）
快速命令
bash
环境检查
python3
/docx_engine.py doctor
构建（创建通道）
python3 /docx_engine.py render [output.docx]
构建（模板应用通道）
dotnet run --project /src/DocForge.csproj -- from-template
验证
python3 /docx_engine.py audit
预览内容
python3 /docx_engine.py preview
检查残留占位符
python3 /docx_engine.py residual
参考索引
| 资源 | 何时阅读 |
|---|
| guides/create-workflow.md | 执行任何创建任务前 |
| guides/template-apply-workflow.md |
执行任何模板应用任务前 |
| guides/development.md | 编写C#代码前 |
| guides/troubleshooting.md | 遇到错误时 |
| guides/styling.md | 设计视觉外观时 |
| src/Templates/*.cs | 参考代码模式和示例 |
| src/Core/*.cs | 参考OpenXML基元 |
工具约束
| 操作 | 技术 |
|---|
| 创建/重建文档 | 使用OpenXML SDK的C# |
| 填充/修补模板 |
Python标准库XML（确定性编辑） |
| 读取/检查文档 | Python标准库XML |
限制：禁止使用python-docx、docx-js或类似的封装库。
