Agent skill

project-structure-validator

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

View SKILL.md on GitHub Repository
Stars 5
Forks 1

Install this agent skill to your Project

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

SKILL.md

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

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

tikazyq/agentic-spec-forge

code-review

执行代码审查流程（提交PR→自查→同行审查→反馈修改→合并），覆盖功能正确性、代码质量、测试完整性、安全合规四大维度。当提交Pull Request、进行结对编程、执行代码走查、需要知识共享时使用。支持L1/L2/L3三级审查深度。

5 1
Explore
tikazyq/agentic-spec-forge

code-quality

执行代码质量门禁检查（测试通过→覆盖率→Lint→GOAL追溯→可提交），验证单元测试覆盖率≥80%、集成测试通过率≥95%、代码规范零错误。当完成代码实现、准备提交代码、需要质量验证、进行提交前自检时使用。确保代码可合并。

5 1
Explore
tikazyq/agentic-spec-forge

tdd-cycle

执行 TDD 红绿重构循环（RED→GREEN→REFACTOR→REPEAT），通过先写失败测试、最小代码实现、保持绿色重构的节奏驱动开发。当启动功能开发、需要测试驱动节奏、进行迭代编码、追求高测试覆盖率时使用。提供检查清单和节奏控制。

5 1
Explore
tikazyq/agentic-spec-forge

refactoring

执行代码重构（识别坏味道→选择手法→小步修改→运行测试），在保持外部行为不变前提下改进内部结构。当TDD进入REFACTOR阶段、发现代码坏味道、需要消除重复代码、优化代码结构时使用。支持提取方法、类、参数对象等重构手法。

5 1
Explore
tikazyq/agentic-spec-forge

arch-options-compare

比较多个架构方案（单体/微服务等），从SOLID原则、成本、复杂度等维度评分，生成对比表和推荐方案。当需要向客户解释架构选择或ADR决策时使用。

5 1
Explore
tikazyq/agentic-spec-forge

dev-tech-view-supplement

根据设计补充Dev视角的技术细节（数据库/API/通信协议），帮助Dev快速进入实施。当L1/L2设计缺乏技术细节、或准备向Dev交付前使用。

5 1
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results