claude-coder 1.9.0 → 1.9.2

package/recipes/_shared/test/report-format.md

@@ -1,86 +1,86 @@
-# 测试报告输出规范
-
-测试任务完成后，必须输出两个报告文件。
-
-## 1. 结构化数据：.claude-coder/test-report.json
-
-```json
-{
-  "project": "项目名",
-  "timestamp": "ISO-8601 时间戳",
-  "summary": {
-    "total": 10,
-    "passed": 8,
-    "failed": 2,
-    "skipped": 0
-  },
-  "duration_ms": 45000,
-  "cases": [
-    {
-      "id": "TC-001",
-      "name": "列表加载",
-      "priority": "P0",
-      "status": "passed",
-      "duration_ms": 2300,
-      "steps": [
-        { "description": "导航到列表页", "status": "passed" },
-        { "description": "验证表格存在", "status": "passed" }
-      ],
-      "error": null
-    },
-    {
-      "id": "TC-002",
-      "name": "新建功能",
-      "priority": "P0",
-      "status": "failed",
-      "duration_ms": 5200,
-      "steps": [
-        { "description": "点击新建按钮", "status": "passed" },
-        { "description": "填写表单", "status": "passed" },
-        { "description": "提交", "status": "failed" }
-      ],
-      "error": "表单校验未触发，直接提交成功"
-    }
-  ],
-  "environment": {
-    "browser": "chromium",
-    "baseUrl": "http://localhost:xxxx"
-  }
-}
-```
-
-## 2. 可读报告：.claude-coder/test-report.md
-
-格式模板：
-
-```markdown
-# 测试报告 — {项目名}
-
-> 时间: {timestamp} | 通过率: {passed}/{total} | 耗时: {duration}s
-
-## 摘要
-
-| 指标 | 数值 |
-|------|------|
-| 总用例 | {total} |
-| 通过 | {passed} |
-| 失败 | {failed} |
-| 跳过 | {skipped} |
-
-## 详细结果
-
-### ✅ [P0] 列表加载 — PASSED (2.3s)
-1. 导航到列表页 ✓
-2. 验证表格存在 ✓
-
-### ❌ [P0] 新建功能 — FAILED (5.2s)
-1. 点击新建按钮 ✓
-2. 填写表单 ✓
-3. 提交 ✗ — 表单校验未触发
-
-## 失败用例汇总
-
-| 用例 | 优先级 | 失败原因 |
-|------|--------|----------|
-| 新建功能 | P0 | 表单校验未触发 |
-```
+# 测试报告输出规范
+
+测试任务完成后，必须输出两个报告文件。
+
+## 1. 结构化数据：.claude-coder/test-report.json
+
+```json
+{
+  "project": "项目名",
+  "timestamp": "ISO-8601 时间戳",
+  "summary": {
+    "total": 10,
+    "passed": 8,
+    "failed": 2,
+    "skipped": 0
+  },
+  "duration_ms": 45000,
+  "cases": [
+    {
+      "id": "TC-001",
+      "name": "列表加载",
+      "priority": "P0",
+      "status": "passed",
+      "duration_ms": 2300,
+      "steps": [
+        { "description": "导航到列表页", "status": "passed" },
+        { "description": "验证表格存在", "status": "passed" }
+      ],
+      "error": null
+    },
+    {
+      "id": "TC-002",
+      "name": "新建功能",
+      "priority": "P0",
+      "status": "failed",
+      "duration_ms": 5200,
+      "steps": [
+        { "description": "点击新建按钮", "status": "passed" },
+        { "description": "填写表单", "status": "passed" },
+        { "description": "提交", "status": "failed" }
+      ],
+      "error": "表单校验未触发，直接提交成功"
+    }
+  ],
+  "environment": {
+    "browser": "chromium",
+    "baseUrl": "http://localhost:xxxx"
+  }
+}
+```
+
+## 2. 可读报告：.claude-coder/test-report.md
+
+格式模板：
+
+```markdown
+# 测试报告 — {项目名}
+
+> 时间: {timestamp} | 通过率: {passed}/{total} | 耗时: {duration}s
+
+## 摘要
+
+| 指标 | 数值 |
+|------|------|
+| 总用例 | {total} |
+| 通过 | {passed} |
+| 失败 | {failed} |
+| 跳过 | {skipped} |
+
+## 详细结果
+
+### ✅ [P0] 列表加载 — PASSED (2.3s)
+1. 导航到列表页 ✓
+2. 验证表格存在 ✓
+
+### ❌ [P0] 新建功能 — FAILED (5.2s)
+1. 点击新建按钮 ✓
+2. 填写表单 ✓
+3. 提交 ✗ — 表单校验未触发
+
+## 失败用例汇总
+
+| 用例 | 优先级 | 失败原因 |
+|------|--------|----------|
+| 新建功能 | P0 | 表单校验未触发 |
+```

