SuperAPI AI 工具集

skill-forge

智能体与模型

查看项目

更新于 10-15 22:39

技能介绍

用途:Skill Forge 用于创建、测试、改进、打包和维护 Claude Code 与 Codex 技能。默认流程为:明确技能边界,起草或编辑 SKILL.md,编写真实评测提示,运行技能与基线,评分、汇总并向用户展示查看器,依据反馈迭代,最后可选优化 frontmatter 描述并打包。若用户只想头脑风暴,则跳过评测,充当设计伙伴;若已有草稿,则从验证、评测或迭代开始。

主要能力:按需读取 references 下的参考文件,包括 skill_authoring.md、eval_workflow.md、description_optimization.md、openai_yaml.md、skill_creator_comparison.md、trigger_eval_boundaries.md、schemas.md、platform_notes.md;agents 目录提供 grader、comparator、analyzer 等子代理说明。支持技能起草、验证、评测、基准测试、盲测对比、触发描述优化与打包。

使用方式:在 skill-forge 目录先执行 uv sync --group dev,所有脚本用 uv run 调用。生成 Codex 元数据:uv run python -m scripts.generate_openai_yaml <skill-dir>。验证:uv run python -m scripts.quick_validate <skill-dir>,可加 --platform claude、--platform codex、--platform codex --strict-openai-yaml。触发优化示例:uv run python -m scripts.run_loop --eval-set <path-to-trigger-eval.json> --skill-path <path-to-skill> --model <model-id-powering-this-session> --max-iterations 5 --verbose,Codex CLI 加 --cli codex。打包:uv run python -m scripts.package_skill <path/to/skill-folder>。

适用场景:新建或编辑 SKILL.md、编写评测提示、运行评测与基准、优化触发描述、生成 Codex 元数据、打包技能。

限制:仅在请求明确针对技能本身时使用;运行昂贵评测、改变触发行为或打包前需用户确认;Claude.ai 无子代理,需自行运行测试并跳过基线;Cowork 可能无浏览器,需生成静态查看器;描述优化依赖 claude -p 或 codex exec,无合适 CLI 时跳过;缺失 uv 时需引导用户访问 https://docs.astral.sh/uv/。