Agent-Skills.md

Agent Skills: project-structure-validator

压力测试STRUCT文件，验证模块化分解的可行性。当项目结构确定后使用，确保模块边界清晰。

UncategorizedID: tikazyq/agentic-spec-forge/project-structure-validator
51

Install this agent skill to your local

pnpm dlx add-skill https://github.com/tikazyq/agentic-spec-forge/tree/HEAD/AGENTIC_SPEC_FORGE/spec_stage_skill/implementation_planning/project-structure-validator

Skill Files

Browse the full folder contents for project-structure-validator.

Download Skill

Loading file tree…

AGENTIC_SPEC_FORGE/spec_stage_skill/implementation_planning/project-structure-validator/SKILL.md

Skill Metadata

Name
project-structure-validator
Description
压力测试STRUCT文件，验证模块化分解的可行性。当项目结构确定后使用，确保模块边界清晰。

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能清晰分配到模块