Ejecuta cualquier Skill en Manus
con un clic

Ejecuta cualquier Skill en Manus con un clic

project-nav

Estrellas321

Forks15

Actualizado23 de junio de 2026, 19:34

Use when navigating the GAC codebase, finding where code lives, or understanding the project structure. 106 source files, 151 test files.

Instalación

Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.

Ejecutar en Manus

Fuente

thomwebb

thomwebb/gac

Abrir repositorio de GitHub Ver repositorios del creador

Descarga

Ejecutar en Manus

Ocupaciones relacionadasSOC

Basado en la clasificación ocupacional SOC

Desarrolladores de softwareOcupaciones informáticas y matemáticas·SOC 15-1252

SKILL.md

readonly

name	project-nav
description	Use when navigating the GAC codebase, finding where code lives, or understanding the project structure. 106 source files, 151 test files.
tags	["navigation","project-structure","codebase"]

Project Navigation

When to Use

Finding where specific code lives
Understanding project structure
Locating configuration files
Looking for where to add new features

Structure (106 source files)

gac/
  src/gac/
    cli.py                   # Click CLI entrypoint
    main.py                  # Commit workflow orchestration
    ai.py / ai_utils.py      # AI provider integration + retry logic
    prompt.py / prompt_builder.py  # Dual-prompt system
    git.py                   # Git operations
    security.py              # Secret detection
    config.py                # Config loading (GACConfig TypedDict)
    errors.py                # Exception hierarchy (GACError base)
    preprocess.py / postprocess.py  # Diff preprocessing / message cleanup
    diff_scoring.py          # Diff relevance scoring

    providers/               # 35 provider implementations
      __init__.py            # PROVIDER_REGISTRY
      base.py                # BaseConfiguredProvider, OpenAICompatibleProvider,
                             #   AnthropicCompatibleProvider, GenericHTTPProvider
      error_handler.py       # @handle_provider_errors decorator
      protocol.py            # ProviderProtocol
      registry.py            # register_provider()
      openai.py, anthropic.py, gemini.py, ...

    oauth/                   # OAuth authentication
      base.py                # Base OAuth flow (19KB)
      chatgpt.py             # ChatGPT OAuth
      claude_code.py         # Claude Code OAuth
      copilot.py             # GitHub Copilot OAuth
      token_store.py         # Token storage (~/.gac/oauth/)

    stats/                   # Statistics tracking
      store.py               # Stats file read/write
      recorder.py            # Usage recording
      commands.py            # Stats CLI commands
      charts.py              # Chart generation
      summary.py             # Summary formatting
      migration.py           # Legacy migration

    mcp/                     # MCP server
      server.py              # MCP server implementation (22KB)
      server_utils.py        # Server utilities
      models.py              # MCP data models

    constants/               # Constants package
      defaults.py            # EnvDefaults, etc.
      commit.py              # Commit format constants
      file_patterns.py       # Secret detection patterns
      languages.py           # Language code mappings

    grouped_commit_*.py      # Grouped commit workflow (5 files)
    *_cli.py                 # Subcommand CLIs (config, init, diff, model, etc.)
    workflow_context.py      # WorkflowContext dataclass

  tests/                     # 151 test files mirroring src/
  docs/                      # Documentation (16 languages)
  scripts/                   # Automation helpers

This is not exhaustive. Use find src/gac -name "*.py" to explore.

Finding Code

