Blueprint 改进分析报告

✅ 已解决

⚠️ 待解决

🔍 待调查

💡 改进建议

📊 执行统计与趋势

总执行次数

6/15 (40%)

成功率

Claude Code 调用

超时:0 OOM:2

执行模式分布

模式	次数
single_worker	2
direct_edit	3
unknown	1

质量门禁通过率

门禁	通过率	%	失败
gate1	2/2	100%	0
gate2	2/2	100%	0
gate3	4/5	80%	1

问题类别分布

类别	次数
tool_error	6
process_gap	2
comm_misunderstanding	1
design_flaw	3
resource_limit	1

工具故障 Top 10

工具	故障次数
patch	2
read_file	1
claude -p vision	1
playwright	1
claude	1

✅ 已确定问题及处理办法 13

🔴 critical project-blueprint-doc phase3_implementation

read_file工具返回带行号前缀的内容（1|、2|...），嵌入SVG到HTML时行号前缀破坏SVG XML结构，导致PlantUML源码（@startuml/skinparam等）以可见文本泄漏到页面

解决方案：使用Python原生open().read()替代read_file读取二进制/SVG内容用于嵌入HTML

✅ Skill 已更新 project-blueprint

🟠 high project-blueprint-doc phase3_implementation

Web页面交付验证只有结构化检查（元素计数、JS错误、CSS属性），缺少视觉内容完整性检查（如SVG源码是否泄漏为可视文本）

解决方案：新增10项视觉验证清单（SVG源码泄漏检查、textContent完整性、渐变色可见性等）并写入project-blueprint skill

✅ Skill 已更新 project-blueprint

🟡 medium project-blueprint-doc phase3_implementation

最初使用Mermaid流程图而非PlantUML，用户明确要求所有流程图默认PlantUML

解决方案：已写入user profile：所有流程图默认使用PlantUML，渲染命令plantuml -tsvg x.puml

✅ Skill 已更新 project-blueprint

🔴 critical project-blueprint-doc phase3_implementation

PlantUML默认14px字体在3029px宽的SVG中，嵌入855px容器后被缩放至3.4px——完全不可读。根本原因是SVG被浏览器自动缩放以适应容器，而不是保持原生分辨率

解决方案：①PlantUML增加skinparam defaultFontSize 22 + scale 2 ②HTML改用+max-width:none+overflow-x:auto可滚动容器，保持全分辨率

✅ Skill 已更新 project-blueprint

🟡 medium project-blueprint-doc phase3_implementation

patch工具替换HTML时意外吞掉了相邻标签（

），导致HTML结构损坏

解决方案：patch的old_string匹配范围太大，应缩小匹配范围或使用更精确的锚点

🟡 僵尸改进项：方案已有但未落地到 Skill

🔴 critical project-blueprint-self-improvement phase2_design

Blueprint阶段三把整个DESIGN.md传给Claude Code导致prompt膨胀（大项目50-100KB），超出上下文窗口，CC调起失败

解决方案：新增CC Prompt绑定步骤：Hermes从DESIGN.md提取3-5条约束+文件路径+任务描述=2-5KB prompt。CC用Read工具自取大文件。详见references/cc-prompt-binding.md

✅ Skill 已更新 project-blueprint

🔴 critical project-blueprint-self-improvement phase3_implementation

Blueprint阶段三把整个DESIGN.md传给Claude Code导致prompt膨胀（大项目50-100KB），CC调起失败。考勤助手测试用例生成被迫拆多次交互

解决方案：新增CC Prompt绑定规范：阈值策略（<5KB内联/5-15KB混合/>15KB自读目录）+ 自读目录规范（01-constraints/02-files/03-task）+ 内容安全（约束文件必须纯事实防注入）。详见references/cc-prompt-binding.md

✅ Skill 已更新 project-blueprint

🟡 medium project-blueprint-self-improvement phase3_implementation

patch工具替换HTML时意外吞掉相邻的

解决方案：patch的old_string匹配范围过大，应缩小匹配范围或使用更精确的锚点

