version: 1.0.0 name: 中文文档生成 description: 起草并生成中文 Word 文档（.docx）。支持正式公文（GB/T 9704-2012）和通用文档两种模式。当用户要求起草、生成、写作任何中文文档时触发，包括：通知、报告、请示、函、纪要、讲话稿、方案、工作总结等。Do NOT use when the user wants to edit, modify, comment on, or extract text from an existing .docx file — use the docx skill instead.

version: 1.0.0

cn-docx · 中文文档生成

⚠️ 严格禁止的操作

• 禁止 用任何命令读取或显示已生成的 .docx 文件内容（cat、type、hexdump 等均不允许）
• 禁止 遍历或列出 node_modules 目录（ls node_modules、find node_modules 等）
• 禁止 读取 generate.js 源码（不需要，直接调用即可）
• 生成完成后，只告知用户文件保存路径，不做任何验证读取

version: 1.0.0

工作方式

收到用户的文档需求后：

1. 先判断文档类型是否明确（见下方"文档类型澄清"）
2. 判断文档类型，选择 mode
3. 将内容组织成结构化的 body 节点
4. 用 stdin 调用 generate.js 生成 .docx 文件
5. 告知用户文件保存路径（直接完成，不读取文件内容验证）

中文引号 "这样写" 直接写在 JSON 字符串里，完全没问题。

version: 1.0.0

文档类型澄清

当用户只给了一段文本，或需求描述模糊时，必须先澄清，再生成。 不要自行猜测。

按以下顺序判断是否需要澄清：

1. 用途/场景不明确 → 询问用途

用户说"帮我生成 Word"、"把这段话做成文档"、"帮我写一个关于 XX 的文件"，没有说明是哪类文档，先问：

请问这份文档是用来做什么的？

• 通知 / 通报 / 请示 / 函（发给其他单位或部门的正式公文）
• 报告 / 纪要 / 讲话稿 / 方案（上报或内部使用的正式公文）
• 工作总结 / 项目方案 / 调研报告（个人或内部通用文档）

2. 文种已知，发文单位不明确 → 询问落款

确认是公文（official）后，如果用户没有提供发文单位和日期，再问：

请提供发文单位名称和落款日期，例如"某市应急管理局，2026年3月"。

如果是红头公文（strict 模式），还需要文号，例如"某政发〔2026〕1号"。

3. 内容已足够 → 直接生成，无需多问

用户已经说明文种（"帮我写一个通知"）且提供了标题、正文内容，直接生成，不用再问。

version: 1.0.0

模式选择

version: 1.0.0

调用方式（stdin JSON）

不要写临时 JS 脚本，直接用 stdin 传 JSON：

echo '{ ...JSON... }' | node {SKILL_DIR}/generate.js

official 模式 - standard 示例

echo '{
  "mode": "official",
  "style": "standard",
  "docType": "tongzhi",
  "outputPath": "{OUTPUT_DIR}/通知.docx",
  "content": {
    "title": "关于××××的通知",
    "recipient": "各部门、各单位：",
    "org": "××单位",
    "date": "二〇二六年三月十五日",
    "body": [
      { "level": 0, "text": "正文段落，首行自动缩进两字。" },
      { "level": 1, "number": "一", "heading": "一级标题（黑体三号）" },
      { "level": 2, "number": "（一）", "heading": "二级标题（宋体三号加粗）" },
      { "level": 0, "text": "正文内容。" },
      { "level": 3, "number": "1.", "heading": "三级小标题", "text": "后面是同段正文。" },
      { "level": 4, "number": "（1）", "text": "四级标题，行内正文。" }
    ],
    "attachments": ["附件一名称", "附件二名称"]
  }
}' | node {SKILL_DIR}/generate.js

official 模式 - strict 示例（红头公文，GB/T 9704-2012）

echo '{
  "mode": "official",
  "style": "strict",
  "docType": "tongzhi",
  "outputPath": "{OUTPUT_DIR}/红头通知.docx",
  "content": {
    "title": "关于开展安全生产大检查的通知",
    "recipient": "各县区人民政府，市直各单位：",
    "org": "某市人民政府",
    "doc_number": "某政发〔2026〕1号",
    "date": "二〇二六年三月十五日",
    "serial_number": "000001",
    "secret_level": "机密★1年",
    "urgency": "特急",
    "signers": ["张三", "李四"],
    "cc": "市安委会各成员单位",
    "print_org": "某市人民政府办公室",
    "print_date": "2026年3月15日",
    "body": [
      { "level": 0, "text": "正文内容。" }
    ],
    "attachments": ["安全生产检查表"]
  }
}' | node {SKILL_DIR}/generate.js

general 模式示例

echo '{
  "mode": "general",
  "outputPath": "{OUTPUT_DIR}/工作总结.docx",
  "content": {
    "title": "2026年第一季度工作总结",
    "author": "张三",
    "org": "某部门",
    "date": "2026年3月15日",
    "body": [
      { "level": 0, "text": "总体情况说明段落。" },
      { "level": 1, "number": "一", "heading": "一级标题（黑体小三加粗）" },
      { "level": 2, "number": "（一）", "heading": "二级标题（宋体四号加粗）" },
      { "level": 0, "text": "正文内容，宋体四号，1.5倍行距。" },
      { "level": 3, "number": "1.", "heading": "三级小标题", "text": "同段正文内容。" }
    ],
    "attachments": ["附件名称"]
  }
}' | node {SKILL_DIR}/generate.js

Markdown 输入模式（推荐用于 AI 生成内容）

