docs: 优化审查提示词,禁止 subagent 读取文件,明确 apply 阶段不动主规范
config.yaml: subagent 限定为计算密集/多步骤任务,文件读取用 Read 工具 prompt-proposal-review.md: 收集阶段加入读取约束和分步策略,复核补全待澄清清单 prompt-apply-review.md: 禁止同步主规范,新增 Spec 覆盖完整性扫描与补充流程
This commit is contained in:
29
openspec/specs/test-output-cleanliness/spec.md
Normal file
29
openspec/specs/test-output-cleanliness/spec.md
Normal file
@@ -0,0 +1,29 @@
|
||||
# Test Output Cleanliness
|
||||
|
||||
## Purpose
|
||||
|
||||
确保测试运行时输出干净、无噪音,便于开发者快速定位问题。
|
||||
|
||||
## Requirements
|
||||
|
||||
### Requirement: 测试不应产生无关 console 输出
|
||||
测试运行时,由测试用例预期的容错行为(如 JSON 解析失败、checker rejected)触发的 `console.warn` 输出 SHALL 在测试代码中被抑制,不污染测试报告。
|
||||
|
||||
#### Scenario: 容错测试抑制 console.warn
|
||||
- **WHEN** 测试用例故意注入损坏数据或触发异常以验证系统容错行为
|
||||
- **THEN** 测试 SHALL 在执行前临时覆盖 `console.warn` 为空函数,在 finally 块中恢复原始函数
|
||||
|
||||
#### Scenario: 非预期 console.warn 不被抑制
|
||||
- **WHEN** 测试用例并非专门测试容错行为
|
||||
- **THEN** 测试 SHALL NOT 抑制 `console.warn`,确保意外 warn 可被观测
|
||||
|
||||
### Requirement: 探针执行失败日志输出单行消息
|
||||
ProbeEngine 在捕获 checker rejected 时,`console.warn` SHALL 输出单行错误消息文本,MUST NOT 输出 Error 对象(会导致多行堆栈噪音)。
|
||||
|
||||
#### Scenario: checker rejected 输出单行日志
|
||||
- **WHEN** checker 执行抛出未捕获异常(Promise rejected)
|
||||
- **THEN** `console.warn` SHALL 输出格式为 `探针执行失败: <message>` 的单行文本,其中 message 使用 `formatReason()` 提取
|
||||
|
||||
#### Scenario: formatReason 复用
|
||||
- **WHEN** 构建失败日志消息和写入 CheckFailure
|
||||
- **THEN** 两者 SHALL 共用同一个 `formatReason` 函数提取错误消息
|
||||
@@ -20,7 +20,7 @@
|
||||
- **THEN** `assets/` 目录下的 JS 和 CSS 文件名 SHALL 包含 content hash(如 `index-a1b2c3.js`)
|
||||
|
||||
### Requirement: Code Splitting 策略
|
||||
系统 SHALL 配置 Vite 的 Rolldown code splitting,将 vendor 库分离为独立 chunks。
|
||||
系统 SHALL 配置 Vite 的 Rolldown code splitting,将 vendor 库分离为独立 chunks,并通过 `React.lazy()` 动态导入实现按需加载。
|
||||
|
||||
#### Scenario: React 相关库分离
|
||||
- **WHEN** Vite 构建完成
|
||||
@@ -34,8 +34,16 @@
|
||||
- **WHEN** Vite 构建完成
|
||||
- **THEN** `recharts` 和 `d3-*` 相关模块 SHALL 被打包到名为 `vendor-chart` 的独立 chunk
|
||||
|
||||
#### Scenario: TargetDetailDrawer 延迟加载
|
||||
- **WHEN** Vite 构建完成
|
||||
- **THEN** `TargetDetailDrawer` 及其依赖(recharts、D3、DateRangePicker 等)SHALL 通过 `React.lazy()` 动态导入,被 Rolldown 自动拆分为异步 chunk,不包含在初始加载的 JS 中
|
||||
|
||||
#### Scenario: Drawer 首次渲染无闪烁
|
||||
- **WHEN** 用户首次点击目标触发 Drawer 渲染
|
||||
- **THEN** Drawer SHALL 通过 `<Suspense fallback={null}>` 包裹,利用其默认 visible=false 状态避免加载期间的视觉闪烁
|
||||
|
||||
### Requirement: CSS 处理
|
||||
系统 SHALL 通过 Vite 处理 CSS 导入,产出独立的 CSS 文件。
|
||||
系统 SHALL 通过 Vite 处理 CSS 导入,产出独立的 CSS 文件。TDesign 组件样式 SHALL 保持全量导入方式。
|
||||
|
||||
#### Scenario: CSS 文件产出
|
||||
- **WHEN** Vite 构建完成
|
||||
@@ -44,3 +52,7 @@
|
||||
#### Scenario: CSS 压缩
|
||||
- **WHEN** Vite 执行生产构建
|
||||
- **THEN** 产出的 CSS 文件 SHALL 经过压缩处理
|
||||
|
||||
#### Scenario: TDesign CSS 全量导入
|
||||
- **WHEN** 前端入口文件初始化样式
|
||||
- **THEN** 系统 SHALL 通过 `tdesign-react/dist/reset.css` 和 `tdesign-react/dist/tdesign.min.css` 全量导入 TDesign 组件样式
|
||||
|
||||
Reference in New Issue
Block a user