package/recipes/backend/base.md

@@ -1,27 +1,27 @@
-# 后端服务 — 基础食谱
-
-## 任务分解模式
-
-后端服务按以下标准拆分：
-
-1. **infra**: 项目结构（如未有后端框架，需初始化）
-   - steps：框架搭建、目录结构、数据库连接、中间件配置
-   - 验证：服务启动成功，健康检查接口返回 200
-
-2. **backend**: 数据模型 + API 接口
-   - steps：Model 定义、CRUD Service、Controller/Router、参数校验
-   - 验证：curl 测试所有接口返回正确响应
-
-3. **backend**: 业务逻辑（复杂场景单独拆分）
-   - steps：业务规则、数据转换、关联查询
-   - 验证：curl 测试边界场景
-
-4. **test**: API 测试
-   - steps：正向流程、参数校验、权限校验、边界测试
-
-## 通用规则
-
-- 一个资源（如 users）的完整 CRUD 合为一个 backend 任务
-- 认证鉴权如果与 CRUD 无关，拆为独立任务
-- 每个接口必须有参数校验
-- 错误响应格式统一
+# 后端服务 — 基础食谱
+
+## 任务分解模式
+
+后端服务按以下标准拆分：
+
+1. **infra**: 项目结构（如未有后端框架，需初始化）
+   - steps：框架搭建、目录结构、数据库连接、中间件配置
+   - 验证：服务启动成功，健康检查接口返回 200
+
+2. **backend**: 数据模型 + API 接口
+   - steps：Model 定义、CRUD Service、Controller/Router、参数校验
+   - 验证：curl 测试所有接口返回正确响应
+
+3. **backend**: 业务逻辑（复杂场景单独拆分）
+   - steps：业务规则、数据转换、关联查询
+   - 验证：curl 测试边界场景
+
+4. **test**: API 测试
+   - steps：正向流程、参数校验、权限校验、边界测试
+
+## 通用规则
+
+- 一个资源（如 users）的完整 CRUD 合为一个 backend 任务
+- 认证鉴权如果与 CRUD 无关，拆为独立任务
+- 每个接口必须有参数校验
+- 错误响应格式统一

package/recipes/backend/components/auth.md

@@ -1,18 +1,18 @@
-# 认证鉴权
-
-## 任务分解指导
-认证鉴权拆为独立 backend 任务，不与 CRUD 混合。
-
-## 实现要点
-- 注册：用户名/邮箱 + 密码，密码 hash 存储
-- 登录：验证凭证，返回 JWT token 或设置 session
-- Token 验证中间件：拦截受保护路由
-- 角色权限：admin / editor / viewer 等，按路由或按操作控制
-- Token 刷新/续期机制
-
-## 验证策略
-- curl 注册 → 201
-- curl 登录 → 200 + token
-- curl 无 token 访问受保护路由 → 401
-- curl 带 token 访问 → 200
-- curl 权限不足 → 403
+# 认证鉴权
+
+## 任务分解指导
+认证鉴权拆为独立 backend 任务，不与 CRUD 混合。
+
+## 实现要点
+- 注册：用户名/邮箱 + 密码，密码 hash 存储
+- 登录：验证凭证，返回 JWT token 或设置 session
+- Token 验证中间件：拦截受保护路由
+- 角色权限：admin / editor / viewer 等，按路由或按操作控制
+- Token 刷新/续期机制
+
+## 验证策略
+- curl 注册 → 201
+- curl 登录 → 200 + token
+- curl 无 token 访问受保护路由 → 401
+- curl 带 token 访问 → 200
+- curl 权限不足 → 403

package/recipes/backend/components/crud-api.md

