From 545b9f472350225d3bfbcab673a838b4ed12eb76 Mon Sep 17 00:00:00 2001 From: lhl Date: Thu, 13 Aug 2026 11:36:11 +0800 Subject: [PATCH] docs: backfill Phase 5 AI usage log entries --- _AI_USAGE_LOG.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/_AI_USAGE_LOG.md b/_AI_USAGE_LOG.md index 6f88b63..8979df7 100644 --- a/_AI_USAGE_LOG.md +++ b/_AI_USAGE_LOG.md @@ -87,3 +87,19 @@ | 2026-08-11 | Agent 实现 | T15（架构审查整改收官，P2，OV6）：QA 护栏 + fallback 路由。新建 src/genesis/qa/ 包与 guardrails.py：resolve_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。TDD：RED（ModuleNotFoundError）→ GREEN（9 passed，guardrails 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-review，FULL_REVIEW）。评审 docs/superpowers/specs/2026-08-12-phase5-writer-qa-design.md：Step0 范围挑战（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 REPORT（NO 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 | + +| 2026-08-13 | Agent 实现 | Phase5 T1 Writer 数据模型（ChapterContent/ContentBlock 等） | src/genesis/writer/models.py; tests/test_phase5_models.py | gstack-subagent | +| 2026-08-13 | Agent 实现 | Phase5 T2 Writer 异常层（WriterError 等） | src/genesis/writer/exceptions.py; tests/test_phase5_exceptions.py | gstack-subagent | +| 2026-08-13 | Agent 实现 | Phase5 T3 RagService 同步检索接入（retrieve_* 为同步方法） | src/genesis/services/rag_service.py; tests/test_phase5_rag.py | gstack-subagent | +| 2026-08-13 | Agent 实现 | Phase5 T4 模板映射 map_template（消费 ParsedTemplate.sections） | src/genesis/writer/template_mapper.py; tests/test_phase5_template_mapper.py | gstack-subagent | +| 2026-08-13 | Agent 实现 | Phase5 T5 WriterState 跨章状态 + 评分器扩展 | src/genesis/writer/writer_state.py; tests/test_phase5_writer_state.py; src/genesis/eval/scorer.py | gstack-subagent | +| 2026-08-13 | Agent 实现 | Phase5 T6 WriterAgent.generate_chapter 接入真实 InferenceEngine.chat_structured | src/genesis/writer/writer_agent.py; src/genesis/writer/models.py; tests/test_phase5_writer_agent.py | gstack-subagent | +| 2026-08-13 | Agent 实现 | Phase5 T7 渲染器 render_chapter_blocks + DocxInjector.Block(table/list/note) | src/genesis/writer/renderer.py; tests/test_phase5_renderer.py; tests/test_docx_injector.py | gstack-subagent | +| 2026-08-13 | Agent 实现 | Phase5 T8 上下文装配 build_contexts | src/genesis/writer/context_builder.py; tests/test_phase5_context_builder.py | gstack-subagent | +| 2026-08-13 | 测试验证 | Phase5 T9 编排器 WriteOrchestrator 垂直切片 + run_phase5_slice 脚本 | src/genesis/writer/orchestrator.py; tests/test_phase5_writer_orchestrator.py; scripts/run_phase5_slice.py; samples/phase5-slice/template.docx | gstack-subagent | +| 2026-08-13 | Agent 实现 | Phase5 T11 评分器章节适配器（ChapterContent→ChapterArtifact） | src/genesis/eval/scorer.py; tests/test_phase5_scorer.py | gstack-subagent | +| 2026-08-13 | Agent 实现 | Phase5 T12 QA 校验器 QAValidator（确定性维度） | src/genesis/qa/validator.py; tests/test_phase5_validator.py | gstack-subagent | +| 2026-08-13 | Agent 实现 | Phase5 T13 QA 报告 QAReport 生成 | src/genesis/qa/report.py; src/genesis/qa/validator.py; tests/test_phase5_report.py | gstack-subagent | +| 2026-08-13 | 测试验证 | Phase5 T14 QA 闭环 QALoop（仅重失败章） | src/genesis/qa/qa_loop.py; tests/test_phase5_qa_loop.py | gstack-subagent | +| 2026-08-13 | 测试验证 | Phase5 T15 端到端 e2e + DocxInjector 真实接口对齐（inject/sections） | tests/test_phase5_e2e.py; src/genesis/writer/docx_injector.py | gstack-subagent | +| 2026-08-13 | 文档规范 | Phase5 T16 design.md 追加 Phase 5 Writer/QA 子系统章节 + 日志补齐 | docs/design.md; _AI_USAGE_LOG.md | gstack-subagent |