project-structure-validator

---

name: project-structure-validator description: 压力测试STRUCT文件，验证模块化分解的可行性。当项目结构确定后使用，确保模块边界清晰。 stage: IMPLEMENTATION_PLANNING level_supported: [L1, L2, L3]

project-structure-validator: 项目结构验证

描述

压力测试project_structure.md中定义的模块化分解方案，验证其在真实场景下的可行性和独立性。

适用场景

• WORKFLOW_STEP_5 Task S5-1: STRUCT验证时，评估分解方案的合理性
• WORKFLOW_STEP_5 Task S5-3: Self-Reflection中定期审视模块边界
• 复杂项目: 模块众多且依赖复杂时

输入

• spec/implementation/project_structure.md（模块定义）
• design/architecture.md（组件依赖）
• goal_breakdown.md（GOAL与模块的映射）
• 当前级别（L1/L2/L3）

输出

• 项目结构验证报告（markdown）
• 模块分解评分（模块数/独立性/清晰度）
• 风险识别：
  • 模块间循环依赖
  • 模块职责重叠
  • 模块边界模糊
  • 模块规模不平衡
• 改进建议

执行策略

1. 从project_structure.md读取模块定义
2. 验证模块的独立性指标：
   • 模块数量适当（L1: 3-5, L2: 5-8, L3: 8-12）
   • 无循环依赖（依赖图为DAG）
   • 职责清晰（无大量协作职责）
   • 规模平衡（内部代码行数相近）
3. 对照goal_breakdown.md，检查GOAL分配到模块的合理性
4. 识别高风险模块（核心/复杂/关键路径）
5. 生成验证报告和改进建议

价值

• Architecture: 评估模块设计的质量，及早识别问题
• Tech Lead: 指导模块划分，减少后期大规模重构
• Dev: 清晰的模块边界，便于团队分工

验收标准

• 模块数量适当（不过多不过少）
• 无循环依赖
• 模块职责单一清晰
• 模块规模平衡
• 所有GOAL能清晰分配到模块