面向 Delphi、C++Builder 和 .NET 的 AI 智能体技能 | eSeGeCe 博客

面向 Delphi、C++Builder 和 .NET 的 AI 智能体技能

· 功能

让 AI 助手帮你用 Delphi 写一个 WebSocket 客户端,它会给出一段自信满满、结构良好,却微妙地出错的代码。一个并不存在的属性。一个放错单元的组件。一个三个版本之前就被移除的 API。然后你花二十分钟去找出那四行看似合理的代码中,究竟是哪一行编译不过。

原因很简单。这些模型是从公开代码中学习的,而 eSeGeCe 组件是商业产品,模型从未读过它们。它只知道一个 Delphi 组件库大致长什么样,其余部分则凭着对其他库的记忆自行补全。

我们发布了智能体技能来填补这个空缺。它们是免费的,采用 MIT 许可,安装时也不需要授权。

什么是智能体技能

技能就是一个由 Markdown 组成的文件夹,智能体按需加载。我们的技能收录了每个库的公开 API:每个组件、它的属性、事件和方法、它所在的单元或命名空间、包含它的版本,以及取自产品随附演示的真实示例。它们在每次发布时都从库源码重新生成,因此描述的是你手上真正拥有的版本,而不是模型模模糊糊记得的那个。

所有内容都在同一个仓库里,github.com/esegece-com/agent-skills,打包为六个插件。

安装方法

在 Claude Code 和 GitHub Copilot CLI 中,只需添加一次市场,然后安装你需要的插件:

/plugin marketplace add esegece-com/agent-skills
/plugin install sgcwebsockets-delphi@esegece

在 Codex CLI 中:

codex plugin marketplace add esegece-com/agent-skills
codex plugin add sgcwebsockets-delphi@esegece

在 VS Code 中,打开命令面板并运行 "Chat: Install Plugin From Source"。对于 Cursor 以及任何会读取技能文件夹的其他智能体,请把技能文件夹从仓库中复制到 .cursor/skills/.claude/skills/.github/skills/.agents/skills/.junie/skills/,具体取决于你使用的智能体。

这六个插件是 sgcwebsockets-delphisgcwebsockets-dotnetsgcsign-delphisgcopenapi-delphisgcindy-delphisgcbiometrics-delphi

为什么 sgcWebSockets 是 18 个技能,而不是一个

sgcWebSockets 注册了 222 个组件。用一个技能涵盖全部会太过庞大而失去意义:为了回答一个关于 MQTT 的问题,智能体得加载整个库。因此它按领域拆分,18 个技能分别覆盖 WebSocket 核心、消息代理、sgc 子协议、交易所行情、AI 与 LLM、服务集成、HTTP 与传输、身份验证、P2P 与 WebRTC、IoT,另外还有六个用于 sgcHTML 控件。

当智能体被要求连接到 MQTT 代理时,它只加载消息代理技能,别的都不加载。.NET 插件遵循同样的思路,包含 7 个技能。

一个技能里面有什么

每个技能开头都是一份手写的操作手册:这个技能的用途、你需要的 uses 子句或 using 指令、在动手写代码之前值得向开发者确认的问题,以及那些真正会让人栽跟头的错误。之后是生成的材料,包括完整的 API 参考(每个成员同时给出 Delphi 和 C++Builder 的签名,.NET 插件则给出 C#)、选项与枚举类型页面(好让智能体使用真实存在的常量)、从随附演示中提炼的示例,以及每个组件所需的版本。

最后这一点能省下一类特别浪费的下午时光。“这个组件不在我的面板上”通常是版本问题,而不是安装问题,技能在你开口之前就已经回答了它。

关于 .NET,实话实说

当前发布的 .NET 程序集暴露了 Delphi 库所注册的 222 个组件中的 70 个。与其让智能体去猜,.NET 插件随附了一个生成的覆盖范围页面,列出仅 Delphi 独有的那 152 个组件,并标明各自所在的单元。原本可能凭空编造一个看似合理的 C# API 的智能体,现在有地方可查了,而“这个能不能在 C# 里做”这个问题的诚实答案,只有一页之遥。

隐私

技能就是文档。没有任何东西被执行,没有任何东西被发送出去,也不收集任何遥测数据。技能只包含 public 和 published 的 API,因此方法体、私有字段和受保护成员都被刻意排除在外。安装它们不会把库源码放到你的磁盘上,也不会放到任何其他人的磁盘上。

保持最新

技能在每次发布时都从库源码重新生成,因此它们跟随产品而不会逐渐落后。重新运行安装命令即可获取新版本。如果你代码中的某个 API 与智能体描述的不一致,请查看技能内的 reference/history.md,因为通常的解释是你们两者用的是不同的构建版本。

完整细节和手动安装路径请见 AI 智能体技能页面

如果在安装了技能之后智能体仍然出错,那就是文档缺陷,我们很希望听到你的反馈。请在 GitHub 上提交 issue,或者 联系我们 — 回复你的将是编写这些代码的人。