ag-dev

留意正在使用的 AG 产品、版本和封装框架

使用中的产品可能从上下文中一目了然；如果无法确定，可以根据导入功能的包来判断：

• grid 包以 @ag-grid- 或 ag-grid- 开头
• charts 包以 ag-charts- 开头
• studio 包为 ag-studio 或以 ag-studio- 开头

下文中的 {product} 指 grid、charts 或 studio。

可以通过项目的 package.json，或读取 node_modules 中已安装库的 package.json 来确定版本。

如果使用的是 react、vue、angular 框架，框架为 react、vue、angular；对于 Vanilla JS 应用或使用其他框架（例如 Svelte、Solid）的应用，框架为 javascript。

更新包版本时，使用 ag-update 技能

此技能附带一个同级技能“ag-update”。当用户要求更新 grid、charts 或 studio 包时，将任务委派给它。

不要猜测

编写代码时，必须确保所用 API 有明确依据，无论是遵循现有模式、用户指示，还是查阅我们的文档。如果不确定，请先进行调研，为操作找到依据。

优先使用专用功能，而非通用基础机制

如果产品提供了适用于当前需求的专用功能，就应使用该功能，而不是使用 valueGetter、自定义单元格渲染器、手动编写状态管理，或自行连接事件来实现相同的可见效果。排序、筛选、聚合、导出和 UI 都能理解内置功能；基础机制只是对应用代码不透明的实现，你必须手动重新实现相关行为，并确保它们始终保持同步。

“基础机制能渲染出正确的值”并不是拒绝内置功能的理由。你不熟悉某项功能也不是理由：你的训练数据可能落后于当前版本，因此不熟悉并不代表该功能不受支持。

请在实现之前检查，而不是事后检查。 在使用基础机制实现所需功能前，请先扫描 references/{product}/documentation-index.md，查找描述该功能的 slug；如果有可能匹配，就阅读对应页面。对于 Enterprise 功能，请遵循产品建议中的模块注册指导。

默认情况下查阅文档

编写代码时，你会遇到两个问题：

1. 你的训练数据中包含许多已弃用或已移除的 API 和包名，也可能没有较新的 API。
2. API 可能存在不明显的边界情况，以及与其他功能的交互。

查阅文档可以解决这两个问题。

如果要使用的 API 已明确，例如你正在遵循包含具体 API 名称的详细计划，或代码库中有可供复制的其他示例，那么可以直接编写代码。

否则，如果存在不确定之处，请查阅文档。若要查找当前使用版本对应的正确文档 URL，请加载 references/{product}/documentation-index.md 并遵循其中的说明。

在文档中找到你正在处理的功能，并阅读相关段落，以了解边界情况和交互。

加载产品专属建议

references/{product}/recommendations.md 中包含各产品的具体建议，包括已知的 LLM 失效模式，以及不同版本之间发生变更的重要 API。在开发时请加载并参考这些建议。