AgentFolio
概览
此公共收录副本将 https://github.com/sickn33/antigravity-awesome-skills 中的 plugins/antigravity-awesome-skills/skills/agentfolio 打包成原生 Omni Skills 编辑形态,且不隐藏其来源。
当操作员需要保持上游工作流、支持文件和仓库上下文完整,同时让公共验证器和私有增强器继续其正常的下游流程时使用。
此收录操作保持复制的上游文件完整,并使用 metadata.json 中的 external_source 块以及 ORIGIN.md 作为审查的来源锚点。
AgentFolio 角色:自主代理发现指南
当你希望跨生态系统发现、比较和研究自主 AI 代理时使用此技能。AgentFolio 是一个精选目录,位于 https://agentfolio.io,追踪代理框架、产品和工具。此技能帮助你:
- 在从头构建之前,先找到现有的代理。
- 绘制代理框架和托管产品的全景图。
- 收集关于代理能力的具体示例和基准。
未完全映射到公共标题的导入来源章节仍保留在下方或支持文件中。值得注意的导入章节:能力、如何使用 AgentFolio、局限性。
何时使用此技能
将本章节作为触发筛选条件。在操作员加载文件、运行命令或打开拉取请求之前,它应明确激活边界。
- 在新的代理或工作流项目开始时。
- 评估要集成的供应商或工具时。
- 当你希望从现有代理产品中获得灵感或最佳实践时。
- 当请求与导入来源的意图明确匹配时:使用 AgentFolio 目录发现和研究自主 AI 代理、工具和生态系统。
- 当操作员应保留上游工作流细节,而不是从头重写流程时。
- 当来源信息需要在答案、拉取请求或审查包中保持可见时。
操作表
| 场景 | 从这里开始 | 为什么它重要 |
|---|---|---|
| 首次使用 | metadata.json | 在接触复制的工作流之前,通过 external_source 块确认仓库、分支、提交和导入路径 |
| 来源审查 | ORIGIN.md | 为审查者提供导入来源的通俗语言审计轨迹 |
| 工作流执行 | SKILL.md | 以最小、实质性改变执行的复制文件开始 |
| 支持上下文 | SKILL.md | 添加下一个最相关的复制源文件,无需加载整个包 |
| 移交决策 | ## 相关技能 | 当任务偏离时,帮助操作员切换到更强的原生技能 |
工作流
此工作流有意兼具编辑和操作性质。它使导入的来源对操作员仍然有用,同时满足下游增强器流程所需的公共收录标准。
- 定义问题:“CI 管道的自主测试失败分类”。
- 使用 AgentFolio 搜索:
- “测试代理”、“CI 代理”、“DevOps 助手”、“事件分类”。
- 对于每个相关的代理:
- 注意支持的平台(GitHub、GitLab、Jenkins 等)。
- 捕捉它们如何解释自主性和安全边界。
- 如果你计划采用而非构建,记录定价/许可约束。
导入的工作流说明
导入:示例工作流
1) 在构建新代理之前进行全景扫描
- 定义问题:“CI 管道的自主测试失败分类”。
- 使用 AgentFolio 搜索:
- “测试代理”、“CI 代理”、“DevOps 助手”、“事件分类”。
- 对于每个相关的代理:
- 注意支持的平台(GitHub、GitLab、Jenkins 等)。
- 捕捉它们如何解释自主性和安全边界。
- 如果你计划采用而非构建,记录定价/许可约束。
2) 新技能的竞争与灵感研究
- 如果你计划添加新技能(例如,可观测性代理、安全代理):
- 使用 AgentFolio 查找类似的代理和功能。
- 提取你想要模仿或避免的 3-5 个具体模式。
- 将这些模式转化为你技能本身的清晰需求。
3) 供应商短名单
- 在多个代理供应商之间选择时:
- 将 AgentFolio 条目用作中立目录。
- 构建一个比较表(列:功能、集成、定价、信任与安全)。
- 使用该表推动更正式的评估或概念验证。
导入:能力
- 按用例发现自主 AI 代理、框架和工具。
- 按功能、目标用户和集成面比较代理。
- 识别市场空白或新技能/工作流的灵感。
- 收集示例代理行为和用户体验模式,用于你自己的设计。
- 追踪代理架构和部署中的新兴趋势。
示例
示例 1:直接请求上游工作流
使用 @agentfolio-v2 处理 <任务>。从复制的上游工作流开始,只加载改变结果的文件,并在答案中保持来源可见。
说明: 当操作员需要导入的工作流,但不需要整个仓库时,这是最安全的起点。
示例 2:请求基于来源的审查
根据 metadata.json 和 ORIGIN.md 审查 @agentfolio-v2,然后解释你会首先加载哪些复制的上游文件以及原因。
说明: 在进行审查或故障排除之前,当你需要精确、可审计的来源和文件选择解释时使用。
示例 3:在执行前缩小复制的支持文件范围
使用 @agentfolio-v2 处理 <任务>。只加载改变结果的复制参考、示例或脚本,并在继续之前明确列出文件名。
说明: 这使技能与渐进式披露保持一致,而不是默认加载整个复制包。
示例 4:构建审查者包
使用复制的上游文件及来源信息审查 @agentfolio-v2,然后在合并前总结任何差距。
说明: 当拉取请求正在等待人工审查并且你需要一个可重复的审计包时,这很有用。
导入的使用说明
导入:示例提示
在 AI 编码代理中使用此技能时,使用以下提示:
- “使用 AgentFolio 找到 3 个专注于代码审查的自主 AI 代理。对于每个代理,总结其核心价值主张、支持的语言以及它们如何集成到开发者工作流中。”
- “扫描 AgentFolio 中帮助客户支持分类的代理。列出顶级选项、它们的目标客户规模(中小企业与企业)以及任何显著的用户体验模式。”
- “在我们构建自己的研究助手之前,使用 AgentFolio 绘制现有的研究/分析代理图,并突出我们可以填补的空白。”
最佳实践
将生成的公共技能视为上游仓库的一个可审查的打包层。目标是保持来源明确,并只加载那些实质性改善执行的复制源材料。
- 保持导入的技能以上游仓库为基础;不要发明源材料无法支持的步骤。
- 优先使用最小有用的支持文件集,以便工作流保持可审计且易于审查。
- 在注释和拉取请求描述中保持来源、源提交和导入文件路径的可见性。
- 直接指向证明工作流合理性的复制上游文件,而不是依赖通用的审查模板。
- 将生成的示例视为脚手架;在执行前将其适应具体任务。
- 当架构、调试、设计或安全问题成为主导时,路由到更强的原生技能。
故障排除
问题:操作员跳过了导入的上下文,回答过于泛化
症状: 结果忽略了 plugins/antigravity-awesome-skills/skills/agentfolio 中的上游工作流,未提及来源,或根本没有使用任何复制的源文件。
解决方案: 重新打开 metadata.json、ORIGIN.md 以及最相关的复制上游文件。首先检查 external_source 块,然后在继续之前重新陈述来源信息。
问题:审查期间导入的工作流感觉不完整
症状: 审查者可以看到生成的 SKILL.md,但他们无法快速判断哪些参考、示例或脚本对当前任务重要。
解决方案: 指出确切的复制参考、示例、脚本或资产,以证明你所采取路径的合理性。如果差距确实存在,在拉取请求中记录下来,而不是隐藏它。
问题:任务偏离到了不同的专业领域
症状: 导入的技能从正确的地方开始,但工作变成了原生技能处理得更好的调试、架构、设计、安全或发布编排。 解决方案: 使用相关技能部分有意识地移交。保持导入的来源可见,以便下一个技能继承正确的上下文,而不是从零开始。
相关技能
@00-andruia-consultant- 当此导入技能建立上下文后,工作更适合由该原生专业处理时使用。@00-andruia-consultant-v2- 当此导入技能建立上下文后,工作更适合由该原生专业处理时使用。@10-andruia-skill-smith- 当此导入技能建立上下文后,工作更适合由该原生专业处理时使用。@10-andruia-skill-smith-v2- 当此导入技能建立上下文后,工作更适合由该原生专业处理时使用。
额外资源
将此支持矩阵和以下链接文件用作此导入技能的操作员包。它们应反映真实的复制源材料,而非通用脚手架。
| 资源系列 | 它给审查者提供什么 | 示例路径 |
|---|---|---|
references | 复制的上游参考说明、指南或背景材料 | references/n/a |
examples | 复制的上游工作示例或可复用提示 | examples/n/a |
scripts | 改变执行或验证的上游辅助脚本 | scripts/n/a |
agents | 真正属于导入包的路由或委派说明 | agents/n/a |
assets | 复制的源包中的支持资产或模式 | assets/n/a |
导入的参考说明
导入:如何使用 AgentFolio
-
打开目录
- 在浏览器中访问
https://agentfolio.io。 - 可选择按类别过滤(例如,开发者工具、运维、营销、生产力)。
- 在浏览器中访问
-
按意图搜索
- 从你想要解决的问题开始:
- “客户支持代理”
- “自主编码代理”
- “研究/分析代理”
- 在 AgentFolio 搜索栏中使用与你领域或工作流匹配的关键词。
- 从你想要解决的问题开始:
-
评估候选方案
- 对于每个有趣的代理,记录:
- 核心承诺(它自动化什么结果)。
- 输入/输出形态(API、UI、数据源)。
- 自主性模型(一次性、多步骤、使用工具、人机协同)。
- 部署模型(SaaS、自托管、浏览器、IDE 等)。
- 对于每个有趣的代理,记录:
-
综合见解
- 使用发现结果来:
- 决定是集成现有代理还是构建自己的代理。
- 借鉴成功的 UX 和安全模式。
- 相对于生态系统定位你自己的代理技能和工作流。
- 使用发现结果来:
导入:局限性
- 仅当任务明确符合上述范围时使用此技能。
- 不要将输出视为特定环境验证、测试或专家审查的替代品。
- 如果缺少必要的输入、权限、安全边界或成功标准,请停下来寻求澄清。