代理整合

人工智能 社区

技能解读

当前原文的自动摘译,尚未人工审校。

参数

在开始之前收集这些(如果未提供,请询问用户): 参数 · 描述 · 如何导出 AGENT_NAME · 人类可读的名称(例如,“Gemini CLI”) · 用户提供 AGENT_PACKAGE · Go 包目录名称 — 无连字符 · 小写,删除连字符/空格 AGENT_KEY · agent.Register() 和 entire enable 的注册表项 ·检查cmd/entire/cli/agent/registry.go中现有的模式

架构参考

这些文档定义了代理集成合同: 实施指南:docs/architecture/agent-guide.md — 分步代码模板、事件映射、测试模式 集成清单:docs/architecture/agent-integration-checklist.md — 设计原则和验证标准

适用范围

该技能针对的是具有钩子功能的代理——那些支持生命周期钩子的代理(从agent.go实现HookSupport)。使用基于文件的检测(实现FileWatcher)的代理需要不同的集成方法(此处未介绍)。检查agent.go当前的接口定义。

核心规则:端到端优先 TDD

该技能强制实施严格的端到端优先的测试驱动开发。规则:E2E 测试是规范。现有的ForEachAgent测试场景定义了“工作”的含义。代理运行程序使这些测试可以为新代理运行。每一步都运行 E2E 测试。每个实施层都从运行 E2E 测试并观察其失败开始。你实施直到它通过。没有例外。单元测试是最后编写的。所有 E2E 层通过后(步骤 14),您可以使用从 E2E 运行收集的真实数据作为黄金固定装置来编写单元测试。

管道

按顺序运行这三个阶段。每个阶段都建立在前一阶段的输出之上。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
人工智能
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@entireio · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
即装即用
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第一阶段:研究

通过二进制探测和文档研究发现代理的钩子机制、转录格式和配置。在`cmd/entire/cli/agent/$AGENT_PACKAGE/AGENT.md`生成一个实现单寻呼机,其他阶段将其用作代理特定信息的单一来源。阅读并遵循`.claude/skills/agent-integration/researcher.md`的研究程序。预期输出:在`cmd/entire/cli/agent/$AGENT_PACKAGE/AGENT.md`实现单页程序,在`scripts/test-$AGENT_SLUG-agent-integration.sh`实现测试脚本。

02
第2阶段:编写E2E Runner

创建 E2E 代理运行程序,以便现有测试场景可以运行新代理。此阶段没有编写任何单元测试 - 也没有新的测试场景(现有的`ForEachAgent`测试是规范)。阅读并遵循`.claude/skills/agent-integration/test-writer.md`中的程序。预期输出:`e2e/agents/$AGENT_SLUG.go` 的 E2E 代理运行程序,编译并注册到测试框架。

03
第 3 阶段:实施(E2E 首先,单元测试最后)

使用严格的端到端优先 TDD 构建 Go 代理包。 E2E 测试推动每一步的开发 — 运行每一层,观察其失败,实施最低限度的修复,然后重复。仅在所有 E2E 层通过后才编写单元测试,并使用 E2E 运行的真实数据作为黄金固定装置。阅读并遵循`.claude/skills/agent-integration/implementer.md`的实施程序。预期输出:`cmd/entire/cli/agent/$AGENT_PACKAGE/` 处的完整代理程序包,所有 E2E 层均通过并且单元测试锁定行为。

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。