当用户把 AI 的 Markdown 回答直接转为 Word 时，使用 markdown 字段替代 body：

echo '{
  "mode": "general",
  "outputPath": "{OUTPUT_DIR}/工作总结.docx",
  "content": {
    "title": "2026年Q1工作总结",
    "org": "某部门",
    "date": "2026年3月15日",
    "markdown": "## 一、总体情况\n\n本季度完成了各项目标。\n\n## 二、主要成果\n\n| 项目 | 完成率 |\n|------|-------|\n| 建设 | 100% |\n\n- 完成预算编制\n- 推进重点项目"
  }
}' | node {SKILL_DIR}/generate.js

markdown 字段支持的 Markdown 元素：

注意：markdown 和 body 二选一，同时存在时 markdown 优先。

version: 1.0.0

日期说明：

• official 模式默认使用汉字日期（如 "二〇二六年三月十五日"），可调用 dateToChinese('2026-03-15') 转换
• general 模式默认使用阿拉伯数字日期（如 "2026年3月15日"）
• date 字段直接填写最终日期字符串即可

version: 1.0.0

文种（docType）

version: 1.0.0

style 模式

⚠️ strict 模式字体说明：方正小标宋简体 和 仿宋_GB2312 是 Windows 系统内置字体。在 macOS/Linux 上生成的文档，若对方机器没有这两个字体，打开时会降级显示。建议仅在 Windows 环境下，或确认接收方为 Windows 时使用 strict 模式。

version: 1.0.0

content 字段说明

通用字段

official 模式专用

strict 模式专用（可选）

general 模式专用

version: 1.0.0

body 节点规范

official 模式

general 模式

level 3 同段格式说明

level 3 和 level 4 支持 heading + text 分开，实现"标题加粗+正文不加粗"同段效果：

{ "level": 3, "number": "1.", "heading": "加强管理。", "text": "各单位要认真落实各项管理制度。" }

生成效果：**1.加强管理。**各单位要认真落实各项管理制度。

如果只传 text 不传 heading，则整段加粗（向后兼容）。

序号说明：number 字段不需要带末尾顿号，一级标题会自动补上"、"。例如传 "一" 而非 "一、"。

扩展节点类型（Phase 1）

除了 level 段落节点，body 数组还支持以下扩展类型，两种模式均可使用：

type: "table" — 表格

{
  "type": "table",
  "caption": "表1 项目进度",
  "headers": ["阶段", "时间", "负责人"],
  "rows": [["需求分析", "1月", "张三"], ["开发实现", "2月", "李四"]],
  "style": "three-line",
  "widths": [40, 30, 30]
}

type: "image" — 图片

{
  "type": "image",
  "src": "/absolute/path/to/chart.png",
  "width": 120,
  "caption": "图1 收入趋势图",
  "align": "center"
}

type: "list" — 列表

{
  "type": "list",
  "ordered": true,
  "items": [
    { "text": "第一项" },
    { "text": "第二项", "children": [
      { "text": "子项 A" },
      { "text": "子项 B" }
    ]}
  ]
}

type: "link" — 超链接段落

{ "type": "link", "text": "国家标准全文公开系统", "url": "https://openstd.samr.gov.cn", "prefix": "参考资料：" }

type: "pageBreak" — 强制分页

{ "type": "pageBreak" }

在此处强制另起一页，无其他参数。

type: "divider" — 水平分割线

{ "type": "divider" }

渲染为灰色细线，用于章节之间的视觉分隔，无其他参数。

version: 1.0.0

页眉（general 模式专用）

公文模式无页眉（符合 GB/T 9704 规范）。通用模式可在 content 中设置：

{
  "mode": "general",
  "content": {
    "header": "某部门 2026年工作报告",
    ...
  }
}

version: 1.0.0

版面规范

version: 1.0.0

strict 模式 GB/T 9704-2012 合规说明

strict 模式严格遵循 GB/T 9704-2012 标准：

• 版头：发文机关标志红色小标宋体，上边缘距版心上边缘 35mm；发文字号下空二行；版头分隔线红色与版心等宽
• 主体：标题2号小标宋体，红色分隔线下空二行；主送机关标题下空一行
• 落款：成文日期右空四字
• 版记：自动生成抄送机关、印发机关和印发日期，含粗/细分隔线
• 页码：奇偶页分别居右/居左
• 可选要素：份号、密级和保密期限、紧急程度、签发人

version: 1.0.0

预设风格（preset）

在顶层加 preset 字段，一键选定文档风格，无需手动指定 mode/style。显式传入的字段仍可覆盖 preset 默认值。

echo '{
  "preset": "corporate",
  "outputPath": "{OUTPUT_DIR}/商业报告.docx",
  "content": {
    "title": "2026年第一季度业务报告",
    "org": "某公司",
    "date": "2026年3月28日",
    "body": [...]
  }
}' | node {SKILL_DIR}/generate.js

preset 与 mode/style 可混用：preset: "corporate" 设为 general 模式，但仍可加 "mode": "official" 覆盖。

version: 1.0.0

生成报告

每次生成成功后，终端输出包含统计摘要：

✅ 已生成：/path/to/file.docx
   📄 估算约 3 页  ·  段落 12  ·  表格 2  ·  图片 1  ·  列表 3  ·  字符 2150

页数为基于字符数的估算值（公文 ~600字/页，通用 ~700字/页），仅供参考。

version: 1.0.0

依赖

Node.js ≥ 16，docx 库已随应用预装，无需手动执行 npm install。docx 版本已锁定，升级前务必先跑 node test.js 验证字体渲染正常。