用途:在用户明确要求“填充示例内容”“生成示例”“补充 LaTeX 示例”时,为现有 LaTeX 项目补写示例内容,而非真实科研结论。适用于为 NSFC、论文、学位论文等项目补充示例章节、示例表格、示例图文叙述;不适用于真实科研写作、模板修复、结构性重构或修改系统配置文件。
主要能力:AI 负责章节主题分析、资源相关性与叙事生成;硬编码负责文件扫描、Top-K 选择、LaTeX 包装、格式验证、备份、日志与结构校验。项目中的 figures、code、references 等资源会被扫描后按相关性选用。
必要用法:必需输入 project(项目名称或路径)。常用可选参数包括 content_density(minimal/moderate/comprehensive)、output_mode(preview/apply/report)、target_files(默认自动检测 extraTex/.tex)、narrative_hint。默认值读取 config.yaml,重点配置项为 parameters.、run_management.、scan.、generation.* 及相关子项。产物写入 {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。生成内容必须保持“示例”属性,不伪装成真实实验或真实数据来源。发现技能设计缺陷时应记录到 ~/.bensz-skills/bugs/,不直接修改已安装的技能源码。