SuperAPI AI 工具集

agent-loader

智能体与模型

查看项目

更新于 10-16 09:55

技能介绍

用途:列出与加载两种作用域的 agent brains。REPO 作用域从 $CWD/.agents/agents 向上查找至 $REPO_ROOT/.agents/agents;USER 作用域为 $HOME/.agents/agents。先查 REPO 再查 USER,同名 agent 首次发现者优先。全局配置可把仓库克隆到 ~/.agents/agent-brains,再将 ~/.agents/agents 软链到 ~/.agents/agent-brains/agents。可通过 AGENT_BRAINS_ROOT 或脚本 --root 覆盖发现根,覆盖时使用 custom 作用域。

主要能力与用法:列出 agent 时运行 uv run python skills/agent-loader/scripts/list_agents.py,报告名称、描述、作用域与路径。列出工作流运行 uv run python skills/agent-loader/scripts/list_agents.py --agent <name> --workflows,报告名称、描述与路径。加载 agent 时先用 list_agents.py --agent <name> 解析路径,输出 name、description、scope、path,再按顺序读取 path/AGENTS.md、path/SOUL.md、path/MEMORY.md,然后确认激活并总结身份、主要职责、关键规则、可用技能与工作流。发现只读 AGENTS.md frontmatter,不读正文;列工作流只读 WORKFLOW.md frontmatter。默认不读 memories/ 全部文件、不读 skills//SKILL.md、不读 workflows//WORKFLOW.md,仅在任务匹配或用户要求时读取。

校验:无法解析 agent 时列出可用项而不猜测;缺少 AGENTS.md、SOUL.md 或 MEMORY.md 时报告缺失并只加载存在文件;frontmatter 缺 name/description 报需清理元数据;skills/ 或 workflows/ 直接放文件报布局违规。

边界:该技能只加载 agent 上下文,不创建、更新或审计 agent brains;这些操作需加载 agent-creator。