免费在 GitHub 公开

graphify-triage

Use this skill when the user wants to turn code graph analysis into tracked GitHub issues — "audit the architecture", "find god nodes", "triage architectural debt", "run graphify and log issues", "what's over-coupled in this codebase", "create issues from graphify findings", "check for structural problems", "scan for architectural smells", or any request that combines codebase topology analysis with issue tracking. This skill runs graphify to build a dependency graph, parses GRAPH_REPORT.md for god nodes and structural patterns, converts findings into GitHub issue payloads, and optionally pushes them to the repo. It bridges static analysis and project management in a single automated pass. Requires graphify and gh CLI.

中文简介正在准备中。当前显示原文说明。

gaia-research/gaia-skill-tree

集成工具GitHub

查看安装方法

包含的文件（3）

SKILL.md3.8 KB
resources/templates/gaia_node.json417 B
scripts/triage.py5.7 KB

SKILL.md（原文）

安装前可以查看交给 AI 代理的指令内容。

Graphify Triage

What This Skill Does

Graphify Triage is a two-phase pipeline:

Audit — runs graphify on the codebase, reads graphify-out/GRAPH_REPORT.md, and extracts god nodes (high-centrality over-coupled components) and suggested audit questions. Saves structured issue payloads to a JSON file for review.
Sync — pushes the reviewed payloads to GitHub as labelled issues via the gh CLI.

The separation matters: always audit first and review the payloads before syncing. This gives the user a chance to prune or edit before issues appear in the tracker.

Dependencies

graphify — AST extraction and graph generation. Must be installed and on PATH.
gh (GitHub CLI) — authenticated (gh auth login) before running sync.

Quick Start

# Phase 1: generate and review proposed issues
uv run ~/.claude/skills/graphify-triage/scripts/triage.py audit --path . --output payloads.json

# Inspect payloads.json, edit or remove entries as needed, then:

# Phase 2: push to GitHub
uv run ~/.claude/skills/graphify-triage/scripts/triage.py sync --input payloads.json

To target a specific repo (e.g. when the CWD origin differs):

uv run ~/.claude/skills/graphify-triage/scripts/triage.py sync --input payloads.json --repo owner/repo

Workflow Steps

Confirm graphify is installed (graphify --version). If missing, install it first — the audit step will fail silently otherwise.
Run audit. The script calls graphify . --update internally, so the graph is always fresh.
Open payloads.json and review the proposed issue titles and bodies. Remove or edit any that are false positives.
Confirm gh auth status shows authenticated before proceeding to sync.
Run sync. Issues are created with architecture/audit labels. If the repo lacks those labels, gh may prompt interactively — create them in advance to keep the run non-interactive.

What the Audit Parses

The script extracts three sections from graphify-out/GRAPH_REPORT.md:

Section	What it becomes
`## God Nodes`	One issue: "[Architectural Refactor] Decouple God Nodes…" listing the top 3
`## Surprising Connections`	Captured but currently informational only (not converted to issues)
`## Suggested Questions`	One issue per question: "[Audit] …" with context from the report

Pitfalls to Avoid

Stale graph: if you made significant changes since the last graphify run, the report may not reflect them. The audit command always passes --update to graphify, so this is only a risk if you're re-syncing an old payloads.json.

Missing labels: gh issue create --label architecture fails silently if the label doesn't exist in the target repo. Create labels upfront:

gh label create architecture --color 0075ca
gh label create audit --color e4e669

Wrong repo: sync infers the repo from the git remote. Pass --repo owner/repo explicitly when running from a clone that points somewhere other than the intended tracker.

评价

还没有评价。欢迎分享你的使用感受。

无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

同一仓库的技能

ci-churn

免费

Measure CI churn cost for a pull request: how many commits and how many CI-compute seconds were burned on avoidable "fix the CI" push rounds. Use when you want to understand the efficiency cost of a PR's iteration cycle, get actionable pre-push check suggestions, or include a churn summary in a pipeline report. Triggers: "ci churn", "how much CI did we burn", "avoidable commits", "ci efficiency", "wasted CI time", "churn report", "/ci-churn". Called automatically by /fp-drift at pipeline close.

中文简介正在准备中。当前显示原文说明。