super-official-writer

一个装进 Agent 的"笔杆子"。把公文写作拆成五步流程，在每一步接入规则引擎与知识库：写什么查什么、卡在哪查哪、写完自查什么。不是聊天式"帮我写个通知"，而是可检索、可校验、可交付 Word 的完整写作系统。Claude Code / Codex 等任意 Agent Skills 兼容环境可用。

✨ 能力矩阵

📚 知识来源

视频类内容经授权渠道下载 → 语音转写 → 逐条蒸馏 → 结构化整理；书籍类内容经微信读书导出蒸馏。结构化数据集（1919 条 jsonl）另存。

📦 安装

方式一：Claude Code / Cherry Studio / ZCode（Agent Skills）

git clone https://github.com/Amer-CN/super-official-writer.git
# 复制到你的技能目录（按你的环境）：
cp -r super-official-writer/ ~/.agents/skills/super-official-writer/
# 或 Claude Code: ~/.claude/skills/

新开对话即自动识别，触发场景：写/改/审任何公文、材料、汇报、总结、讲话稿。

分支与目录名：仓库默认分支是 master（另有 main 镜像分支，供只认 main 的安装器使用）。技能目录名必须保持 super-official-writer，与 SKILL.md frontmatter 里的 name 一致——Cherry Studio / Claude Code 按 frontmatter 识别技能，目录名或 frontmatter 缺失都会被登记异常（v0.23 已补齐 frontmatter，见 CHANGELOG）。

自动更新（v0.5+）

skill 每次会话首次触发时会自动检查版本（scripts/version_check.py，git ls-remote 比对远端，断网时静默跳过、绝不阻塞写作任务）。发现新版本时会提示：

[skill 更新] 发现新版本（本地 5601f54 → 远端 a359983）
建议：cd 技能目录 && git pull，或重新克隆覆盖。

更新了什么看 CHANGELOG.md——每个版本新增的知识明细都在里面。手动检查：python scripts/version_check.py。

方式二：任意 LLM 作为系统知识

把 SKILL.md 全文 + 按需引用 references/ 下文件塞进 system prompt 或 RAG 知识库。

🚀 快速上手

写作（对 Agent 说）：

帮我写一份安全生产工作汇报，受众是局领导，要用数据说话。

Agent 将按五步法执行：确认文体→检索知识库（汇报方法 15 条+文种规范）→搭架子→起草（六层矩阵逐层约束）→核稿十查。

交付 Word：Agent 起草完成后调用排版执行层：

# 输入结构化 JSON，输出国标格式 docx（小标宋标题/文号行/黑体一级/楷体二级/仿宋正文/28磅行距/4号宋体奇偶页码）
# JSON 顶层字段：title / docNumber(发文字号，v0.16 新增) / body[{level:h1|h2|para}] / signee / date
node scripts/render_docx.js input.json

# 或先看内置样例：
node scripts/render_docx.js --demo   # 生成 word/demo.docx
# 依赖：cd scripts && npm install docx

核稿（把写好的稿子交给 Agent）：

帮我核这份通知（贴上文本）

Agent 按核稿十查清单逐项检查：文种是否在 15 法定文种内、行文关系是否匹配、标题三要素、首页显示正文、份号密级、联合行文署名、成文日期与印章……

⚙️ 工作原理（五步流程 × 知识检索）

Step 1 接收需求 ── 确认文体/受众/风格，锁定 Protected Spans
Step 2 磨刀子 ──── 查 corpus 文种规范层（选文种）
Step 3 定盘子+搭架子 ─ 查 templates.md（文体框架）
Step 4 敲键子 ──── 六层矩阵逐句生成；卡壳查 corpus 实战方法层
Step 4.5 交付 ──── 需要时调 render_docx.js 出国标 Word
Step 5 收果子 ──── 八项算法校验 + 核稿十查（corpus 病例层）

🗂️ 仓库结构

super-official-writer/
├── SKILL.md                # 技能主文件：YAML frontmatter（name/description）+ 流程+算法+规则（~21KB）
├── README.md               # 本文件
├── .github/workflows/mirror-main.yml # master→main 镜像（兼容只认 main 的安装器）
├── docs/
│   ├── distillation-sop.md # 抖音博主蒸馏流水线 SOP（供其他窗口/项目复用）
│   └── integration-contract.md # 集成契约（下游按编号解析本仓时的稳定性承诺；普通用户可忽略）
├── references/
│   ├── templates.md        # 21 种文体框架模板（4 种带语料实测标注）
│   ├── phrase-library.md   # 素材库（三~六字短语/按拿推搭配/概念封装/报告金句）
│   ├── format-spec.md      # GB/T 9704-2012 公文格式规范
│   ├── style-params.md     # 量化风格参数（7 文种×13 项+标点纪律+标题浓度+无参数文种对照表）
│   ├── corpus-lingyun.md   # 蒸馏知识库索引页（索引+28 分层文件：层索引+检索规则，条目正文在 corpus/）
│   └── corpus/             # 分层知识库 28 文件（主层/文种规范/核稿病例/捉刀人/公文摆渡/报告蒸馏/手记2/手记1/付传/掌上课堂/何剑文/心法/36堂课/32讲/大手笔/炼成/炼成2/28锦囊/好帮手/速成套装四书/改稿室/大雨/文兄/领域素材/法定公文成稿范例）+ INDEX.md 知识分类索引（自动生成）
├── scripts/
│   ├── render_docx.js      # 排版执行层（JSON→国标 docx）
│   ├── check_params.py     # 风格自检（7 文种参数对照，只判硬冲突）
│   ├── version_check.py    # 版本自检（Step 0 检查远端更新）
│   ├── build_corpus_index.py  # 知识分类索引生成（dataset category → corpus/INDEX.md）
│   ├── package.json        # docx-js 依赖
│   └── package-lock.json
└── tests/
    └── test-cases.md       # 评测基线（15 用例 × 两轮真实运行：run1 问题清单 → v0.12 修复 → run2 实效验证）

📜 版本历史

🙏 许可与致谢

方法论来源（2 部）：

• 李永新《笔杆子是怎样炼成的》（清华大学出版社，2021）——五步实战法、素材库、多风格引擎
• 顿彬《公文写作算法》（郑州大学出版社，2021）——六层技能矩阵、V+N/N+V 句式基因、19 种文体框架（v0.6 后含语料实测标注）

文种规范与病例来源（3 部）：

• 《新党政机关公文与办公室写作》（范兰德、张少元，广东人民出版社，2013）——中编事务性文书
• 《法定公文与常用公文写作》——15 法定文种 + 60 事务文种写法
• 《党政机关公文写作处理病例分析》（蔡振康）——57 个改错病例与核稿十查

视频蒸馏来源（7 位博主）：

• 抖音"凌云笔杆子" 177 期写作方法视频
• 抖音"公文摆渡" 109 期句式模板与思维模型视频
• 抖音"捉刀人" 33 期条例精讲视频
• 抖音"惠水组工" 20 期公文知识视频
• 抖音"材料改稿室" 79 期改稿方法视频
• 抖音"大雨写材料" 82 期思路框架视频
• 抖音"加夜班的文兄" 220 期（201 视频+19 图文）数字框架库与申论应试视频

所有书籍与视频内容版权归原作者/博主所有，本仓库以学习笔记与方法提炼形式整理；代码部分（scripts/）MIT License。