Yearbook Writer — Development skill for Claude Code

yearbook-writer · 年鉴编写助手

一个 Claude Code skill：把各单位/科室报送的原始素材（工作总结、大事记、信息简报、照片等），按照年鉴编写规范改写、汇编为正式的年鉴条目稿件，并输出排版规范的 Word 文档（.docx）。

这是什么

年鉴条目和工作总结是两种完全不同的文体——总结是第一人称、带议论抒情、口号式小标题；年鉴条目是第三人称记述体、【】标题、一段成文、只记事实不评论。这个 skill 把这套"改写规则"固化成了可复用的工作流：

输入	产出
任务通知 + 编写规范（可选）	篇名 +【概况】+ 专题条目的年鉴稿
各科室工作总结、大事记、照片等素材	规范排版的 .docx（标题居中、首行缩进、署名右对齐）

**核心特性**：

• 规范优先：任务附带了编写规范（如《XX年鉴编写规范》）就以它为准；没附就用内置的通用年鉴规范兜底
• 事实忠实：所有数据、人名、事件必须来自素材，不虚构；多份素材口径矛盾时列出矛盾请你定夺，不擅自取舍
• 自动避坑：剔除"明年打算""存在问题"等不入鉴内容；规避"我馆""我局"第一人称、"着力""扎实"等套话、"今年""目前"等含混时间词
• 撰稿人署名：先从素材文末署名建立"科室→撰稿人"映射，实在没有才用（XXX）占位提醒你补
• 涉密处理：军事番号、敏感内容按规范自动模糊化
• 通过评测验证：经 3 轮评测（含与真实出版年鉴对照），最终通过率 98.3%，明显优于不使用 skill 的基线

目录结构

yearbook-writer/
├── SKILL.md                    # 主文件：工作流（识别输入→盘点素材→建框架→撰写→排序→出稿→自检）
├── references/
│   ├── writing-rules.md        # 通用年鉴编写规范（条目类型、语言禁忌、数字/时间/标点规则）
│   └── checklist.md            # 交付前自检清单
├── scripts/
│   └── build_docx.py           # 中间文本稿 → .docx 的生成脚本
├── evals/
│   └── evals.json              # 评测用例定义（4 个）
└── README.md                   # 本文件

安装

skill 已在你的全局目录生效，**无需安装**：

C:\Users\40864\.claude\skills\yearbook-writer\

如需在另一台机器或分享给别人使用：

1. 复制整个 yearbook-writer\ 目录到对方的 ~/.claude/skills/ 下；或
2. 使用打包文件 yearbook-writer.skill（位于 yearbook-writer-workspace\）导入

依赖：`python-docx`（生成 Word 用，运行 `pip install python-docx`）；读取老式 .doc 素材建议装 antiword 或 LibreOffice。

怎么使用

正常对话即可，不用记命令。典型的触发说法：

"通知和素材在这两个目录，帮我编《XX年鉴（2027）》（XX篇）"

"把这些科室总结按年鉴规范整理成条目，输出 Word"

"帮我把这些材料写成年鉴初稿"

**它会自动做的事**：

1. 通读通知/编写规范，提取记述时限、字数、署名等要求
2. 逐份读素材，建事实清单 + 撰稿人映射表，标注口径矛盾
3. 设计条目框架：【概况】居首 + 专题条目（一事一条）
4. 按记述体逐条撰写，条目标题≤13 字，按月日排序
5. 生成中间文本稿 → 运行脚本产出 .docx
6. 对照自检清单逐项核查后交付，并向你说明素材矛盾和待补项（如 XXX 署名占位）

**你只需要**：提供素材目录/文件，确认它列出的口径矛盾怎么取舍，补填（XXX）署名。

后续怎么优化

小改动：直接改文件

• 改写法规则 → 编辑 references/writing-rules.md（比如你们单位的特殊约定）
• 改自检项 → 编辑 references/checklist.md
• 改 Word 排版 → 编辑 scripts/build_docx.py（字体、字号参数），或运行时用 `--font-body 仿宋_GB2312 --si