Use system tools directly (NOT uv run — these aren't Python packages):

rg "def generate" src/gac/                    # ripgrep for definitions
rg "class.*Provider" src/gac/providers/       # Find provider classes
rg "os.getenv" src/gac/                       # Find env var usage
ls src/gac/providers/*.py | grep -v __init__  # List providers

Source to Test Mapping

Tests mirror source but may be split across multiple files:

Source	Tests
`src/gac/cli.py`	`tests/test_cli.py`
`src/gac/git.py`	`tests/test_git.py`, `tests/test_git_coverage.py`, `tests/test_git_integration.py`
`src/gac/stats/store.py`	`tests/test_stats_core.py`, `tests/test_stats_tracking.py`, `tests/test_stats_malformed.py`, ... (15+ files)
`src/gac/providers/openai.py`	`tests/providers/test_openai.py`
`src/gac/mcp/server.py`	`tests/test_mcp_server.py`, `tests/test_mcp_utils.py`

Key Entry Points

Starting from	Read first
CLI flags	`src/gac/cli.py` — Click `@click.option` decorators
Commit workflow	`src/gac/main.py` — `generate_commit_message()`
Provider internals	`src/gac/providers/base.py:188` — `BaseConfiguredProvider.generate()`
Config values	`src/gac/config.py` — `GACConfig` TypedDict + `load_config()`
Error types	`src/gac/errors.py` — `GACError` base, `AIError`, `SecurityError`

Navigation Tips

Provider registry: from gac.providers import PROVIDER_REGISTRY
Config: from gac.config import load_config
Provider method is generate(), returns tuple (content, in_tok, out_tok, in_cost, out_cost)
NEVER edit ~/.gac* files during development

Más de este repositorio

mismo repositorio

adding-provider

thomwebb/gac

Use when adding a new AI provider to the GAC project (e.g. a new OpenAI-compatible inference service, Anthropic-compatible endpoint, or OAuth-based provider). Lists every file that must be created or edited and the exact registration steps required for the provider to appear in the registry, the `uvx gac init` flow, the README, and the test suite.

2026-06-23321

code-quality

thomwebb/gac

Use when formatting, linting, type checking, or reviewing code quality in the GAC project. Covers ruff, mypy, Makefile targets, and coding standards.

2026-06-23321

debugging

thomwebb/gac

Use when debugging test failures, runtime errors, or unexpected behavior in the GAC project. Covers pytest debugging, logging, and common patterns.

2026-06-23321

testing

thomwebb/gac

Use when running, writing, or debugging tests in the GAC project. Covers test structure, pytest commands, provider testing patterns, and integration vs unit test practices.

2026-06-23321

Project Navigation

When to Use

Finding where specific code lives

Understanding project structure

Locating configuration files

Looking for where to add new features

Structure (106 source files)

gac/ src/gac/ cli.py # Click CLI entrypoint main.py # Commit workflow orchestration ai.py / ai_utils.py # AI provider integration + retry logic prompt.py / prompt_builder.py # Dual-prompt system git.py # Git operations security.py # Secret detection config.py # Config loading (GACConfig TypedDict) errors.py # Exception hierarchy (GACError base) preprocess.py / postprocess.py # Diff preprocessing / message cleanup diff_scoring.py # Diff relevance scoring providers/ # 35 provider implementations __init__.py # PROVIDER_REGISTRY base.py # BaseConfiguredProvider, OpenAICompatibleProvider, # AnthropicCompatibleProvider, GenericHTTPProvider error_handler.py # @handle_provider_errors decorator protocol.py # ProviderProtocol registry.py # register_provider() openai.py, anthropic.py, gemini.py, ... oauth/ # OAuth authentication base.py # Base OAuth flow (19KB) chatgpt.py # ChatGPT OAuth claude_code.py # Claude Code OAuth copilot.py # GitHub Copilot OAuth token_store.py # Token storage (~/.gac/oauth/) stats/ # Statistics tracking store.py # Stats file read/write recorder.py # Usage recording commands.py # Stats CLI commands charts.py # Chart generation summary.py # Summary formatting migration.py # Legacy migration mcp/ # MCP server server.py # MCP server implementation (22KB) server_utils.py # Server utilities models.py # MCP data models constants/ # Constants package defaults.py # EnvDefaults, etc. commit.py # Commit format constants file_patterns.py # Secret detection patterns languages.py # Language code mappings grouped_commit_*.py # Grouped commit workflow (5 files) *_cli.py # Subcommand CLIs (config, init, diff, model, etc.) workflow_context.py # WorkflowContext dataclass tests/ # 151 test files mirroring src/ docs/ # Documentation (16 languages) scripts/ # Automation helpers

This is not exhaustive. Use find src/gac -name "*.py" to explore.

Finding Code

Use system tools directly (NOT uv run — these aren't Python packages):

rg "def generate" src/gac/ # ripgrep for definitions rg "class.*Provider" src/gac/providers/ # Find provider classes rg "os.getenv" src/gac/ # Find env var usage ls src/gac/providers/*.py | grep -v __init__ # List providers

Source to Test Mapping

Tests mirror source but may be split across multiple files:

Source

Tests

src/gac/cli.py

tests/test_cli.py

src/gac/git.py

tests/test_git.py, tests/test_git_coverage.py, tests/test_git_integration.py

src/gac/stats/store.py

tests/test_stats_core.py, tests/test_stats_tracking.py, tests/test_stats_malformed.py, ... (15+ files)

src/gac/providers/openai.py

tests/providers/test_openai.py

src/gac/mcp/server.py

tests/test_mcp_server.py, tests/test_mcp_utils.py

Key Entry Points

Starting from

Read first

CLI flags

src/gac/cli.py — Click @click.option decorators

Commit workflow

src/gac/main.py — generate_commit_message()

Provider internals

src/gac/providers/base.py:188 — BaseConfiguredProvider.generate()

Config values

src/gac/config.py — GACConfig TypedDict + load_config()

Error types

src/gac/errors.py — GACError base, AIError, SecurityError

Navigation Tips

Provider registry: from gac.providers import PROVIDER_REGISTRY

Config: from gac.config import load_config

Provider method is generate(), returns tuple (content, in_tok, out_tok, in_cost, out_cost)

NEVER edit ~/.gac* files during development