PnKU 谜题资料站与 Agent 迁移工作流

项目背景

我于 2024 年 8 月开始使用 Docusaurus 开发 PnKU 资料站，用于保存历届活动的题目和解析，并从 2025 年 1 月开始搬运北京大学谜题协会微信公众号文章。

公众号的《谜色星期五》每周发布一道单页谜题，《执笔成谜》不定期发布纸笔逻辑谜题。玩家通过公众号自动回复验证答案；随着历史题目累积，自动回复条目上限成为持续维护的限制。资料站提供长期存档，并将答案验证、提示查看和解析展示转化为网页交互。

从人工 SOP 到模板 CLI

在人工搬运阶段，我先编写栏目搬运 SOP 与 MDX 模板，将编号、标题、作者、日期及题目、提示、解析等结构固定下来。模板生成 CLI 按栏目与编号初始化文章和同名资源目录，自动替换编号；重复调用可批量创建文章骨架，再按原文填写元数据与内容。

这一阶段减少了重复创建文件和编排结构的工作，也为后续 Agent 执行提供了明确的格式约定与工具入口。

Agent 工作流设计

在 2026 年 10 月的两天改造中，我为项目添加 AGENTS.md，并将人工 SOP、CLI 与栏目规则整合成两套可复用的迁移 Skill，分别适配《谜色星期五》和《执笔成谜》。流程覆盖以下环节：

• 来源清点与配对： 结合原文标识、标题和日期核对文章，将后续解析与勘误配回原题，处理跨批次、多题合集和多解。
• 结构化编排： 整理元数据和图片资源，接入答案验证、提示折叠、解析展示及适用的步骤轮播，保留原文署名与答案提交规则。
• 异常与交接： 记录缺失素材、未确认答案、来源映射和待验证项，使后续执行可以续作；缺少依据时保留状态，不猜测补齐。
• 验证规范： 将构建、资源引用、页面交互与原文对照检查写入流程，并根据实际发现的问题更新 Skill。

Skill 和配套参考资料保存在仓库中，使其他 Agent 可以读取并复用，而不依赖单次对话上下文。题目、提示和解析来自原始资料；我的贡献是资料站开发、迁移工具与执行流程设计。

迁移产出与人工验收

两天内完成了工作流开发与 100 余篇文章迁移，日均迁移产出约 50 篇，相比此前人工约 8 篇/天明显提升。两天包含开发与迁移时间，不包含需求方后续人工验收；该对比描述迁移阶段的产出。

北京大学谜题协会成员负责人工核对。截至 2026 年 10 月 8 日，复核已发现两处 Markdown 语法相关问题，均已修复，并将处理规则回写 Skill。人工验收仍在进行，正在召集更多成员并行处理；当前发现的问题数量不作为整批内容准确率或验收完成的依据。