🟡 僵尸改进项：方案已有但未落地到 Skill

🔴 critical powerbank-guide phase3_implementation

Playwright 测试大面积失败但错误信息误导：8099 端口被 wechat-qa-bot 项目的 4 个残留 http.server 进程占用，测试实际访问的是旧项目页面（微信小程序报告），断言 toContainText('充电宝') 失败。根因：VPS 上 wechat-qa-bot 常驻 http.server 进程（有自动重启机制），多次 kill 后仍复活，且新启动的 server 因端口占用静默失败

解决方案：① 启动测试 server 前必须 lsof -i:PORT 检查端口并 pkill -9 -f 'http.server' 全杀残留（wechat-qa-bot 有 4 个常驻进程需全部清除）② 改用独立端口（8130）避开被常驻项目占用的 8099/8101 ③ 启动后必须 curl 验证 title 是当前项目页面再跑测试 ④ server 必须 cd 到 dist/ 目录启动，避免服务到项目根目录的旧 index.html

🟡 僵尸改进项：方案已有但未落地到 Skill research-deliverable

🟠 high powerbank-guide phase3_implementation

python http.server 服务了错误文件：项目根目录残留旧 index.html（835KB），而新构建的 index.html 在 dist/ 下。server 默认服务 cwd 根目录的 index.html，curl 显示 835KB 旧版而磁盘 dist/ 是 458KB 新版，测试断言全部失败

解决方案：测试 server 必须 cd 到 dist/（实际部署目录）启动；启动后 curl 验证返回的 title 与字节数与磁盘 dist/index.html 一致

🟡 僵尸改进项：方案已有但未落地到 Skill research-deliverable

⚪ low powerbank-guide phase3_implementation

Playwright 测试 locator('h1') strict mode violation：页面有 2 个 h1（Hero 大标题 + 页面标题），toContainText 报 strict mode violation 失败

解决方案：多元素选择器用 .first() 或 getByRole('heading', {name: ...}) 精确定位

🟡 僵尸改进项：方案已有但未落地到 Skill None

🟡 medium powerbank-guide phase3_implementation

Claude Code 视觉检查 OOM（exit -9 × 2）：一次性让 claude -p 读 5 张大截图（130-200KB PNG）内存超限被 OOM kill，无输出

解决方案：先 /usr/bin/python3 PIL thumbnail 压缩截图到 800px 内（小尺寸），再分批（每次 2-3 张）让 claude 视觉检查；检查后清理孤儿 claude 进程

🟡 僵尸改进项：方案已有但未落地到 Skill project-blueprint

🟠 high powerbank-guide phase4_retrospective

端口被常驻项目自动复活占用 → 已改为换独立端口策略；python http.server 服务 cwd 根目录旧 index.html → 已改为 cd dist/ + 字节数双重验证。两条都已 patch 进 research-deliverable skill（端口陷阱章节）

解决方案：① 常驻项目端口冲突 → 直接换独立端口 8130，不反复清理 ② server 必须 cd dist/ 启动 + curl 字节数与 title 双验证 ③ 排查时 find 所有 index.html 位置

✅ Skill 已更新 research-deliverable

⚠️ 已确定问题但处理办法未确认 0

暂无

🔍 尚未找到原因的问题 0

暂无

💡 AI 改进建议 6

high tool_reliability

Investigate 'patch' (2 failures). Consider adding retry logic, fallback, or replacing with alternative.

high process_gap

Phase3_implementation has 67% issue rate. Review phase procedures — possible missing checks or unclear instructions.

high process_gap

Phase4_retrospective has 100% issue rate. Review phase procedures — possible missing checks or unclear instructions.

medium quality

gate3 failed 1 times. Analyze failure patterns — might need pre-gate checklist or automated pre-check.

medium skill_maintenance

Top user correction cause: 'design_flaw'. Review related skills for outdated instructions.

low optimization

High single-worker ratio vs swarm. Evaluate if more tasks qualify for swarm decomposition.