SuperAPI AI 工具集

modular-skills

智能体与模型

查看项目

更新于 10-15 17:20

技能介绍

用途:将复杂技能拆分为聚焦模块,用渐进式披露控制 token 用量,避免单体大文件触及上下文上限。适用于在 token 预算紧张时构建可组合技能模块;若单文件技能已在预算内,或关注懒加载契约本身,则不建议使用。

主要能力:skill-analyzer 检查复杂度并建议拆分位置;token-estimator 预测用量并给出优化建议;module_validator 校验结构是否符合项目规范。模块按单一职责、低耦合设计,通常每个文件不超过 150 行,便于隔离验证与解析。

使用方式:分析用 python scripts/skill_analyzer.py --file path/to/SKILL.md --threshold 100;估算 token 在技能目录运行 python scripts/tokens.py;结构校验运行 python scripts/abstract_validator.py --scan。Python 中可用 abstract.skill_tools 的 analyze_skill。查找超长模块可用 find modules -name "*.md" -exec wc -l {} + | awk '$1 > 100'。

模块归属:已弃用 skills/shared/modules/ 目录;当前模式为每个技能在 skills/<skill-name>/modules/ 下自持模块,多技能共享内容由主拥有者持有,其他技能通过相对路径引用,校验器会标记残留的 shared 目录。

限制与要求:拆分阈值以 150 行为参考,超过 100 行的模块可考虑拆分;不得添加目录(Table of Contents)。完成标准包括模块不超 150 行、无 shared/modules 目录、校验脚本无结构警告且 token 估算在声明预算内。其他细节资料未提供。