@@ -1,18 +1,18 @@
-# RESTful CRUD API
-
-## 任务分解指导
-一个资源的完整 CRUD 合为一个 backend 任务。
-
-## 实现要点
-- RESTful 风格：GET /资源（列表）、GET /资源/:id（详情）、POST（创建）、PUT（更新）、DELETE（删除）
-- 列表分页：`?page=1&pageSize=10`，返回 `{ data: [], total: N }`
-- 搜索过滤：`?keyword=xxx&status=active`
-- 排序：`?sortBy=createdAt&order=desc`
-- 参数校验：必填项、类型、长度、格式
-- 错误响应统一格式：`{ code: 400, message: "xxx" }`
-
-## 验证策略
-- curl POST 创建 → 201 + 返回创建的数据
-- curl GET 列表 → 200 + 分页结构正确
-- curl PUT 更新 → 200 + 数据变更
-- curl DELETE → 200 + 再 GET 确认已删除
+# RESTful CRUD API
+
+## 任务分解指导
+一个资源的完整 CRUD 合为一个 backend 任务。
+
+## 实现要点
+- RESTful 风格：GET /资源（列表）、GET /资源/:id（详情）、POST（创建）、PUT（更新）、DELETE（删除）
+- 列表分页：`?page=1&pageSize=10`，返回 `{ data: [], total: N }`
+- 搜索过滤：`?keyword=xxx&status=active`
+- 排序：`?sortBy=createdAt&order=desc`
+- 参数校验：必填项、类型、长度、格式
+- 错误响应统一格式：`{ code: 400, message: "xxx" }`
+
+## 验证策略
+- curl POST 创建 → 201 + 返回创建的数据
+- curl GET 列表 → 200 + 分页结构正确
+- curl PUT 更新 → 200 + 数据变更
+- curl DELETE → 200 + 再 GET 确认已删除

package/recipes/backend/components/file-service.md

@@ -1,15 +1,15 @@
-# 文件服务
-
-## 任务分解指导
-文件服务如逻辑简单可合入 CRUD 任务，复杂时独立拆分。
-
-## 实现要点
-- 上传接口：multipart/form-data，校验类型和大小
-- 存储：本地文件系统 / 对象存储（S3/OSS）
-- 下载/访问：静态文件服务或签名 URL
-- 文件元信息：原始名、大小、MIME 类型、上传时间
-
-## 验证策略
-- curl 上传文件 → 200 + 返回 fileId/URL
-- curl 访问上传的文件 → 200 + 内容正确
-- curl 上传超限文件 → 400 + 错误提示
+# 文件服务
+
+## 任务分解指导
+文件服务如逻辑简单可合入 CRUD 任务，复杂时独立拆分。
+
+## 实现要点
+- 上传接口：multipart/form-data，校验类型和大小
+- 存储：本地文件系统 / 对象存储（S3/OSS）
+- 下载/访问：静态文件服务或签名 URL
+- 文件元信息：原始名、大小、MIME 类型、上传时间
+
+## 验证策略
+- curl 上传文件 → 200 + 返回 fileId/URL
+- curl 访问上传的文件 → 200 + 内容正确
+- curl 上传超限文件 → 400 + 错误提示

package/recipes/backend/manifest.json

@@ -1,20 +1,20 @@
-{
-  "id": "backend",
-  "name": "后端服务",
-  "description": "后端 API 服务开发（RESTful CRUD、认证鉴权、文件服务等）",
-  "base": "base.md",
-  "components": [
-    { "id": "crud-api",     "label": "CRUD API",  "description": "RESTful 增删改查接口 + 分页 + 过滤", "file": "components/crud-api.md",     "default": true },
-    { "id": "auth",         "label": "认证鉴权",  "description": "登录注册、JWT/Session、角色权限",   "file": "components/auth.md",         "default": false },
-    { "id": "file-service", "label": "文件服务",  "description": "文件上传下载、存储、类型校验",      "file": "components/file-service.md", "default": false }
-  ],
-  "test": {
-    "file": "test/api-test.md",
-    "defaultEnabled": true
-  },
-  "defaults": {
-    "components": ["crud-api"],
-    "role": "developer",
-    "test": true
-  }
-}
+{
+  "id": "backend",
+  "name": "后端服务",
+  "description": "后端 API 服务开发（RESTful CRUD、认证鉴权、文件服务等）",
+  "base": "base.md",
+  "components": [
+    { "id": "crud-api",     "label": "CRUD API",  "description": "RESTful 增删改查接口 + 分页 + 过滤", "file": "components/crud-api.md",     "default": true },
+    { "id": "auth",         "label": "认证鉴权",  "description": "登录注册、JWT/Session、角色权限",   "file": "components/auth.md",         "default": false },
+    { "id": "file-service", "label": "文件服务",  "description": "文件上传下载、存储、类型校验",      "file": "components/file-service.md", "default": false }
+  ],
+  "test": {
+    "file": "test/api-test.md",
+    "defaultEnabled": true
+  },
+  "defaults": {
+    "components": ["crud-api"],
+    "role": "developer",
+    "test": true
+  }
+}

