1
0

docs: 优化审查提示词,禁止 subagent 读取文件,明确 apply 阶段不动主规范

config.yaml: subagent 限定为计算密集/多步骤任务,文件读取用 Read 工具
prompt-proposal-review.md: 收集阶段加入读取约束和分步策略,复核补全待澄清清单
prompt-apply-review.md: 禁止同步主规范,新增 Spec 覆盖完整性扫描与补充流程
This commit is contained in:
2026-05-20 17:08:12 +08:00
parent 60a54b483f
commit f3df3a203b
10 changed files with 161 additions and 71 deletions

View File

@@ -15,7 +15,7 @@ context: |
- 前端严禁组件内联style属性、CSS覆盖TD内部类名、使用!important、硬编码色值
- Git提交: 仅中文; 格式"类型: 简短描述", 类型: feat/fix/refactor/docs/style/test/chore; 多行描述空行后写详细说明
- 禁止创建git操作task
- 积极使用subagents精心设计并行任务,节省上下文空间,加速任务执行
- 使用subagents处理计算密集或多步骤的并行任务如代码实现、测试执行文件读取直接使用Read工具并行调用禁止用subagent转发文件内容
- 优先使用提问工具对用户进行提问
- (当前项目未上线,不需要考虑向前兼容)

View 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` 函数提取错误消息

View File

@@ -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 组件样式