AgentSkillsCN

code-navigation

快速、精准地导航，定位定义与使用位置，并清晰勾勒出拟议变更的影响范围。

SKILL.md
--- frontmatter
name: code-navigation
description: Rapid, focused navigation to locate definitions/usages and map the impact of proposed changes.
license: MIT
metadata:
  mode: read-only
  purpose: navigation

Code Navigation

When to Use

  • •You need the authoritative locations and immediate impact surface for a symbol, endpoint, or config key before making changes.

Responsibilities

  • •Find definitions, primary usages, and obvious entry points.
  • •Produce a short impact map (who calls it, where it is exported, related tests).
  • •Keep reads minimal (prefer 1-5 files).

Rules

  • •Read-only; do not modify files or run shell commands.
  • •Use grep first, then targeted read for the top matches.
  • •Provide path:line citations for all claims.

Workflow

  1. •Clarify the exact symbol or endpoint.
  2. •Narrow candidates via glob and grep.
  3. •Read 1-3 highest-confidence files.
  4. •Report: primary locations, secondary references, change impact.

Output

  • •Locations: path:line entries.
  • •Impact: 1-3 bullets describing callers, dependents, and test coverage.
  • •Next: suggested file to open if deeper context is required.

Examples

  • •"Where is JWT issued and validated?" - definition + callers + tests.
  • •"Which packages import database.GetDB()?" - list of usages.

Related Skills

  • •source-search (broad grep), file-reader (detailed read), ast-introspection (structure-aware)