package/recipes/backend/test/api-test.md

@@ -1,25 +1,25 @@
-# API 测试步骤模板
-
-## 标准测试用例
-
-### 【P0】CRUD 正向流程
-1. POST 创建资源 → 验证 201 + 返回数据
-2. GET 列表 → 验证新数据在列表中
-3. GET 详情 → 验证数据正确
-4. PUT 更新 → 验证数据变更
-5. DELETE 删除 → 验证 GET 返回 404
-
-### 【P0】分页和搜索
-1. 创建多条数据
-2. GET 列表 ?page=1&pageSize=2 → 验证分页字段正确
-3. GET 列表 ?keyword=xxx → 验证过滤结果
-
-### 【P1】参数校验
-1. POST 缺少必填字段 → 验证 400
-2. POST 字段格式错误 → 验证 400
-3. PUT 不存在的 ID → 验证 404
-
-### 【P1】认证鉴权（如适用）
-1. 无 token 访问 → 验证 401
-2. 错误 token → 验证 401
-3. 权限不足 → 验证 403
+# API 测试步骤模板
+
+## 标准测试用例
+
+### 【P0】CRUD 正向流程
+1. POST 创建资源 → 验证 201 + 返回数据
+2. GET 列表 → 验证新数据在列表中
+3. GET 详情 → 验证数据正确
+4. PUT 更新 → 验证数据变更
+5. DELETE 删除 → 验证 GET 返回 404
+
+### 【P0】分页和搜索
+1. 创建多条数据
+2. GET 列表 ?page=1&pageSize=2 → 验证分页字段正确
+3. GET 列表 ?keyword=xxx → 验证过滤结果
+
+### 【P1】参数校验
+1. POST 缺少必填字段 → 验证 400
+2. POST 字段格式错误 → 验证 400
+3. PUT 不存在的 ID → 验证 404
+
+### 【P1】认证鉴权（如适用）
+1. 无 token 访问 → 验证 401
+2. 错误 token → 验证 401
+3. 权限不足 → 验证 403

package/recipes/console/base.md

@@ -1,37 +1,37 @@
-# Console 管理后台 — 基础食谱
-
-## 任务分解模式
-
-管理后台 CRUD 页面按以下标准拆分任务（1 session = 1 task）：
-
-1. **backend**: API 接口层（RESTful CRUD + 分页 + 搜索过滤）
-   - steps 包含：路由定义、Controller、Service、数据模型
-   - 验证：curl 请求返回正确状态码和分页结构
-
-2. **frontend**: 列表页面（表格 + 搜索栏 + 分页组件）
-   - steps 包含：页面组件、数据请求、状态管理
-   - 验证：Playwright snapshot 验证页面元素存在
-
-3. **frontend**: 弹窗/表单（新建 + 编辑弹窗 + 表单校验）
-   - steps 包含：弹窗组件、表单项、校验规则、提交逻辑
-   - 验证：Playwright 点击按钮 → snapshot 验证弹窗打开
-
-4. **fullstack**: 联调（前后端串通 + 错误处理 + loading 状态）
-   - steps 包含：接口联调、错误提示、空状态处理
-   - 验证：Playwright 完整 CRUD 流程
-
-5. **test**: E2E 测试（可选，参考 test/crud-e2e.md）
-
-## 通用规则
-
-- 搜索框 + 表格 + 分页合并为一个 frontend 任务（不要拆太碎）
-- 弹窗 + 表单作为独立 frontend 任务（UI 和逻辑较复杂）
-- 后端 API 作为独立 backend 任务
-- 前后端联调作为 fullstack 任务
-- 每个任务必须有可执行的验证步骤
-
-## 反面案例
-
-- "搜索框"、"表格"、"分页"各拆为独立任务 → 太碎，合并
-- "全部前端"合为一个任务 → 太大（弹窗应独立）
-- 忽略验证步骤 → 每个 task 的 steps 最后一步必须是验证命令
+# Console 管理后台 — 基础食谱
+
+## 任务分解模式
+
+管理后台 CRUD 页面按以下标准拆分任务（1 session = 1 task）：
+
+1. **backend**: API 接口层（RESTful CRUD + 分页 + 搜索过滤）
+   - steps 包含：路由定义、Controller、Service、数据模型
+   - 验证：curl 请求返回正确状态码和分页结构
+
+2. **frontend**: 列表页面（表格 + 搜索栏 + 分页组件）
+   - steps 包含：页面组件、数据请求、状态管理
+   - 验证：Playwright snapshot 验证页面元素存在
+
+3. **frontend**: 弹窗/表单（新建 + 编辑弹窗 + 表单校验）
+   - steps 包含：弹窗组件、表单项、校验规则、提交逻辑
+   - 验证：Playwright 点击按钮 → snapshot 验证弹窗打开
+
+4. **fullstack**: 联调（前后端串通 + 错误处理 + loading 状态）
+   - steps 包含：接口联调、错误提示、空状态处理
+   - 验证：Playwright 完整 CRUD 流程
+
+5. **test**: E2E 测试（可选，参考 test/crud-e2e.md）
+
+## 通用规则
+
+- 搜索框 + 表格 + 分页合并为一个 frontend 任务（不要拆太碎）
+- 弹窗 + 表单作为独立 frontend 任务（UI 和逻辑较复杂）
+- 后端 API 作为独立 backend 任务
+- 前后端联调作为 fullstack 任务
+- 每个任务必须有可执行的验证步骤
+
+## 反面案例
+
+- "搜索框"、"表格"、"分页"各拆为独立任务 → 太碎，合并
+- "全部前端"合为一个任务 → 太大（弹窗应独立）
+- 忽略验证步骤 → 每个 task 的 steps 最后一步必须是验证命令

