Blueprint 改进分析报告

✅ 已解决

⚠️ 待解决

🔍 待调查

💡 改进建议

📊 执行统计与趋势

总执行次数

4/9 (44%)

成功率

Claude Code 调用

超时:0 OOM:0

执行模式分布

模式	次数
single_worker	1
direct_edit	3

质量门禁通过率

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

问题类别分布

类别	次数
tool_error	3
process_gap	1
comm_misunderstanding	1
design_flaw	3

工具故障 Top 10

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

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

🔴 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

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

暂无

🔍 尚未找到原因的问题 0

暂无

💡 AI 改进建议 5

high tool_reliability

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

high process_gap

Phase3_implementation has 75% 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.