openspec-playwright 0.3.27 → 0.3.30

package/employee-standards.md

@@ -10,42 +10,32 @@
 
 **项目规范**：动手前读 `openspec/config.yaml`（技术栈、结构、约定、约束等），无内容则忽略。
 
-E2E 工作流前提（由用户确保，非 AI 操作）：
-- gstack：`git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup`（提供 `/browse` 探索 + `/qa` 浏览器验证）
-- OpenSpec CLI：`npm install -g @fission-ai/openspec && openspec init`（提供变更管理能力）+ `npx openspec --help` 查看可用命令
-- openspec-playwright：`openspec-pw init`（提供 `/opsx:e2e` 命令）
-- 项目包含 `specs/`、`changes/`、`tests/playwright/` 目录
+**E2E 工作流前提**：工具链（gstack / OpenSpec CLI / openspec-playwright）由用户安装并维护，AI 不做安装操作。
 
-## 1. 浏览器操作约束
-
-所有浏览器操作用 gstack 的 `/browse` 探索 + `/qa` 验证。
-
-**冲突解决**：gstack 任何想直接修改代码的行为，都必须先确认当前 OpenSpec proposal 是否已存在并通过（检查 `changes/<name>/proposal.md` 是否处于 `approved` 状态）。
-
-## 2. 代码质量（强制执行）
+## 1. 代码质量（强制执行）
 
 **动手前先思考**：列出假设，逐条验证。复杂任务如有多种解释则都列出来，如有更简单的方案则提出来，必要时坚持己见。有不清楚的地方则停下来，说出困惑，再提问。
 
-**每步有可验证的退出条件**：多步骤任务先列计划（`1. [Step] → verify: [check]`），动手后循环验证直到成功。lint + typecheck 通过是最低验证标准。
+**每步有可验证的退出条件**：多步骤任务先列计划（`1. [Step] → verify: [check]`），动手后循环验证直到成功。lint + typecheck 自动执行，任一失败则停止。lint 失败时优先运行 `npm run lint:fix`。
 
 **只写被要求的东西**：不要加"灵活"、"可配置"、单次使用的抽象、没被要求的功能。200行能50行完成则重写。
 
-**精准改动**：只改必要的，改完清理自己造成的垃圾。匹配现有风格，不改进无关代码。每一行改动都应追溯到用户的请求。
+**精准改动**：只改必要的，改完清理自己造成的垃圾。匹配现有风格，不改进无关代码。
 
 **lint + typecheck 通过（项目标准工具链）才算成功**。动手前扫描项目根目录源码文件扩展名检测主语言——`.py`→Python（ruff + mypy）、`.ts`/`.tsx`→TypeScript（ESLint + tsc）、`.go`→Go（gofmt + vet），工具不存在时告知用户。
 
 **禁止非通用性改动**：
 - 不写只适配特定输入值的逻辑
-- 假设所有外部数据都有效 → 必须校验类型/范围/null
+- 禁止假设外部数据有效 → 必须校验类型/范围/null
 - 处理数据时考虑边界情况（空值、异常值、边界值）
 - 断言用通用规则，不用具体值（除非明确要求）
-- 禁止魔法数字 → 用常量或枚举，注释说明原因
+- 禁止魔法数字 → 用常量或枚举，注释说明原因（例如：`const MAX_RETRIES = 3; // 网络请求最大重试次数`）
 - 禁止隐式成功假设 → 异步/外部操作必须处理失败情况
 - 禁止响应结构假设 → 先校验返回结构再访问深层属性
 - 禁止精度/范围假设 → 计算前确认数值在安全范围内
 - 禁止资源泄漏假设 → 文件/连接/cursor 等使用后必须释放
 
-## 3. 上下文管理
+## 2. 上下文管理
 
 **文件读取完整**：超过 500 行的文件，不要假设单次读取覆盖完整内容——根据需要分次读取或编辑前重新读取完整文件。超过 10 条消息后，编辑任何文件前强制重新读取。
 
@@ -56,14 +46,18 @@ E2E 工作流前提（由用户确保，非 AI 操作）：
 4. 运行对应语言的 lint + typecheck 验证
 5. 然后继续实施
 
-**OpenSpec 阶段隔离**：所有阶段均由用户手动触发，不自动进入下一阶段。`/opsx:explore`、`/opsx:propose`、`/opsx:apply`、`/opsx:verify`、`/opsx:e2e` 均需用户明确调用。禁止在同一阶段内触发其他阶段（如 explore 阶段不能调用 apply，verify 阶段不能调用 e2e）。
+**OpenSpec 阶段隔离**：每个阶段由用户手动触发，禁止跨阶段跳步（explore 阶段不能调 apply，verify 阶段不能调 e2e）。
+
+**禁止跨 change 改动**：执行 `/opsx:apply <X>` 期间，不得修改 `changes/<Y>/`（X≠Y）下任何文件。看到其它 open change 的"顺手清理"诱惑一律拒绝。
 
 **重构前清死代码**：未使用的 import/export/prop/console.log 先删掉，单独提交，再做重构。
 
-## 4. 大规模任务处理
+## 3. 大规模任务处理
+
 **200 行以上修改或显著架构变更必须走 OpenSpec**：代码改动超过 200 行、或涉及新增服务/API 契约/数据模型重构时，禁止直接修改，必须通过 OpenSpec 工作流（/opsx:propose）。
 
-## 5. 工具限制与编辑安全
+## 4. 工具限制与编辑安全
+
 **搜索要全**：用 Grep 搜内容，用 Glob 搜文件名。两者缺一不可。搜项目/工作区时默认包含所有源码类型，跳过 node_modules/、vendor/、__pycache__ 等依赖目录（调试依赖时除外）；搜子目录时按需缩小。重命名时覆盖调用、类型、字符串、`import`、barrel file、测试 mock，不得假设一次覆盖所有情况。
 
 **编辑要求**：编辑后重新读取文件确认变更正确应用。变更完成后，明确告知用户可能遗漏的区域（动态引用、测试 mock 等），提示人工复查。
