@routerhub/agent-rules 1.5.36 → 1.5.38

package/AGENTS.base.md

@@ -235,3 +235,8 @@ Closes #456
 - 部署方式因项目而异，具体部署规则请在项目 `AGENTS.private.md` 中按需定义。
 - `.env` 文件中仅允许配置端口号（如 `PORT`、`API_PORT` 等），其余所有配置项（API 地址、数据库连接、第三方服务地址等）必须直接写死到代码中。
 - 密钥、Token、密码、证书等敏感信息不得写入 `.env` 或代码中，必须统一配置到 Nacos 配置中心，应用启动时从 Nacos 拉取。
+- 用户说「部署测试环境」时，必须按以下步骤执行：
+  1. **test 分支检查**：如果当前项目的 `test` 分支不存在，从主分支（`main` 或 `master`）创建 `test` 分支并推送到远程。
+  2. **合并当前分支到 test**：将当前功能分支合并到 `test` 分支。
+  3. **部署 test 分支**：按当前项目自己的部署方式部署 `test` 分支（如 Cloud Run 部署、容器部署、npm publish 等）。
+  4. **发新版本**：按当前项目自己的发版规则发布新版本（如 `./release.sh`、自动递增版本号等）。

package/README.md

@@ -18,4 +18,18 @@ pnpm i -D @routerhub/agent-rules
 
 写完 `AGENTS.private.md` 后，工具会自动生成项目可用的 `AGENTS.md` 和 `.github/copilot-instructions.md`。
 
-注意：pnpm i 的时候会启动一个watch函数自动帮你合并AGENTS.privite.md中的内容到AGENTNS.md，所以建议给项目配置一键启动脚本来，一键启动脚本里加上先pnpm i然后再启动每个项目
+## 更新
+
+当 `@routerhub/agent-rules` 有新版本时，锁文件不会自动追最新，需要手动更新：
+
+```bash
+pnpm update @routerhub/agent-rules --latest
+```
+
+更新后 `postinstall` 脚本会自动运行，重新同步规则文件。
+
+> 直接 `pnpm i` 会按 `pnpm-lock.yaml` 中的锁定版本安装，必须加 `--latest` 才能拿到最新版本。
+
+---
+
+注意：pnpm i 的时候会启动一个watch函数自动帮你合并AGENTS.privite.md中的内容到AGENTS.md，所以建议给项目配置一键启动脚本来，一键启动脚本里加上先pnpm i然后再启动每个项目

package/README.zh-CN.md

@@ -73,6 +73,18 @@ pnpm exec agent-rules sync
 3. 根据项目情况编辑 `AGENTS.private.md`
 4. 使用 `pnpm exec agent-rules sync` 或 `agent-rules watch` 生成最终的 `AGENTS.md`
 
+## 更新
+
+当 `@routerhub/agent-rules` 有新版本时，锁文件不会自动追最新，需要手动更新：
+
+```bash
+pnpm update @routerhub/agent-rules --latest
+```
+
+更新后 `postinstall` 脚本会自动运行，重新同步规则文件。
+
+> 直接 `pnpm i` 会按 `pnpm-lock.yaml` 中的锁定版本安装，必须加 `--latest` 才能拿到最新版本。
+
 ## 注意事项
 
 - 私有规则应只写项目特有的限制、接口地址、组件路径和业务规范

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@routerhub/agent-rules",
-  "version": "1.5.36",
+  "version": "1.5.38",
   "description": "Shared Copilot agent rules and guidelines for RouterHub projects",
   "main": "AGENTS.base.md",
   "bin": {