claude-sdlc 1.4.2 → 1.4.4
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/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
#!/usr/bin/env bash
|
|
2
2
|
# check-phase-write.sh — PreToolUse hook for Write/Edit
|
|
3
|
-
# P3
|
|
3
|
+
# P3 前拦截代码文件写入，文档/配置文件任何阶段放行，P2 允许原型 HTML/CSS
|
|
4
4
|
set -euo pipefail
|
|
5
5
|
|
|
6
6
|
INPUT=$(cat)
|
|
@@ -33,11 +33,18 @@ fi
|
|
|
33
33
|
PHASE_NUM="${PHASE_NUM:-${SDLC_PHASE:+$(echo "$SDLC_PHASE" | sed 's/[^0-9]//g')}}"
|
|
34
34
|
[ -z "$PHASE_NUM" ] && exit 0
|
|
35
35
|
|
|
36
|
-
# P3+
|
|
36
|
+
# P3+ 放行所有代码文件
|
|
37
37
|
[ "$PHASE_NUM" -ge 3 ] && exit 0
|
|
38
38
|
|
|
39
|
+
# P2 放行原型文件（HTML/CSS）— 用于 Chrome 展示设计原型
|
|
40
|
+
if [ "$PHASE_NUM" -eq 2 ]; then
|
|
41
|
+
case "$EXT" in
|
|
42
|
+
html|css) exit 0 ;;
|
|
43
|
+
esac
|
|
44
|
+
fi
|
|
45
|
+
|
|
39
46
|
# 拦截 — JSON permissionDecision 格式
|
|
40
|
-
REASON="当前阶段 P${PHASE_NUM} 不允许修改代码文件（P3
|
|
47
|
+
REASON="当前阶段 P${PHASE_NUM} 不允许修改代码文件（P3 起可用，P2 仅允许原型 HTML/CSS）"
|
|
41
48
|
if command -v jq &>/dev/null; then
|
|
42
49
|
jq -n --arg r "$REASON" '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":$r}}'
|
|
43
50
|
else
|
|
@@ -40,28 +40,36 @@
|
|
|
40
40
|
**需用户确认** — 确认后自动审查推进到 P3 并启动自动驱动。
|
|
41
41
|
|
|
42
42
|
### 阶段活动
|
|
43
|
-
- **【必须首先执行】最新技术调研**：Context7 MCP 查询最新文档 + WebSearch 搜索最流行架构方案
|
|
43
|
+
- **【必须首先执行】最新技术调研**：Context7 MCP 查询最新文档 + WebSearch 搜索最流行架构方案
|
|
44
|
+
- **【涉及 UI 时必须执行】现代 UI 设计调研**：
|
|
45
|
+
1. WebSearch 搜索 `"{框架名} modern UI design {当前年份}"` `"best {框架名} UI component library {当前年份}"` `"UI design trends {当前年份}"`
|
|
46
|
+
2. 调研主流 UI 组件库（如 shadcn/ui、Radix、Ant Design 5、Material Design 3、Tailwind UI 等）的最新设计语言
|
|
47
|
+
3. 参考成功产品的 UI 设计模式（圆角、渐变、玻璃态、微动画、暗色模式等现代元素）
|
|
48
|
+
4. 确定配色方案、字体层级、间距系统、响应式断点
|
|
49
|
+
5. **禁止使用过时/简陋的 UI 风格**（如无样式 HTML、Bootstrap 3 默认主题、90 年代表格布局）
|
|
44
50
|
- 逐条对照 PRD 设计架构方案
|
|
45
51
|
- 确定技术选型（基于最新文档，非过时记忆）
|
|
46
|
-
- 原型设计（如涉及 UI
|
|
52
|
+
- 原型设计（如涉及 UI）：页面布局、组件结构、交互流程、视觉风格、动效方案
|
|
53
|
+
- **创建原型 HTML 文件并在 Chrome 中展示**（如涉及 UI）：写一个自包含的 HTML 文件（内联 CSS/JS），用 Chrome 打开让用户直观预览设计效果，根据反馈迭代
|
|
47
54
|
- 设计数据模型和接口，制定文件修改计划
|
|
48
55
|
- **为每条 PRD 需求标注对应的设计模块**
|
|
49
56
|
|
|
50
57
|
### 必需产出物
|
|
51
58
|
- 技术调研记录 + 架构设计方案（引用最新文档）
|
|
52
59
|
- PRD→设计映射表 + 文件修改清单
|
|
53
|
-
-
|
|
60
|
+
- **UI 原型文件 + Chrome 预览**（如涉及 UI）：自包含 HTML 原型 + 组件库选型 + 配色方案 + 布局结构 + 交互细节 + 参考来源链接
|
|
61
|
+
- 实现步骤分解
|
|
54
62
|
|
|
55
63
|
### 审查清单（`/review`）
|
|
56
64
|
- [ ] **最新文档已查阅**（Context7 + WebSearch）
|
|
57
65
|
- [ ] **PRD 全覆盖**（逐条对照）+ **无超出 PRD 的设计**
|
|
58
66
|
- [ ] 架构合理（符合社区最佳实践，无过度设计）
|
|
59
|
-
- [ ]
|
|
67
|
+
- [ ] **UI 现代化**（如涉及 UI）— 使用当前主流组件库/设计语言，有参考来源，无过时风格
|
|
60
68
|
- [ ] 接口清晰 + 错误处理已考虑 + 可测试
|
|
61
69
|
- [ ] 技术选型有据（引用最新文档）
|
|
62
70
|
|
|
63
71
|
### 允许工具
|
|
64
|
-
✅ Read, Glob, Grep, WebSearch, WebFetch, Context7 MCP, Chrome
|
|
72
|
+
✅ Read, Glob, Grep, WebSearch, WebFetch, Context7 MCP, Chrome, Write/Edit（仅原型 HTML/CSS） ❌ Bash
|
|
65
73
|
|
|
66
74
|
---
|
|
67
75
|
|
|
@@ -16,15 +16,32 @@ Chrome 工具需通过 `claude --chrome` 启动。仅在以下阶段允许使用
|
|
|
16
16
|
|
|
17
17
|
| 阶段 | Chrome | 用途 |
|
|
18
18
|
|------|--------|------|
|
|
19
|
-
| P2 | **允许** | UI/UX
|
|
19
|
+
| P2 | **允许** | UI/UX 调研、竞品分析、**原型预览** |
|
|
20
20
|
| P4 | **允许** | 视觉回归测试、E2E 交互验证、响应式测试 |
|
|
21
21
|
| 其他 | 禁止 | — |
|
|
22
22
|
|
|
23
23
|
## P2 使用规范
|
|
24
|
+
|
|
25
|
+
### UI 设计调研
|
|
24
26
|
- 访问竞品和 UI 组件库文档
|
|
25
27
|
- 截图保存设计参考
|
|
26
28
|
- 禁止登录私人账户、提交表单、下载文件
|
|
27
29
|
|
|
30
|
+
### 原型展示（核心流程）
|
|
31
|
+
涉及 UI 的任务必须在 P2 创建原型并在 Chrome 中展示给用户确认：
|
|
32
|
+
|
|
33
|
+
1. **创建原型 HTML** — 写一个自包含的 HTML 文件（内联 CSS + JS），展示页面布局、配色、组件样式、交互效果
|
|
34
|
+
2. **Chrome 打开预览** — 用 Chrome 打开本地 HTML 文件，让用户直观看到设计效果
|
|
35
|
+
3. **截图记录** — 截取关键页面截图作为设计参考
|
|
36
|
+
4. **迭代优化** — 根据用户反馈修改原型，再次预览，直到用户满意
|
|
37
|
+
5. **确认后进入 P3** — 用户确认原型设计后，P3 编码以此原型为视觉基准
|
|
38
|
+
|
|
39
|
+
### 原型文件规范
|
|
40
|
+
- 文件路径：项目根目录或 `.claude/prototype/` 下
|
|
41
|
+
- 格式：单个 HTML 文件，内联所有 CSS/JS（自包含，无外部依赖）
|
|
42
|
+
- 可引用 CDN 上的组件库（如 Tailwind CSS CDN、DaisyUI CDN 等）
|
|
43
|
+
- 原型仅用于设计确认，P3 编码时用正式的组件库和构建工具重写
|
|
44
|
+
|
|
28
45
|
## P4 使用规范
|
|
29
46
|
- 打开本地开发服务器验证 UI
|
|
30
47
|
- 截图对比渲染结果
|
|
@@ -83,11 +83,11 @@ Review 是每个阶段的退出门禁。每个阶段必须检查 PRD 符合性
|
|
|
83
83
|
- [ ] **最新文档已查阅**（Context7 + WebSearch）
|
|
84
84
|
- [ ] **PRD 全覆盖** + **无超出 PRD 的设计**
|
|
85
85
|
- [ ] 架构合理（符合最佳实践，无过度设计）+ 与现有架构一致
|
|
86
|
-
- [ ]
|
|
86
|
+
- [ ] **UI 现代化**（如涉及 UI）— 已搜索当年 UI 设计趋势 + 使用主流组件库/设计语言 + 有参考来源链接 + 无过时/简陋风格
|
|
87
87
|
- [ ] 接口清晰 + 错误处理已考虑 + 可测试
|
|
88
88
|
- [ ] 技术选型有据（引用最新文档）
|
|
89
89
|
|
|
90
|
-
输出格式参照 P1
|
|
90
|
+
输出格式参照 P1 模板，增加技术调研、**UI 设计调研（组件库选型+配色+布局+参考来源）**、PRD→设计映射等审查项。
|
|
91
91
|
|
|
92
92
|
---
|
|
93
93
|
|