Agent Directory

Agent Directory 是什么

Agent Directory 是 Agent 注册与发现 Skill，用目录记录名称、能力、输入输出、端点、状态和权限边界。

适用场景

使用前应先确认任务目标、对象、输入范围和成功标准，再判断该 Skill 是否比官方客户端、单一脚本或人工流程更合适。涉及账号、外部写入、上传素材、付费服务、自动发送或敏感信息时，应在真实动作前设置明确确认点。

核心能力与工作机制

它帮助路由器按任务匹配执行者，并区分自我声明能力与已验证能力；目录本身不等于信任或安全认证。

执行流程

先定义注册 schema、身份和验证方式，新增 Agent 时核对所有者、能力与端点；查询时按任务和权限筛选，调用前再次确认状态，定期下线过期或失效条目。

输入与输出

开始前需要提供清晰目标、必要文件或资源标识、允许访问的账号与目录、期望格式、时间口径及不能改变的事实和约束。缺少会改变路线、费用、权限或隐私判断的信息时，应先补齐。输出除最终文件、记录或分析结果外，还应保留输入范围、关键参数、任务或资源标识、执行状态与验证证据。草稿、预览、排队或局部成功不能描述为最终完成。

依赖、账号与权限

需要目录服务、网络和注册读取权限；写入、健康检查与远程调用应分别授权，凭据不得放入公开描述。

副作用、限制与风险

恶意或过期条目会把任务路由到错误端点，能力声明可能夸大，目录还可能泄露内部架构。执行可能读取本地或云端数据、写入文件、调用网络服务或改变外部系统。任何发送、发布、删除、覆盖、付费、部署、同步或持久配置动作，都应在执行前说明对象、影响范围和恢复方式。

不适用边界

不自动信任新 Agent，不公开秘密端点，不让目录记录扩大调用权限，不在状态不明时执行高风险任务。

失败处理与验收

失败时先保存输入、任务标识、日志与当前状态，检查是否已产生结果或副作用，再决定有限重试、回滚或替代路线，避免重复写入、重复发送、重复扣费和覆盖唯一原件。验收应查看真实文件、页面、记录、账号状态或任务终态，并抽查关键字段、数量、格式、权限和边界条件。无法实际验证的部分必须明确标注，不能只依据命令返回或计划文本推断成功。

适合谁使用

适合多 Agent 平台、工具市场和内部能力治理。

来源、版本与许可

本条目依据 SkillHub 热门榜、发布者详情和版本 1.2.0 的完整 SKILL.md 整理，核验日期为 2026 年 10 月 1 日。完整 SKILL.md 未声明许可证，公开可下载不代表可以任意复制、修改或再分发。 SkillHub 当前两套安全扫描状态为 benign、benign；该状态只是平台信号，不能替代对脚本、凭据、网络请求、数据外送与后续版本的人工审查。

常见问题

1. Agent Directory 主要解决什么问题？

Agent Directory 是 Agent 注册与发现 Skill，用目录记录名称、能力、输入输出、端点、状态和权限边界。使用前应先确认任务目标、对象、输入范围和成功标准，再判断该 Skill 是否比官方客户端、单一脚本或人工流程更合适。涉及账号、外部写入、上传素材、付费服务、自动发送或敏感信息时，应在真实动作前设置明确确认点。是否采用它，应以实际任务边界和可核验材料为准，不要因为榜单热度而跳过来源审查。

2. 开始前需要准备什么？

开始前需要提供清晰目标、必要文件或资源标识、允许访问的账号与目录、期望格式、时间口径及不能改变的事实和约束。缺少会改变路线、费用、权限或隐私判断的信息时，应先补齐。准备阶段不要代替用户猜测关键事实；缺少会改变路线、费用或权限的输入时，应先补齐再执行。

3. 它怎样完成任务并交付结果？

先定义注册 schema、身份和验证方式，新增 Agent 时核对所有者、能力与端点；查询时按任务和权限筛选，调用前再次确认状态，定期下线过期或失效条目。每个阶段都要保留输入、决策、输出和检查点，不能把计划、预览或排队状态描述成最终交付。

4. 需要哪些工具、账号或权限？

需要目录服务、网络和注册读取权限；写入、健康检查与远程调用应分别授权，凭据不得放入公开描述。凭据应放在安全环境中，并按最小权限授权；账号、网络或本地依赖不满足时应明确停止条件。

5. 它会产生哪些外部操作或副作用？

执行可能读取本地或云端数据、写入文件、调用网络服务或改变外部系统。任何发送、发布、删除、覆盖、付费、部署、同步或持久配置动作，都应在执行前说明对象、影响范围和恢复方式。涉及外部写入、上传、发送、付费或持久配置时，应在实际动作前说明影响范围并取得相应确认。

6. 哪些情况不适合使用？

不自动信任新 Agent，不公开秘密端点，不让目录记录扩大调用权限，不在状态不明时执行高风险任务。超出来源明确能力、专业资质或授权范围时，应切换到更合适的工具或交给专业人员处理。

7. 失败或结果异常时怎样恢复？

失败时先保存输入、任务标识、日志与当前状态，检查是否已产生结果或副作用，再决定有限重试、回滚或替代路线，避免重复写入、重复发送、重复扣费和覆盖唯一原件。恢复时优先查询已有任务、日志或备份，避免无上限重试、重复扣费、重复发送或覆盖唯一原件。

8. 如何验收结果并控制风险？

验收应查看真实文件、页面、记录、账号状态或任务终态，并抽查关键字段、数量、格式、权限和边界条件。无法实际验证的部分必须明确标注，不能只依据命令返回或计划文本推断成功。验收应基于真实文件、页面、任务终态或权威来源，并把未能实际检查的部分明确标记出来。