تشغيل أي مهارة في Manus بنقرة واحدة

project-nav

النجوم٣٢١

التفرعات١٥

آخر تحديث٢٣ يونيو ٢٠٢٦ في ١٩:٣٤

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

التثبيت

التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.

تشغيل في Manus

المصدر

thomwebb

thomwebb/gac

فتح مستودع GitHub عرض مستودعات المنشئ

تنزيل

تشغيل في Manus

المهن ذات الصلةSOC

استنادا إلى تصنيف SOC المهني

مطوّرو البرمجياتمهن الحاسوب والرياضيات·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

المزيد من هذا المستودع

نفس المستودع

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