@@ -74,54 +68,14 @@ E2E 工作流前提（由用户确保，非 AI 操作）：
 
 **中文回复**：用中文回复用户。
 
----
-
-## 6. 完整生产工作流
-
-```
- 1. 探索与提案
- 2. 产品与架构评审（按需触发）
- 3. 设计审查 → /plan-design-review
- 4. 实现 → /opsx:apply
- 5. 自审 → /opsx:verify
- 6. E2E 测试 → /opsx:e2e <change-name> → /browse 探索 + /qa 验证
- 7. 发布 → 用户手动 /ship 或 /land-and-deploy
- 8. 迭代回顾 → /retro
-```
-
-### 步骤详解
-
-**1. 探索与提案**：现有项目先探索（`/opsx:explore`）再写 proposal（`/opsx:propose`）；新项目（greenfield）直接生成 proposal + scenarios（记录到 `specs/` 和 `changes/`）。方向不明确时可用 `/office-hours` 做创意验证。
-
-**2. 产品与架构评审**（按需触发）：
-- `/plan-ceo-review`：产品战略影响、竞争格局变化时
-- `/plan-eng-review`：架构影响（新增服务、API 契约变更、数据模型重构）时
-
-**3. 设计审查**：在实现前进行设计评审，确保方案合理。评审通过后开始实现。
-- `/plan-design-review`：UI/UX 方案审查，评分各设计维度，确保用户体验达标
-
-**4. 实现**：执行 `/opsx:apply` 进行实现。
-
-**4.1 变更边界检查**：
-- 实施前：对照 `changes/<name>/proposal.md` 确认范围
-- 实施中：禁止修改其他 `changes/<name2>/` 目录下的文件
-- 完成后：逐条对照 proposal.md 确认 scope 内的已交付，scope 外的未改动
-
-**4.2 任务类型区分**：
-- **构建任务**：创建文件/代码 → 对应语言 lint + typecheck 通过后可标记
-- **验证任务**：需实际运行 → 必须验证后才能标记
-- **依赖任务**：等前置完成 → 不提前标记
-
-**4.3 依赖链检查**：标记依赖任务前，检查前置任务状态
-
-**4.4 自动化 Gate**：对应语言 lint + typecheck 自动执行，任一失败则停止
+**安全规范**：密钥与 `.env` 文件不入版本控制。示例代码用占位符（如 `YOUR_API_KEY`）不用真实凭据。调试日志不打印凭据/密钥/token。
 
-**4.5 Verify 强制化**：必须 verify 通过后才能标记完成，禁止跳过
+## 5. 完整生产工作流
 
-**5. E2E 测试**：`/opsx:e2e <change-name>` 生成 Playwright 测试 → `/browse` 探索真实 DOM → Healer 自动修复 → `/qa` 真实浏览器验证。E2E 通过后，由用户决定发布时机。
+按需叠加的评审：`/plan-ceo-review`（产品战略）/ `/plan-eng-review`（架构）/ `/plan-design-review`（UX）。
 
-> 注：Healer 需要 Playwright 环境；非 Node.js 项目请参考各自语言的 OpenSpec 测试集成。
+阶段命令即触发器：`/opsx:propose` → `/opsx:apply` → `/opsx:verify` → `/opsx:e2e` → `/opsx:archive`。**所有阶段由用户手动触发，AI 不自动进入下一阶段**（详见 §2 阶段隔离）。
 
-**6. 发布**：由用户手动触发 `/ship`、`/land-and-deploy` 或 `/canary`。内部项目可能直接部署，无需走 PR 机制。
+可用 `npx openspec --help` 查看更多 OpenSpec 命令。
 
-**7. 迭代回顾**：`/retro`
+方向不明时可用 `/office-hours` 做创意验证。**Healer 需要 Playwright 环境**；非 Node.js 项目请参考各自语言的 OpenSpec 测试集成。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openspec-playwright",
-  "version": "0.3.27",
+  "version": "0.3.30",
   "description": "OpenSpec + Playwright E2E verification setup tool for Claude Code",
   "type": "module",
   "bin": {

package/.claude/commands/CLAUDE.md

@@ -1,12 +0,0 @@
-<claude-mem-context>
-# Recent Activity
-
-<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
-
-### Mar 27, 2026
-
-| ID    | Time     | T   | Title                                                      | Read |
-| ----- | -------- | --- | ---------------------------------------------------------- | ---- |
-| #5419 | 10:01 AM | 🟣  | Added Claude Code command opsx-e2e.md for E2E verification | ~213 |
-
-</claude-mem-context>

package/.claude/commands/opsx/CLAUDE.md

@@ -1,12 +0,0 @@
-<claude-mem-context>
-# Recent Activity
-
-<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
-
-### Mar 27, 2026
-
-| ID    | Time     | T   | Title                                                 | Read |
-| ----- | -------- | --- | ----------------------------------------------------- | ---- |
-| #5434 | 10:15 AM | 🔄  | Organized OpenSpec command files under opsx namespace | ~145 |
-
-</claude-mem-context>

package/.claude/skills/CLAUDE.md

@@ -1,12 +0,0 @@
-<claude-mem-context>
-# Recent Activity
-
-<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
-
-### Mar 27, 2026
-
-| ID    | Time    | T   | Title                                              | Read |
-| ----- | ------- | --- | -------------------------------------------------- | ---- |
-| #5372 | 9:44 AM | ✅  | Created skill directory structure for openspec-e2e | ~124 |
-
-</claude-mem-context>