用途:优化 ToolUniverse JSON 配置文件中的工具描述,使其清晰、完整、易用。适用于审查新建工具描述、改进现有工具文档、向 ToolUniverse 添加新工具,或用户提到工具可用性、清晰度与文档时。
主要能力:提供优化清单与分级改进建议。关键项包括:明确必填输入(互斥选项用“Required: Provide ONE input type”并编号);在每类首个工具中补充前置条件(安装命令、API key、账号);首次出现时展开关键缩写(如 H5AD→HDF5-based AnnData、RPM→Reads Per Million、TSS、TAD、DRS);增强过滤参数说明(语法格式、运算符 ==、!=、in、<、>、<=、>=,and/or 组合,常见字段与示例);改进参数取值指导(含义、适用场景、权衡与推荐默认值);为互斥选项编号标注;为下载或返回大文件的工具添加文件大小警告;区分网页表单提交与 API 直接结果;解释不同文件类型差异。
使用方式:按优先级处理——立即修复必填输入、前置条件、缩写;尽快处理过滤描述、参数指导、互斥编号;可选处理文件大小、网页表单、文件类型。更新后校验 JSON 语法,例如:python3 -m json.tool src/tooluniverse/data/your_tools.json > /dev/null && echo "✓ Valid",或循环校验目录下所有 *_tools.json。
适用场景:ToolUniverse 工具描述审查与文档改进、新工具接入、提升首次使用成功率。
限制:资料未提供该技能的具体安装方式、运行环境依赖、收费与平台信息;效果数据(如错误减少比例)仅为资料中的预期,未提供验证来源。