chore: snapshot in-progress question-gen work before preflight fixes

This commit is contained in:
2026-07-16 04:12:21 -04:00
parent 11a5545f57
commit a4c429b247
39 changed files with 738 additions and 283 deletions
+17 -3
View File
@@ -96,9 +96,10 @@ MODE=mock N_SAMPLES=10 bash scripts/<experiment>.sh # smoke test
### Phase 1: 规划与设计 (Planning)
1. **需求探索**: 涉及创建新功能、新组件、修改行为时,**必须**先调用 `brainstorming` skill 进行需求探索与设计。无论用户的指令多么具体、改动多么简单,都不得跳过此步骤(除非用户显式说"跳过 brainstorming")。
2. **查阅规格 & 讨论**: 仔细阅读 `research-wiki/`(单一事实源)下对应的文档,了解项目最新情况。对于不理解的地方请与人类进行多轮讨论,确保理解人类的设计意图。
3. **日志方案设计**: 功能会产生运行时数据时,**必须**调用 `structured-logging` skill 设计日志方案
4. **撰写计划**: 正式编码前**必须**调用 `writing-plans` skill 撰写实现计划
5. **审核门控(差异化)**:
3. **前序版本对照(重写/重构时强制)**: 当任务涉及重写或重构已有模块时,**必须**列出前序版本的所有行为(包括持久化策略、崩溃恢复、幂等性、断点续跑等非功能性行为),逐一确认新版本是保留、替代、还是删除。未经确认的隐式删除 = bug
4. **日志方案设计**: 功能会产生运行时数据时**必须**调用 `structured-logging` skill 设计日志方案
5. **撰写计划**: 正式编码前,**必须**调用 `writing-plans` skill 撰写实现计划。
6. **审核门控(差异化)**:
- **designClaude 自审 → Codex 审 → 人类审**(保留人类门,批准后方可进入计划阶段)。
- **planClaude 自审 → Codex 审 → 直接执行**(无 plan 人类门);plan 经 Claude 自审 + Codex 审通过后直接进入 Phase 2 执行。
@@ -159,6 +160,19 @@ MODE=mock N_SAMPLES=10 bash scripts/<experiment>.sh # smoke test
- **功能修改**:
- **必须** 不考虑向后兼容,直接修改原文件。代码简洁性优先。
### 4.2.1 设计文档非功能性需求覆盖(强制)
> **教训来源**: v2 出题管线重写时未继承 v1 的逐题追加持久化策略,导致多次 run 的题目丢失。
设计文档**必须**显式覆盖以下非功能性维度(即使答案是"不适用"也要写明):
| 维度 | 必答问题 |
|------|---------|
| **持久化策略** | 数据何时落盘?崩溃时最多丢多少?是覆盖写还是追加? |
| **幂等性** | 同一操作重复执行是否安全?结果是否一致? |
| **断点续跑** | 中断后重启能否从断点恢复?进度如何持久化? |
| **原子性** | 写操作是否原子?部分写入是否会损坏数据? |
### 4.3 Git 工作流规范
- **Feature Branch**: 所有开发工作在 feature 分支上进行,**严禁**直接在 main/master 上修改。
- **增量提交**: 频繁提交,每个提交有明确的语义。