coding-codegraph — Claude Code skill

Static code-graph analyzer for Java / Spring Boot multi-module projects with JD-style conventions (JSF / JMQ / DUCC / UMP / Pfinder / XBP). Not a generic Java analyzer — the recall on framework-specific patterns comes from encoded conventions.

What it produces

• project_map.md — cross-application call matrix + per-project module map (Facade / DomainService / Listener / Scheduler / Gateway / Mapper / DataObject)
• enum catalog — flags same-name-different-code enums across applications
• forward call graph — Facade.method → Domain → Mapper, cross-subdomain + cross-app tracking
• reverse impact — "changing X affects which Facade entry points?" (also supports --diff from git)
• DTO / MQ / MyBatis catalogs — TRD §2.3/§2.4/§3.1 fact sources
• interface_kg.py — 9-section aggregate knowledge graph for a single interface

Install

npx @jackmu0901/coding-codegraph install
# or with the fixture-based pytest suite
npx @jackmu0901/coding-codegraph install --with-tests

Copies the skill (SKILL.md + scripts/ + references/ + pyproject.toml) into ~/.claude/skills/coding-codeGraph/. Override target:

npx @jackmu0901/coding-codegraph install --dir /path/to/skills
CLAUDE_SKILLS_DIR=/path/to/skills npx @jackmu0901/coding-codegraph install

Then in Claude Code:

/coding-codeGraph

The skill is opt-in only — Claude will not auto-invoke on adjacent phrasings like "看下调用关系" / "影响范围分析".

Runtime

• python3 >= 3.9 required
• default parser: regex (zero deps)
• optional AST parser (higher precision on package-private methods / nested class attribution):

  cd ~/.claude/skills/coding-codeGraph && pip install '.[ast]'
  # switch back to regex any time:
  export CODEGRAPH_PARSER=regex

Quick reference

# project map (multiple apps → cross-application matrix)
python3 scripts/build_project_map.py <path-a> <path-b> --out ./map.md

# reverse impact from git diff
cd <path-a> && python3 <skill>/scripts/impact_analysis.py <path-a> <path-b> --diff --out ./impact.md

# interface 9-section KG
python3 scripts/interface_kg.py <path-a> <path-b> --entry "FooFacade#bar" --out ./kg.md

See SKILL.md for the full workflow and CLI reference.

Companion

Pairs with @jackmu0901/code-wiki — cross-repo knowledge base retrieval (methodology + directory template).

License

MIT © jackmu0901