Agent skill

dependency-graph-generator

生成GOAL/SubPlan依赖DAG和关键路径分析，并执行SubPlan划分。当需要分析技术依赖、业务依赖、识别关键路径、发现并行执行机会、执行SubPlan分配时使用。基于GOAL的dependencies字段和业务逻辑分析生成Mermaid依赖图和SubPlan划分方案。

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/execspec_compile/dependency-graph-generator

SKILL.md

Dependency Graph Generator

Scope: EXECSPEC_COMPILE — Compile ExecSpec（编译 ExecSpec） 版本: 1.0.0 | 创建日期: 2025-02-03

1. 描述

生成GOAL/SubPlan依赖关系的有向无环图（DAG），执行SubPlan划分，识别关键路径和并行执行机会。

核心职责：分析技术依赖、业务依赖、生成Mermaid图、识别关键路径、建议并行执行、执行SubPlan划分与编号

2. 适用场景

  • WORKFLOW Step 3 Task 3-4: Phase规划时分析依赖关系和SubPlan划分
  • 场景A: 多个GOAL之间有依赖，需要确定执行顺序
  • 场景B: L3项目需要并行执行优化
  • 场景C: 需要将GOAL分配到SubPlan（Step 3核心任务）

对应: Build_Exec_Spec_Plans Step 3 (SubPlan划分与编号) + Step 4 (Phase规划，依赖排序)

3. 输入

  • spec/spec_artifacts_registry.md - 从Registry查询GOAL清单
  • GOAL front matter dependencies字段

4. 输出

  • spec/build/dependency_graph.md - Mermaid依赖图
  • 关键路径分析
  • 并行执行建议
  • SubPlan划分方案（GOAL→SubPlan映射表）
  • SubPlan编号（Phase_X.SubPlan_Y格式）

5. 执行步骤

  1. Read all GOAL files, extract id and dependencies from front matter
  2. Build dependency graph (adjacency list)
  3. Detect cycles (if found, report error and suggest fix)
  4. Generate Mermaid diagram (graph TD format)
  5. Calculate critical path using topological sort
  6. Identify parallel groups (GOALs with no dependencies between them)
  7. Generate SubPlan partitioning based on dependency clustering:
    • Group GOALs with tight dependencies into same SubPlan
    • Keep SubPlan size reasonable (L1: 3-5 GOALs/SubPlan, L2: 4-6, L3: 5-8)
    • Ensure SubPlan boundaries align with natural breakpoints
  8. Assign SubPlan numbers (Phase_1.SubPlan_1, Phase_1.SubPlan_2...)
  9. Output GOAL→SubPlan mapping table
  10. Write all outputs to dependency_graph.md

6. 快速开始

  1. 开发者确保所有GOAL的front matter包含dependencies字段
  2. 调用: ///dependency-graph-generator
  3. 查看: spec/build/dependency_graph.md
  4. 预计耗时: 3-5分钟

7. 使用说明

输入要求: GOAL front matter必须包含dependencies字段（可为空数组）

输出格式 (spec/build/dependency_graph.md包含):

  • Mermaid Diagram: graph TD格式的依赖图
  • Critical Path: 最长路径和估算时长
  • Parallel Groups: 可并行执行的GOAL分组（L2+）
  • SubPlan划分方案: SubPlan与GOALs映射表（含分组理由）
  • GOAL→SubPlan映射表: 每个GOAL的分配结果和依赖关系

8. 价值

  • SPEC组织: 可视化依赖，避免循环依赖
  • PM/BA: 理解业务执行顺序
  • Dev: 识别并行机会，优化执行效率

9. 质量检查

  • 依赖图已生成（Mermaid格式）
  • 无循环依赖
  • 关键路径已识别
  • 并行组已建议（L2+）
  • SubPlan划分方案已输出
  • GOAL→SubPlan映射表已生成

10. 限制条件

  • 不支持: 动态依赖（运行时决定）
  • 最大规模: 100个GOAL
  • 依赖: 需要GOAL文件包含dependencies字段

相关 SKILLs

  • 前置: 无（GOAL文件已存在）
  • 并行: constraints-generator
  • 后续: round-planning

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