wzbwan/gongwen-format-skill

README preview

# gongwen-format-skill

`gongwen-format-skill` 是一个面向 **Claude Code、Codex等AI Agent的 Skills/自动化场景** 的“确定性公文（公文格式）排版工具”：输入 **受控 Markdown**（含 YAML Front Matter）或 **JSON**，通过 `python-docx` 稳定生成符合常见公文排版约束的 Word `.docx`（字体/字号/行距/标题与层级/主送机关/附件/页码等）。

## 功能特性

- 受控输入协议：不做通用 Markdown 语义推断，靠“行首标记”做确定性渲染
- 标题与层级：`#`~`#####` 映射到公文标题/一二三级标题的固定字体与字号
- 正文排版：段前段后 0、固定行距、首行缩进（2 字）等
- 主送机关、附件说明、落款与日期（来自 Front Matter）
- 页码：页脚居中 `— 1 —`（Word 字段 `PAGE`）
- 依赖轻：核心仅依赖 `python-docx`，Front Matter 解析内置实现（不强依赖 PyYAML）

## 安装到 Codex Skills（举例，其他AI Agent类似）

1. 将本仓库中的 `gongwen-format-skill/` 目录复制到你的 Codex Skills 目录下（例如 `~/.codex/skills/`）。
2. 确保 `SKILL.md` 位于 `gongwen-format-skill/` 目录根部。
3. 重启 Codex CLI（或让其重新加载 skills）。

> 你的环境里具体的 Skills 根目录可能不同；以你当前 Codex 配置为准。

View full repository on GitHub →