SuperAPI AI 工具集

skill-forge

智能体与模型

查看项目

更新于 10-26 16:18

技能介绍

skill-forge 是 AbsolutelySkilled 注册表的引导工具,用于从任意来源生成生产就绪的技能包。

用途

  • 将 GitHub 仓库、文档 URL 或领域主题转化为结构完整的技能文件夹。
  • 技能以文件夹形式组织,包含入口文件 SKILL.md 以及可选的参考文档、脚本、模板、数据文件等,供智能体按需读取和使用。

主要能力

  • 支持 URL 输入研究:按优先级抓取 /llms.txt、README、/docs/、API 参考、指南、变更日志,并回答六个发现性问题以建立心智模型。
  • 支持领域主题头脑风暴:通过交互式提问确定目标受众、范围、关键知识点、常见错误、子领域和输出格式,在用户批准范围后才开始撰写。
  • 区分技能与智能体定义:技能是可移植的知识包,智能体定义是执行上下文;该工具只生成技能。
  • 内置配置管理:首次运行检查 forge-config.json,询问默认输出目录、技能类型偏好和安装目标,并存储答案。
  • 维护锻造历史:每次成功后向 forge-log.jsonl 追加记录,用于避免重复、参考先前模式、跟踪分类覆盖。
  • 提供校验脚本 scripts/validate-skill.sh 检查结构和常见问题。
  • 生成 evals.json(10-15 个评估用例)和可选的 sources.yaml。
  • 支持多种安装位置:注册表 PR(skills/<name>/)、全局(~/.agents/skills/<name>/)、项目级跨客户端(.agents/skills/<name>/)、仅 Claude 项目(.claude/skills/<name>/)。

使用方式

  • 斜杠命令:/skill-forge <url-or-topic>。
  • 首次运行按提示选择输出目录、技能类型和安装目标。
  • 输入为 URL 时进入研究阶段;输入为领域主题时进入头脑风暴阶段;模糊时询问用户。
  • 撰写遵循渐进披露原则,SKILL.md 控制在约 300 行以内,详细内容放入 references/ 文件。
  • 撰写完成后运行校验脚本,再按配置路径输出技能文件夹。

适用场景

  • 为特定工具、API 或领域知识快速构建可复用的智能体技能包。
  • 向 AbsolutelySkilled 注册表贡献技能。
  • 在团队项目或个人全局环境中安装跨客户端技能。

限制

  • 该工具生成的是技能而非智能体定义;若需要隔离上下文、特定工具权限或独立模型,应参考 Claude Code 的智能体文档。
  • 技能质量高度依赖研究深度,研究未完成前不应撰写 SKILL.md。
  • 领域技能若完全来自训练知识和用户输入,可省略 sources.yaml。
  • 资料未提供具体收费、价格或平台兼容性之外的额外效果说明。