package/recipes/console/components/modal-form.md

@@ -1,20 +1,20 @@
-# 弹窗 + 表单
-
-## 任务分解指导
-弹窗和表单作为独立的 frontend 任务。
-steps 中应包含：弹窗组件 → 表单项 → 校验规则 → 提交 → 关闭 → 列表刷新。
-
-## 实现要点
-- 新建弹窗：表单为空，提交调用 POST API
-- 编辑弹窗：表单回填已有数据，提交调用 PUT API
-- 共用同一个弹窗组件（通过 mode 区分新建/编辑）
-- 表单校验：必填项、格式校验（邮箱、手机号等）、长度限制
-- 提交 loading：防重复提交
-- 提交成功后：关闭弹窗 + 刷新列表 + 提示消息
-- 提交失败：显示错误信息，不关闭弹窗
-
-## 验证策略
-- 点击新建按钮 → snapshot 验证弹窗打开 + 表单元素存在
-- 不填必填项直接提交 → 验证校验提示出现
-- 正确填写并提交 → 验证弹窗关闭 + 列表数据更新
-- 点击编辑 → 验证弹窗打开 + 数据回填
+# 弹窗 + 表单
+
+## 任务分解指导
+弹窗和表单作为独立的 frontend 任务。
+steps 中应包含：弹窗组件 → 表单项 → 校验规则 → 提交 → 关闭 → 列表刷新。
+
+## 实现要点
+- 新建弹窗：表单为空，提交调用 POST API
+- 编辑弹窗：表单回填已有数据，提交调用 PUT API
+- 共用同一个弹窗组件（通过 mode 区分新建/编辑）
+- 表单校验：必填项、格式校验（邮箱、手机号等）、长度限制
+- 提交 loading：防重复提交
+- 提交成功后：关闭弹窗 + 刷新列表 + 提示消息
+- 提交失败：显示错误信息，不关闭弹窗
+
+## 验证策略
+- 点击新建按钮 → snapshot 验证弹窗打开 + 表单元素存在
+- 不填必填项直接提交 → 验证校验提示出现
+- 正确填写并提交 → 验证弹窗关闭 + 列表数据更新
+- 点击编辑 → 验证弹窗打开 + 数据回填

package/recipes/console/components/pagination.md

