openspec-playwright 0.3.1 → 0.3.2

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.
@@ -1,7 +1,6 @@
1
- # Claude Code Employee-Grade Configuration + gstack + openspec-playwright 生产闭环
1
+ # Claude Code Employee-Grade Standards
2
2
 
3
- > 员工级行为规范,适用于 OpenSpec 项目。
4
- > 严格遵循 OpenSpec 规范驱动开发 + gstack 角色化虚拟工程团队 + Playwright 自动 E2E 验证。
3
+ > 员工级行为规范。
5
4
 
6
5
  ---
7
6
 
@@ -13,13 +12,11 @@ E2E 工作流前提(由用户确保,非 AI 操作):
13
12
  - gstack:`git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup`(提供 `/browse` 探索 + `/qa` 浏览器验证)
14
13
  - OpenSpec CLI:`npm install -g @fission-ai/openspec && openspec init`(提供变更管理能力)
15
14
  - openspec-playwright:`openspec-pw init`(提供 `/opsx:e2e` 命令)
16
- - Playwright MCP:`claude mcp add playwright npx @playwright/mcp@latest`(用于测试执行 + Healer)
17
- - 浏览器已安装:`npx playwright install --with-deps`
18
15
  - 项目包含 `specs/`、`changes/`、`tests/playwright/` 目录
19
16
 
20
17
  ## 1. 浏览器操作约束
21
18
 
22
- 所有浏览器操作用 gstack 的 `/browse` 探索 + `/qa` 验证,Playwright MCP 执行测试。Claude Code 会根据上下文自动调度,无需手动路由。
19
+ 所有浏览器操作用 gstack 的 `/browse` 探索 + `/qa` 验证。
23
20
 
24
21
  **冲突解决**:gstack 任何想直接修改代码的行为,都必须先确认当前 OpenSpec proposal 是否已存在并通过(检查 `changes/<name>/proposal.md` 是否处于 `approved` 状态)。
25
22
 
@@ -28,8 +25,6 @@ E2E 工作流前提(由用户确保,非 AI 操作):
28
25
 
29
26
  **拒绝"够用就行"**。架构缺陷、状态重复、模式不一致——必须说出来并修复。
30
27
 
31
- **安全防护**:写 Go 时关注内存安全,写 Python 时关注反序列化,写 Web/API 时参考 OWASP Top 10 / OWASP API Top 10。先了解所用场景的风险模型。
32
-
33
28
  ## 3. 上下文管理
34
29
  **文件读取完整**:超过 500 行的文件,不要假设单次读取覆盖完整内容——根据需要分次读取或编辑前重新读取完整文件。超过 10 条消息后,编辑任何文件前强制重新读取。
35
30
 
@@ -38,16 +33,12 @@ E2E 工作流前提(由用户确保,非 AI 操作):
38
33
  **重构前清死代码**:未使用的 import/export/prop/console.log 先删掉,单独提交,再做重构。
39
34
 
40
35
  ## 4. 大规模任务处理
41
- **子 Agent 并行化**:任务涉及超过 5 个独立文件时,启动并行子 agent(每个 5-8 个文件),每个拥有独立 token budget。
42
-
43
- **分阶段执行**:每个阶段不超过 5 个文件,完成后验证,等待用户批准再继续。
44
-
45
36
  **200 行以上修改必须走 OpenSpec**:代码改动超过 200 行时,禁止直接修改,必须通过 OpenSpec 工作流(/opsx:propose)。
46
37
 
47
38
  ## 5. 工具限制与编辑安全
48
39
  **搜索要全**:重命名时,用 Grep 覆盖调用、类型、字符串、`import`、barrel file、测试 mock,不得假设一次覆盖所有情况。
49
40
 
