SuperAPI AI 工具集

bptools-writer-expert

编程与开发

查看项目

更新于 11-13 16:18

技能介绍

bptools-writer-expert 是 vosslab/vosslab-skills 仓库中的一个技能,专门用于在 biology-problems 项目中创建、编辑和验证基于 bptools 的 Python 题目生成器以及 YAML 内容。其目标用户是负责维护生物题目生成器、调整题目随机化逻辑、实现防作弊策略或新增题型的开发者。

主要能力方面,该技能提供了一套围绕 bptools 的编写工作流:从请求分类、项目状态检测,到模板选择、代码实现、行为验证和最终清理。它强调复用仓库中已有的生成器模式和 bptools 辅助函数,而不是从零编写格式逻辑。技能附带多个参考文档,包括题目编写指南、任务分类、项目工作流、测试与预言机、文档索引、仓库路径和 API 接口说明,帮助用户在编写前了解规范。

使用方式上,技能要求在开始任何 bptools 编辑前先阅读 QUESTION_AUTHORING_GUIDE.md 和仓库根目录下的 bptools.py 实际文件,避免凭记忆编写。随后根据任务类型加载对应的领域指南(如匹配集、PubChem、选择题陈述、系谱、系统发育树等)。工作流建议先分类请求并检测目标仓库是全新项目还是已有项目:全新项目从 TEMPLATE.py 开始,编写作者契约并用 bptools 原语实现;已有项目则先检查现有生成器,每次只做一个生成器修改,并收集前后样本、种子日志和防作弊审计三个证明产物。实现时使用 bptools.formatBB_* 函数格式化题目,调用 collect_and_write_questions 和 make_outfile。验证时用小数量运行(如 -d 1),检查生成的 BBQ 文本格式和答案键,并运行相关测试。最后更新 CHANGELOG,并确保生成的临时文件不进入 git。

适用场景包括:为 biology-problems 编写新的 bptools 题目生成器、修改现有生成器的随机化或防作弊行为、校验 YAML 内容、处理特定题型(匹配集、PubChem、选择题陈述、系谱、系统发育树)等。该技能也支持在 delegate-manager-to-subagents 模式下由独立子代理执行单个有界任务。

限制方面,该技能仅适用于 biology-problems 仓库内部,且依赖仓库中的实际文件和参考文档。如果参考文档与实时仓库不一致,应以实时仓库为准。技能本身不提供题目生成器的具体功能、收费、平台或效果保证,相关细节需参考仓库实际内容。