@routerhub/agent-rules 1.3.1 → 1.3.5
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 +19 -0
- package/package.json +1 -1
package/AGENTS.base.md
CHANGED
|
@@ -39,6 +39,12 @@
|
|
|
39
39
|
- 时间相关处理统一使用 `dayjs`。
|
|
40
40
|
- 数据回显优先使用对象展开运算符（`...`）。
|
|
41
41
|
|
|
42
|
+
## 生产环境操作安全规则
|
|
43
|
+
|
|
44
|
+
- **严禁在未明确授权时操作线上/生产服务器**：只有当用户的指令中明确包含"生产环境"、"线上"、"prod"、"production"等关键词时，才允许在生产服务器上执行任何操作（如部署、重启、修改配置、执行脚本等）。
|
|
45
|
+
- 若用户指令中没有上述关键词，默认只在本地或测试/开发环境中执行操作，不得擅自连接或操作生产服务器。
|
|
46
|
+
- 执行生产环境操作前，必须再次向用户确认目标环境，确认无误后方可执行。
|
|
47
|
+
|
|
42
48
|
## 分支管理规范
|
|
43
49
|
|
|
44
50
|
- 所有新建分支名称必须使用中文（汉字）或纯中文拼音，禁止英文缩写、数字、拼音与英文混用。
|
|
@@ -50,6 +56,8 @@
|
|
|
50
56
|
- 不要写 `try/catch`。
|
|
51
57
|
- 代码注释统一使用中文编写。
|
|
52
58
|
- 能复用现有函数或配置时，不要复制粘贴出第二份近似实现。
|
|
59
|
+
- 编写 Go 代码时，优先使用值传递与局部变量生命周期控制，避免不必要的内存逃逸（如无必要不要返回局部变量指针、避免在热路径中产生额外堆分配）。
|
|
60
|
+
- 编写代码需遵循 SOLID 原则，并结合场景合理应用设计模式优化可维护性与扩展性，避免过度设计。
|
|
53
61
|
|
|
54
62
|
## 测试用例规范
|
|
55
63
|
|
|
@@ -62,12 +70,23 @@
|
|
|
62
70
|
|
|
63
71
|
- 每次开发新功能时，尽可能将其封装为组件，方便后续在其它页面或场景中复用。
|
|
64
72
|
|
|
73
|
+
## 依赖安装规范
|
|
74
|
+
|
|
75
|
+
- 无论在 Docker 环境还是本地环境，安装和下载依赖都必须使用 `pnpm`，禁止使用 `npm install`、`yarn install` 等其它包管理器安装命令。
|
|
76
|
+
|
|
65
77
|
## 构建与发版前检查
|
|
66
78
|
|
|
67
79
|
- AI 写完代码后，必须先执行 `npm run format` 格式化本次修改涉及的文件。
|
|
68
80
|
- 每次完成需求修改后，必须先打开一个新终端执行 `npm run build`。
|
|
69
81
|
- 若构建报错，必须先修复所有错误并重新执行构建直至通过，再进行发版操作。
|
|
70
82
|
|
|
83
|
+
## Browser MCP 集成规则（tag: browser-mcp）
|
|
84
|
+
|
|
85
|
+
- 已集成 Browser MCP（Model Context Protocol）工具，支持在对话中自动查看和分析浏览器内容。
|
|
86
|
+
- 当需要获取网页内容、DOM 结构、页面截图或浏览器状态时，将自动使用 Browser MCP 进行查询和操作。
|
|
87
|
+
- 支持通过 Browser MCP 执行页面点击、表单填充、截图等自动化操作，用于前端开发验证和问题诊断。
|
|
88
|
+
- 使用 Browser MCP 收集信息后，应在回复中说明来源（如"从浏览器获取"），便于用户理解信息的获取方式。
|
|
89
|
+
|
|
71
90
|
## 组件复用规则
|
|
72
91
|
|
|
73
92
|
- **优先复用项目中已存在的组件**，写新功能时尽量不要创建新组件。
|