50
- **编辑要求**:编辑后重新读取文件确认变更正确应用。同一文件连续编辑不超过 3 次,中间必须重新读取。变更完成后,明确告知用户可能遗漏的区域(动态引用、测试 mock 等),提示人工复查。
41
+ **编辑要求**:编辑后重新读取文件确认变更正确应用。变更完成后,明确告知用户可能遗漏的区域(动态引用、测试 mock 等),提示人工复查。
51
42
 
52
43
  **不主动推送**:除非用户明确要求,否则不推送代码。
53
44
 
@@ -55,14 +46,14 @@ E2E 工作流前提(由用户确保,非 AI 操作):
55
46
 
56
47
  ---
57
48
 
58
- ## 6. 完整生产工作流(严格执行 + 反馈循环)
49
+ ## 6. 完整生产工作流
59
50
 
60
51
  ```
61
52
  1. 探索与提案
62
53
  2. 产品与架构评审(按需触发)
63
54
  3. 设计审查
64
55
  4. 实现 → /opsx:apply
65
- 5. 自审 → /opsx:verify /design-review /review
56
+ 5. 自审 → /opsx:verify
66
57
  6. E2E 测试 → /opsx:e2e <change-name> → /browse 探索 + /qa 验证
67
58
  7. 验证通过后归档 → /opsx:archive
68
59
  8. 发布 → /ship 或 /land-and-deploy
@@ -82,30 +73,12 @@ E2E 工作流前提(由用户确保,非 AI 操作):
82
73
 
83
74
  **4. 实现**:执行 `/opsx:apply` 进行实现 → `lint + typecheck` 通过才算成功。
84
75
 
85
- **5. 自审**:`/opsx:verify` `/design-review` `/review` 自审实现代码,确保质量。**设计审查后**,对 HTML/CSS 文件执行 CSS 结构审计(防止 `/design-review` 靠截图漏检间距问题):
86
-
87
- ```
88
- 两步式审计:
89
- 1. 确定间距基准 — 查 CSS variables / Tailwind spacing / Bootstrap $spacer
90
- grep 'gap:|padding:|margin:' *.html → 提取值 → 对比基准,列低于基准的项
91
- 2. 检查 margin hack — 同一 grid/flex 容器中相邻元素各自用 margin 硬撑间距
92
- 信号:两个子元素的 margin 和 > 基准间距 2 倍 → 应改为 grid 行或 gap 控制
93
- 例:.desc{margin-b:36}+.btn{margin-t:80} 在同一 row → grid 行分离
94
- ```
76
+ **5. 自审**:`/opsx:verify` 自审实现代码,确保质量。
95
77
 
96
- **6. E2E 测试生成与执行**:`/opsx:e2e <change-name>` 生成 Playwright 测试 → `/browse` 探索真实 DOM → Healer 自动修复 → `/qa` 真实浏览器验证。E2E 通过后进入发布环节。
78
+ **6. E2E 测试**:`/opsx:e2e <change-name>` 生成 Playwright 测试 → `/browse` 探索真实 DOM → Healer 自动修复 → `/qa` 真实浏览器验证。E2E 通过后进入发布环节。
97
79
 
98
80
  **7. 验证通过后归档**:`/opsx:archive` 永久归档,更新 `specs/`
99
81
 
100
82
  **8. 发布**:`/ship` 或 `/land-and-deploy`
101
83
 
102
84
  **9. 迭代回顾**:`/retro`
103
-
104
- ### 反馈循环(生产中必然发生)
105
-
106
- | 信号 | 回到 |
107
- |------|------|
108
- | 测试失败(App Bug) | 回到步骤 4 修复 → 重新测试 |
109
- | 发现架构问题 | 回到步骤 2 重新评审 → 步骤 4 修复 |
110
- | Proposal 需调整 | 回到步骤 1 重新提案 |
111
- | 评审不通过 | 回到对应步骤重新处理 |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "openspec-playwright",
3
- "version": "0.3.1",
3
+ "version": "0.3.2",
4
4
  "description": "OpenSpec + Playwright E2E verification setup tool for Claude Code",
5
5
  "type": "module",
6
6
  "bin": {