Codex 插件【Data Dolphin】：Dolphin 技术上下文

Data Dolphin 插件就像一个面向软件项目的技术上下文助手。它可以把 Codex 连接到 Dolphin Sistemas 的结构化知识库，查询项目资料、技术文档、架构规则和智能体指令，为代码生成、问题排查和方案设计补充真实的项目背景。

它适合已经使用 Dolphin Sistemas 管理项目知识，并希望减少反复解释业务规则、系统结构和开发约定的团队。

一、Data Dolphin 能做什么

图 1：Data Dolphin 获取并应用技术上下文的基本流程

1、查询项目基本信息

用户可以指定项目名称或项目标识，让插件查询项目用途、生命周期状态、技术范围和相关资料。

当组织中存在多个系统时，应先确认目标项目，再继续检索文档和规则，避免把不同项目的上下文混合使用。

2、读取技术文档

Data Dolphin 可以检索项目规格、接口说明、部署文档和其他技术资料，并返回与当前问题相关的内容。

例如，在修改认证模块前，可以先查询现有认证流程、接口约定和环境配置，而不必仅根据代码片段推测系统行为。

3、获取架构与业务规则

插件可以提供项目中的架构规则和业务约束，例如模块边界、依赖方向、数据处理要求和禁止采用的实现方式。

Codex 可以据此检查新代码是否违反既有设计，或在提出方案时说明哪些规则影响了最终选择。

4、读取智能体指令

不同项目可能为 AI 智能体设置专门的工作要求，例如代码风格、测试方式、允许修改的目录和输出格式。

Data Dolphin 可以取得这些指令，使 Codex 在处理项目任务时遵循组织约定，而不是每次都由用户重新说明。

5、组合实现上下文

查询到项目、文档、规则和智能体指令后，可以把相关内容组合成实现上下文。

Codex 可以基于这些信息生成修改计划、代码建议、风险清单和待确认事项。部分部署还可能提供文档或规则草案工具，但具体可用操作取决于当前权限和插件版本。

二、怎样把任务说清楚

使用 Data Dolphin 时，应说明项目、查询主题、技术对象和预期用途。

至少应提供以下信息：

1、项目范围：项目名称、标识或所属系统。

2、查询对象：文档、架构规则、业务规则或智能体指令。

3、技术主题：接口、模块、数据库、部署或故障。

4、任务目标：理解系统、修改代码、排查错误或设计方案。

5、输出要求：上下文摘要、实施建议、风险或依据来源。

可以使用下面的模板：

请使用 Data Dolphin 查询以下项目的技术上下文。

项目：[项目名称或标识]

任务目标：[需要完成的工作]

涉及模块：[模块或服务]

查询内容：[文档、规则、指令等]

当前问题：[已有代码、报错或需求]

输出要求：[摘要、方案、风险清单]

完成后请说明：使用了哪些项目资料、必须遵守的规则、推荐方案、存在的冲突和仍需确认的信息。

三、场景示例

示例 1：开始开发任务

查询目标项目的架构规则、相关文档和智能体指令，再生成实现计划。

示例 2：理解现有接口

查找指定接口的用途、输入输出、调用关系和相关业务规则，并与当前代码进行核对。

示例 3：检查方案合规性

比较新设计与项目架构约定，指出模块依赖、数据访问或命名方面的冲突。

示例 4：排查历史原因

查询某项技术决策及相关文档，说明当前实现为何采用这种结构，以及是否存在替代方案。

示例 5：接手已有项目

汇总项目目标、主要模块、关键规则、技术文档和智能体指令，形成开发入门摘要。

四、使用时要注意

1、明确项目范围

相似模块可能存在于多个项目中。查询时应提供准确的项目标识，避免引用错误上下文。

2、检查资料状态

技术文档和规则可能处于草案、有效或已废弃状态。使用前应确认版本、状态和更新时间。

3、区分原始资料与 AI 推断

插件返回的项目资料属于检索结果；Codex 根据资料提出的原因分析和实现建议属于推断，两者应分别说明。

4、遵循访问权限

Data Dolphin 的访问受到组织身份验证和项目权限限制。公开说明提到 OAuth 2.0 与 Keycloak，具体可读、可写范围仍应以当前账户和部署配置为准。

5、不能替代代码与运行数据

技术上下文可以解释设计和约束，但代码现状、依赖版本、测试结果和运行日志仍需通过代码仓库与开发工具核验。

小结

Data Dolphin 插件可以为 Codex 提供项目文档、架构规则、业务约束和智能体指令，帮助开发者在真实技术上下文中理解和修改系统。明确项目范围并核对资料状态，是获得可靠结果的关键。

“点赞有美意，赞赏是鼓励”