@routerhub/agent-rules 1.4.9 → 1.4.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.base.md +1 -7
- package/package.json +1 -1
package/AGENTS.base.md
CHANGED
|
@@ -73,6 +73,7 @@
|
|
|
73
73
|
- 代码注释统一使用中文编写。
|
|
74
74
|
- 每一行代码都必须有对应的中文注释,明确说明该行代码的作用。
|
|
75
75
|
- 能复用现有函数或配置时,不要复制粘贴出第二份近似实现。
|
|
76
|
+
- 发现重复或相似的代码、逻辑、样式时,必须主动提取并封装为公共函数、组件或工具方法,避免同类代码散落在多处;能封装的一律封装,降低维护成本。
|
|
76
77
|
- 编写 Go 代码时,优先使用值传递与局部变量生命周期控制,避免不必要的内存逃逸(如无必要不要返回局部变量指针、避免在热路径中产生额外堆分配)。
|
|
77
78
|
- 编写代码需遵循 SOLID 原则,并结合场景合理应用设计模式优化可维护性与扩展性,避免过度设计。
|
|
78
79
|
- 编写代码时必须注重封装性:同一份数据、配置或字段定义只在一个地方维护,其余位置通过引用或派生获取;修改某个字段或逻辑时,应只需改动一处即可全局生效,禁止同一语义散落在多处需要逐一同步修改。
|
|
@@ -117,13 +118,6 @@
|
|
|
117
118
|
- 部署测试环境或生产环境时,必须使用 VS Code 内置浏览器打开 Portainer 管理界面,通过图形化操作完成部署(如更新镜像、重启服务、查看日志等),禁止通过 SSH 连接服务器手动执行 docker 命令部署。
|
|
118
119
|
- Portainer 的地址和账号信息应在项目私有规则(`AGENTS.private.md`)或环境变量中配置,禁止硬编码。
|
|
119
120
|
|
|
120
|
-
## Browser MCP 集成规则(tag: browser-mcp)
|
|
121
|
-
|
|
122
|
-
- 已集成 Browser MCP(Model Context Protocol)工具,支持在对话中自动查看和分析浏览器内容。
|
|
123
|
-
- 当需要获取网页内容、DOM 结构、页面截图或浏览器状态时,将自动使用 Browser MCP 进行查询和操作。
|
|
124
|
-
- 支持通过 Browser MCP 执行页面点击、表单填充、截图等自动化操作,用于前端开发验证和问题诊断。
|
|
125
|
-
- 使用 Browser MCP 收集信息后,应在回复中说明来源(如"从浏览器获取"),便于用户理解信息的获取方式。
|
|
126
|
-
|
|
127
121
|
## 组件复用规则
|
|
128
122
|
|
|
129
123
|
- **优先复用项目中已存在的组件**,写新功能时尽量不要创建新组件。
|