@@ -1,17 +1,17 @@
-# 分页组件
-
-## 任务分解指导
-分页与表格合并为一个 frontend 任务，不单独拆分。
-steps 中应包含：分页参数 → 分页 UI → 翻页请求 → 总数显示。
-
-## 实现要点
-- 分页模式：offset + limit（如 `?page=1&pageSize=10`）
-- 总数显示：从 API 响应中取 total 字段
-- 默认每页条数：10 条（可配置）
-- 页码变化触发重新请求
-- URL 同步：当前页码反映在 URL query 中（可选）
-
-## 验证策略
-- 验证分页组件渲染（页码、上一页/下一页按钮）
-- 点击第 2 页 → 验证数据变化
-- 验证总数显示正确
+# 分页组件
+
+## 任务分解指导
+分页与表格合并为一个 frontend 任务，不单独拆分。
+steps 中应包含：分页参数 → 分页 UI → 翻页请求 → 总数显示。
+
+## 实现要点
+- 分页模式：offset + limit（如 `?page=1&pageSize=10`）
+- 总数显示：从 API 响应中取 total 字段
+- 默认每页条数：10 条（可配置）
+- 页码变化触发重新请求
+- URL 同步：当前页码反映在 URL query 中（可选）
+
+## 验证策略
+- 验证分页组件渲染（页码、上一页/下一页按钮）
+- 点击第 2 页 → 验证数据变化
+- 验证总数显示正确

package/recipes/console/components/search.md

@@ -1,17 +1,17 @@
-# 搜索组件
-
-## 任务分解指导
-搜索功能通常与列表任务合并为一个 frontend 任务，不单独拆分。
-steps 中应包含：搜索框 UI → 防抖处理 → API 请求参数拼接 → 列表刷新。
-
-## 实现要点
-- 输入防抖 300ms，避免频繁请求
-- 搜索关键词作为 query 参数传给列表 API（如 `?keyword=xxx`）
-- 支持清空搜索恢复全量数据
-- 搜索时显示 loading 状态
-- 如有多个筛选条件，使用表单组合（日期范围、下拉选择、关键词等）
-
-## 验证策略
-- 输入已知关键词 → snapshot 验证列表数据过滤
-- 清空搜索 → 验证恢复全量
-- 快速连续输入 → 验证只发一次请求（防抖生效）
+# 搜索组件
+
+## 任务分解指导
+搜索功能通常与列表任务合并为一个 frontend 任务，不单独拆分。
+steps 中应包含：搜索框 UI → 防抖处理 → API 请求参数拼接 → 列表刷新。
+
+## 实现要点
+- 输入防抖 300ms，避免频繁请求
+- 搜索关键词作为 query 参数传给列表 API（如 `?keyword=xxx`）
+- 支持清空搜索恢复全量数据
+- 搜索时显示 loading 状态
+- 如有多个筛选条件，使用表单组合（日期范围、下拉选择、关键词等）
+
+## 验证策略
+- 输入已知关键词 → snapshot 验证列表数据过滤
+- 清空搜索 → 验证恢复全量
+- 快速连续输入 → 验证只发一次请求（防抖生效）

package/recipes/console/components/table-list.md

@@ -1,18 +1,18 @@
-# 数据表格
-
-## 任务分解指导
-表格是列表页的核心，与搜索和分页合并为一个 frontend 任务。
-steps 中应包含：列定义 → 数据请求 → 渲染 → 操作列按钮。
-
-## 实现要点
-- 列定义清晰：字段名、显示名、宽度、对齐方式、渲染方式
-- 操作列：编辑、删除按钮（按业务需求扩展）
-- 空状态：无数据时显示友好提示
-- Loading 状态：请求中显示骨架屏或 spinner
-- 如需行选择：checkbox 列 + 批量操作栏
-- 如需排序：列头排序图标 + API 排序参数
-
-## 验证策略
-- snapshot 验证表格元素存在（table/thead/tbody）
-- 验证至少有 1 行数据（或空状态文案）
-- 验证操作列按钮可点击
+# 数据表格
+
+## 任务分解指导
+表格是列表页的核心，与搜索和分页合并为一个 frontend 任务。
+steps 中应包含：列定义 → 数据请求 → 渲染 → 操作列按钮。
+
+## 实现要点
+- 列定义清晰：字段名、显示名、宽度、对齐方式、渲染方式
+- 操作列：编辑、删除按钮（按业务需求扩展）
+- 空状态：无数据时显示友好提示
+- Loading 状态：请求中显示骨架屏或 spinner
+- 如需行选择：checkbox 列 + 批量操作栏
+- 如需排序：列头排序图标 + API 排序参数
+
+## 验证策略
+- snapshot 验证表格元素存在（table/thead/tbody）
+- 验证至少有 1 行数据（或空状态文案）
+- 验证操作列按钮可点击