OpenParable
Skip to content
← Back to skills

Make Latex Model

Documents
make-latex-model

Make Latex Model is an Agent Skill for documents published in the huangwb8/ChineseResearchLaTeX repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

当用户明确要求“LaTeX 模板优化”“样式参数对齐”“像素级比对”“make-latex-model”或旧写法“make_latex_model”，或要把 ChineseResearchLaTeX 里的某个项目做成高质量模板时使用。适配 NSFC / paper / thesis / cv 四条产品线；先依据 packages/ 与 projects/ 的真实分层判断改项目层还是公共包，再用各产品线官方构建入口验收。若必须修改 packages 下公共包，需先生成受影响模板回归计划并完成相关回归；NSFC 专项工具仅在明确属于 NSFC 参数对齐场景时按需使用。

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/huangwb8/ChineseResearchLaTeX/blob/HEAD/skills/make-latex-model/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/make-latex-model, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

ChineseResearchLaTeX 模板落地与高保真对齐器

与 bensz-collect-bugs 的协作约定

  • 当用户环境中出现因本 skill 设计缺陷导致的 bug 时，优先使用 bensz-collect-bugs 按规范记录到 ~/.bensz-skills/bugs/，严禁直接修改用户本地 Claude Code / Codex 中已安装的 skill 源码。
  • 若 AI 仍可通过 workaround 继续完成用户任务，应先记录 bug，再继续完成当前任务。
  • 当用户明确要求“report bensz skills bugs”等公开上报动作时，调用本地 gh 与 bensz-collect-bugs，仅上传新增 bug 到 huangwb8/bensz-bugs；不要 pull / clone 整个 bug 仓库。

先读什么

  • 产品线标准：docs/for-developers/*-template-standard.md
  • 本 skill 工作流：docs/WORKFLOW.md
  • 产品线识别：references/PRODUCT_LINE_RULES.md
  • 脚本职责：references/SCRIPT_SCOPE.md
  • 工具说明：scripts/README.md
  • 基线准备：docs/BASELINE_GUIDE.md

定位

  • 让 ChineseResearchLaTeX 中的目标项目按当前真实架构落成高质量模板。
  • 先判断该改 projects/* 还是 packages/bensz-*。
  • 若必须改公共包，先做回归计划，再跑受影响模板的官方验证。
  • 验收始终以各产品线官方构建入口为准。

适用任务

  • 把某个项目对齐到官方 PDF、Word 导出 PDF 或既有 baseline
  • 判断问题属于项目层差异还是共享样式/共享脚本
  • 做像素级 PDF 比对、标题对齐、参数抽取
  • 新增或重构 NSFC / paper / thesis / cv 模板

工作流

1. 判断验收口径

  • 用户要“像某份 PDF/Word 一样”
  • 还是“按当前仓库标准做成好模板”
  • 还是“新增一套模板能力”

2. 判断修改层级

  • projects/*：示例内容、薄封装、项目资源、局部差异
  • packages/bensz-*：共享样式、共享字体、profile、统一构建逻辑

3. 最小范围实现

  • 只改与当前任务直接相关的文件
  • 除非用户明确要求，否则默认不改正文语义内容

4. 包层安全门禁

当必须改 packages/ 时，额外执行：

  1. 先证明项目层方案不够
  2. 运行 python3 skills/make-latex-model/scripts/plan_package_regression.py <packages/bensz-*>
  3. 优先把改动收敛到最窄的模板专属 profile/style/template
  4. 改完先验目标项目，再回归该公共包直接覆盖的全部现有项目

5. 官方入口验证

  • NSFC：nsfc_project_tool.py
  • Paper：paper_project_tool.py
  • Thesis：thesis_project_tool.py
  • CV：cv_project_tool.py

辅助脚本

  • analyze_pdf.py
  • compare_headings.py
  • compare_pdf_pixels.py
  • optimize_heading_linebreaks.py
  • plan_package_regression.py

这些脚本是辅助工具箱，不是唯一工作流；NSFC 专项工具不能默认替代 paper / thesis / cv 的官方入口。

边界

允许：

  • 调整项目层版式参数、标题体系、入口装配
  • 把共享实现沉淀到 packages/bensz-*
  • 修改 profile、style、wrapper、官方 compare 验收链

避免：

  • 把共享实现复制回单个项目
  • 绕过官方构建入口只跑裸 xelatex
  • 为了像素对齐破坏仓库真实分层
  • 默认改写用户正文语义

验收标准

  1. 改动落在正确层级
  2. 通过对应产品线官方入口
  3. warning 需要说明是已有还是新增
  4. 若改了公共包，必须说明回归了哪些模板
  5. 若用户给 baseline，完成必要 compare
  6. paper 默认兼顾 PDF 与 DOCX；cv 默认兼顾中英文；thesis 默认兼顾 profile/style 与项目入口一致性