plan(phase5): 锁定 Writer/QA 设计评审修正与实施计划基线

- spec 据 4 项评审决策落地 14 处修正 + GSTACK REVIEW REPORT
- 实施计划 16 任务 / 3 里程碑(M1 基础件 / M2 垂直切片 / M3 闭环硬化)
- _AI_USAGE_LOG.md 登记评审与计划
This commit is contained in:
lhl
2026-08-13 09:06:11 +08:00
parent dbf8c12881
commit c7e7c95a19
3 changed files with 1550 additions and 18 deletions
+2
View File
@@ -85,3 +85,5 @@
| 2026-08-11 | Agent 实现 | T10(架构审查整改,P3):Writer 串行约束写回文档(I14)。纯文档任务:design.md §6.8 后新增 §6.8.1 串行生成约束(理由:章间引用依赖前章 WriterState、并行收益低复杂度高、Token 友好;落地点:编排层 POST /generate 严格按模板顺序串行、UI 展示预估总时长与逐章进度、禁止并发多章);api-design §4.3 补串行消费说明(对应 design §6.8.1);web-ui-design 进度 UI 补串行语义(预计=章数×单章 3-5 分)与禁止并发说明。无代码/测试变更,全量 248 passed 覆盖 100.00% 不回归 | docs/design.md, docs/api-design.md, docs/web-ui-design.md, _AI_USAGE_LOG.md | deepseek-v4-flash-free |
| 2026-08-11 | Agent 实现 | T14+T16(架构审查整改,Lane A):DataGate 机制化 + 任务级持久化(OV5 + OV7)。新建 src/genesis/orchestrator/ 包:datagate.pyDataGate.load(source, selector):子集加载 + 规模保护 max_total_rows=500 无 selector 拒绝全量 + token 预算 max_total_tokens=8000 复用 CJK 保守估算 + 未知表容错)+ task_queue.pyTaskQueue ABC + PersistentTaskQueue SQLite 落盘:enqueue/poll/update_status/get/cancel/recover/close + 幂等去重 §5.3 + recover 将 running→failed、pending 保留);新建 tests/test_datagate.py8 用例:子集/规模保护/1000 行 Excel selector 放行/token 预算/未知表/空 selector+ tests/test_task_queue.py11 用例:CRUD/幂等缓存/重开不丢/recover 语义/防御分支);同步 agent-runtime-design.md(§4.2 原则→机制 + §3.5/3.6 任务级恢复已实现)、api-design.md §5.2/5.3、design.md §8.4.1TDD 验证 RED(模块缺失/错误消息不匹配)→ GREEN(聚焦 8+8 passed)→ 全量 218 passed 覆盖 100.00%1140 stmts/278 br),fail_under=99 达标 | src/genesis/orchestrator/__init__.py, src/genesis/orchestrator/datagate.py, src/genesis/orchestrator/task_queue.py, tests/test_datagate.py, tests/test_task_queue.py, docs/agent-runtime-design.md, docs/api-design.md, docs/design.md, _AI_USAGE_LOG.md | deepseek-v4-flash-free |
| 2026-08-11 | Agent 实现 | T15(架构审查整改收官,P2OV6):QA 护栏 + fallback 路由。新建 src/genesis/qa/ 包与 guardrails.pyresolve_qa_model(models) 强制返回 fallback 模型名(QA 不走 primary,防 DeepSeek 校验 DeepSeek 自校验盲区;无 fallback/name 空时返回 None 迫使显式指定独立模型);QALoopController(max_rounds=DEFAULT_MAX_QA_ROUNDS=3) 约束「QA→Writer修正→重校验」循环边界防无限;集成测试用 FakeLLMClient 验证 QA 调用实际落到 fallback 而非 primary。TDDREDModuleNotFoundError)→ GREEN9 passedguardrails 100%)→ 全量 257 passed 覆盖 100.00%1380 stmts/338 br),fail_under=99 达标;design.md §7.4 补 QA 护栏说明(循环边界 + 独立校验模型) | src/genesis/qa/__init__.py, src/genesis/qa/guardrails.py, tests/test_qa_guardrails.py, docs/design.md, _AI_USAGE_LOG.md | deepseek-v4-flash-free |
| 2026-08-12 | 架构设计 | Phase 5 spec 工程评审(plan-eng-reviewFULL_REVIEW)。评审 docs/superpowers/specs/2026-08-12-phase5-writer-qa-design.mdStep0 范围挑战(14 文件/多新类触发复杂度门禁,用户确认按完整 spec 推进);4 节评审 + Claude 子代理外部独立视角(实际核对 inference/engine.py、writer/docx_injector.py、eval/scorer.py、qa/guardrails.py 源码)共 14 项发现;4 项决策全批准(技术契约批量修正 / 范围诚实标注 / 复用 QALoopController+删除 ImpactService 桩 / 插入垂直切片里程碑);spec 落地 14 处修正并追加 ## GSTACK REVIEW REPORTNO UNRESOLVED DECISIONS | docs/superpowers/specs/2026-08-12-phase5-writer-qa-design.md, _AI_USAGE_LOG.md | deepseek-v4-flash-free |
| 2026-08-12 | Agent 实现 | Phase 5 实施计划生成(writing-plans):将评审修正后的 spec 转为 16 任务 TDD 计划(3 里程碑:M1 基础件 Lane A+B / M2 垂直切片真实 LLM 验证命题 / M3 闭环硬化 Lane C);复用既有类型(ChapterArtifact/DimensionScore/EvalReport/ChapterScorer/QALoopController/DocxInjector)不重复定义,仅扩展 EvalReport 加逐章结果;全任务含完整代码与测试;self-review 通过(spec 覆盖/无占位符/类型一致);落盘 docs/superpowers/plans/2026-08-12-phase5-writer-qa.md | docs/superpowers/plans/2026-08-12-phase5-writer-qa.md, _AI_USAGE_LOG.md | deepseek-v4-flash-free |