@joohw/boss-cli 0.1.1

package/AGENTS.md

@@ -0,0 +1,25 @@
+# 项目协作规则
+
+## 基本原则
+
+- 禁止添加任何回退逻辑（fallback）。
+- 禁止添加掩盖根因的“胶水代码”。
+- 默认采用单一路径、可预测行为；未经明确要求，不引入隐式分支。
+
+## 失败处理
+
+- 失败应直接暴露，不做静默兜底。
+- 错误信息必须清晰、可定位，日志应包含关键上下文。
+- 发现问题优先修复根因，不通过绕路方案规避。
+
+## 变更约束
+
+- 小步修改，保持最小必要改动。
+- 不在未被要求的范围内扩散改动。
+- 规则优先级：用户明确要求 > 本文件约束。
+
+## Puppeteer evaluate 约束（重要）
+
+- 在工具代码中，避免使用 `page.evaluate(() => { ... })` / `page.waitForFunction(() => { ... })` 的函数写法。
+- 统一改为字符串脚本写法（如 `page.evaluate("(() => { ... })()")`），避免构建后注入辅助符号导致浏览器上下文报错 `__name is not defined`。
+- 出现 `__name is not defined` 时，优先检查最近新增的 evaluate / waitForFunction 回调并改成字符串脚本，不要加兜底掩盖问题。