Agent skill

complete-example

当用户明确要求"填充示例内容""生成示例""补充 LaTeX 示例"时使用。AI 增强版 LaTeX 示例智能生成器，实现 AI 与硬编码的有机融合：AI 做"语义理解"（分析章节主题、推理资源相关性、生成连贯叙述），硬编码做"结构保护"（格式验证、哈希校验、访问控制）。

View SKILL.md on GitHub Repository
Stars 1,358
Forks 155

Install this agent skill to your Project

npx add-skill https://github.com/huangwb8/ChineseResearchLaTeX/tree/main/skills/complete-example

Metadata

Additional technical details for this skill

author
Bensz Conan
keywords
complete-example latex 示例生成 AI 增强 格式保护 语义理解 资源整合 nsfc
triggers 
[
    "\u586b\u5145\u793a\u4f8b",
    "\u751f\u6210\u793a\u4f8b",
    "complete example",
    "\u8865\u5145\u793a\u4f8b\u5185\u5bb9"
]
short description
AI 增强版 LaTeX 示例智能生成器

SKILL.md

complete-example Skill

与 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 仓库。

定位

  • 用于给现有 LaTeX 项目补“示例内容”，不是写真实科研结论。
  • AI 负责语义理解、资源关联和叙事生成；硬编码负责文件扫描、结构保护、格式验证和备份。
  • 重点是“生成得像一个完整示例”，同时不破坏模板骨架和系统文件。

输入

必需：

  • project：项目名称或路径。

常用可选参数：

  • content_density：minimal / moderate / comprehensive
  • output_mode：preview / apply / report
  • target_files：默认自动检测 extraTex/*.tex
  • narrative_hint：指导示例叙事方向，但仍属于“示例场景”

默认值与细节统一读取 config.yaml。

输出

  • 所有运行产物写入 {project_path}/.complete_example/<run_id>/
  • 典型结构：
    • backups/
    • logs/
    • analysis/
    • output/
    • metadata.json
  • output_mode=apply 时才写回项目；其它模式只给预览或报告。

硬规则

  • 禁止修改系统文件：main.tex、extraTex/@config.tex、@config.tex
  • 黑名单文件要做访问控制与哈希校验；若检测到非法修改尝试，必须拒绝。
  • main.tex 只允许 \section / \subsection；输入类 extraTex/*.tex 只允许 \subsubsection / \subsubsubsection
  • 生成内容必须保持“示例”属性，不伪装成真实实验或真实数据来源。

工作流

  1. 扫描项目中的 figures、code、references 等资源。
  2. AI 分析章节主题、关键概念、语气和上下文。
  3. AI 推理资源与章节的相关性，并决定内容类型组合。
  4. 生成连贯的示例叙述，可参考 narrative_hint。
  5. 用硬编码模板包装成合法 LaTeX。
  6. 自检并优化生成内容。
  7. 执行格式与结构验证，需要时生成质量报告。

职责划分

  • AI：语义分析、资源选择、文本生成、自我优化。
  • 硬编码：文件扫描、Top-K 选择、LaTeX 包装、格式保护、备份、日志、结构校验。

关键配置

重点关注 config.yaml 中的：

  • parameters.*
  • run_management.*
  • scan.*
  • generation.*
  • generation.section_hierarchy.*
  • generation.templates.*

适用与不适用

  • 适用：需要为 NSFC / thesis / paper 等项目补示例章节、示例表格、示例图文叙事。
  • 不适用：真实科研写作、模板修复、结构性重构、修改系统配置文件。

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

huangwb8/ChineseResearchLaTeX

systematic-literature-review

当用户明确要求"做系统综述/文献综述/related work/相关工作/文献调研"时使用。AI 自定检索词，多源检索→去重→AI 逐篇阅读并评分（1–10分语义相关性与子主题分组）→按高分优先比例选文→自动生成"综/述"字数预算→资深领域专家自由写作（固定摘要/引言/子主题/讨论/展望/结论），保留正文字数与参考文献数硬校验，强制导出 PDF 与 Word。支持多语言翻译与智能编译（en/zh/ja/de/fr/es）。

1,358 155
Explore
huangwb8/ChineseResearchLaTeX

nsfc-humanization

去除 NSFC 标书中的 AI 机器味，使文本读起来像资深领域专家亲笔撰写（不适用：非标书内容/需修改格式/需补充新内容）

1,358 155
Explore
huangwb8/ChineseResearchLaTeX

nsfc-research-foundation-writer

1,358 155
Explore
huangwb8/ChineseResearchLaTeX

nsfc-research-content-writer

当用户明确要求"写/改研究内容""研究内容+创新+年度计划编排"时使用。为 NSFC 正文"（二）研究内容"写作/重构，并同步编排"特色与创新"和"三年年度研究计划"，输出可直接落到 LaTeX 模板的三个 extraTex 文件。

1,358 155
Explore
huangwb8/ChineseResearchLaTeX

nsfc-qc

当用户明确要求"标书QC/质量控制/润色前质检/引用真伪核查/篇幅与结构检查"时使用。对 NSFC 标书进行只读质量控制：并行多线程独立检查文风生硬、引用假引/错引风险、篇幅与章节分布、逻辑清晰度等，最终输出标准化 QC 报告；中间文件默认归档到“交付目录内的隐藏工作区（.nsfc-qc/）”，并兼容 legacy `.nsfc-qc/`。

1,358 155
Explore
huangwb8/ChineseResearchLaTeX

nsfc-code

根据 NSFC 标书正文内容，结合申请代码推荐库，为你给出 5 组申请代码1/2（主/次）推荐与理由；输出到 NSFC-CODE-vYYYYMMDDHHmm.md（只读，不修改标书）

1,358 155
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results