SuperAPI AI 工具集

adhoc-skill

智能体与模型

查看项目

更新于 10-16 07:17

技能介绍

用途:管理用户级技能(skill),包括新建、改进和从源仓库同步到已安装位置。所有改动先在源仓库完成,再单向同步到 ~/.agents/skills/ 并自动展开符号链接。

配置:读取 ~/.adhoc-skill/config.json,其中 skill_roots 为技能源仓库目录列表,根目录下按子目录查找包含 SKILL.md 的技能。若配置不存在,需询问用户技能根目录后创建。

查找技能:按 skill_roots 顺序查找 <skill-name>/SKILL.md,匹配目录名或 SKILL.md frontmatter 中的 name 字段,首个匹配生效。

主要操作:

  • create:创建独立 git 仓库或已有仓库的子目录,使用 skill-creator 写入内容,随后同步并展开符号链接。
  • refine:查找源仓库、阅读现有实现、在源仓库修改、展示 diff 摘要并确认,然后同步与展开。提出“improve”“fix”“refine”时也可隐式触发。
  • sync:查找源仓库;若已安装则对比源码与已安装版本并显示差异,再复制同步(排除 .git/、pycache/、.DS_Store、node_modules/),随后执行 python3 ~/.agents/skills/adhoc-skill/scripts/fanout.py <name> 展开符号链接。提出“install”“deploy”“repo2skill”时也可隐式触发。
  • sync --all:扫描全部技能根目录,逐一同步并展开。
  • 无参数:列出所有已知技能及其安装与同步状态。

限制与注意:同步为单向,仓库 → ~/.agents/skills/,绝不直接修改已安装目录;不自动提交源仓库,仅编辑文件由用户提交;改动前需阅读 SKILL.md 理解技能结构;fanout 脚本通过检查已指向 ~/.agents/skills/ 的代理目录自动发现目标。