AGENT SKILL

repo-maintenance

Maintain the LlamaIndex monorepo safely: inspect package layout and pyproject metadata, use llama-dev package/test commands, run targeted package tests, and triage docs/examples automation without performing release, publish, or credentialed sync actions.

License 许可
MIT
最近更新
2026-09-03
Stars
★ 351
Forks
27

01 前言 Front Matter

name
repo-maintenance
license
MIT
metadata
{ "disco-role": "operating" }
description
Maintain the LlamaIndex monorepo safely: inspect package layout and pyproject metadata, use llama-dev package/test commands, run targeted package tests, and triage docs/examples automation without performing release, publish, or credentialed sync actions.
disable-model-invocation
true

02 资源文件 5

03 SKILL.md 正文

LlamaIndex Repo Maintenance

Use this sub-skill when an agent is working inside the LlamaIndex monorepo and needs to reason about package boundaries, test one package or a small changed set, inspect package metadata, or decide which maintenance scripts are safe to adapt.

Safe Maintenance Defaults

  • Treat the monorepo as many package projects, not one install target; package-local commands usually run from the package directory.
  • Prefer read-only inspection before mutation: list packages, read pyproject.toml, inspect tests, then choose the narrowest command.
  • Use uv package-local workflows for ordinary development and tests; avoid installing every integration unless the task explicitly requires broad validation.
  • Keep release, publish, version bump, and credentialed docs sync commands out of normal runnable guidance unless a human explicitly asks for those workflows and confirms credentials/scope.
  • When using llama-dev, run it from the repo root or pass --repo-root; package arguments are repository-relative package paths such as llama-index-core or llama-index-integrations/llms/llama-index-llms-openai.

Start Here

  1. Identify the package path and distribution name with the bundled read-only helper:

    python skills/llama-index/sub-skills/repo-maintenance/scripts/list_llama_packages.py --repo-root . --filter openai
    
  2. Inspect the relevant package metadata:

    python skills/llama-index/sub-skills/repo-maintenance/scripts/list_llama_packages.py --repo-root . --package-path llama-index-core
    
  3. Run package-local tests from the package directory when you only touched one package:

    cd llama-index-integrations/llms/llama-index-llms-openai
    uv run -- pytest
    
  4. Use llama-dev test when you need changed-package/dependant selection or a consistent package test harness:

    llama-dev test llama-index-integrations/llms/llama-index-llms-openai --workers 1
    
  5. If a command would bump versions, publish packages, sync external docs, or require secrets, stop and ask for explicit human approval.

Common Workflows

Run Tests for One Integration

  • Locate the integration under llama-index-integrations/<category>/<distribution-name>/.
  • Read its pyproject.toml and confirm its own dependency group instead of syncing unrelated integrations.
  • From that package directory, run uv run -- pytest; this lets uv create/use the package-local environment.
  • If local changes affect another package dependency, either install that changed package into the package environment deliberately or use llama-dev test <package-path> so the CLI can install local changed packages for test execution.

Add or Update a Package

  • Ensure the directory name, project.name, import namespace, and optional tool.llamahub.import_path all point to the intended integration.
  • Confirm requires-python, runtime dependencies, and test/dev dependencies match package needs without inheriting unrelated integrations.
  • Use the helper script to compare neighboring packages in the same integration category.
  • Add or update package-local tests and run only the changed package first; broaden to dependant packages only after the narrow run passes.

Use llama-dev Safely

  • Safe inspection: llama-dev pkg info <package-path>, llama-dev pkg info --all, and JSON output when machine parsing helps.
  • Safe targeted execution: llama-dev pkg exec --cmd "uv sync" <package-path> only when dependency installation is expected.
  • Safe tests: llama-dev test <package-path> --workers 1 or llama-dev test --base-ref main --workers <n> for changed-package selection.
  • Reference-only: llama-dev pkg bump mutates package versions; llama-dev release ... supports release automation. Do not run these as routine maintenance.

References

Bundled Script

  • scripts/list_llama_packages.py scans a supplied repository root for pyproject.toml files with project.name, prints paths and package metadata, and can emit JSON. It is read-only and safe to run with --help.

04 同仓库更多 Skills

VectorSpaceLab
VectorSpaceLab/AREX-Skill

passnet-triton-opt

Make a single PassNet Triton kernel fast AND numerically faithful: performance model (when a replacement can win at all), block/grid/warp tuning, autotune policy, launch overhead, and per-op numeric recipes to pass the dtype baseline tolerances. Use when a pass matches and is correct but speedup below expected, or when correctness fails by small numeric margins.

★ 351
VectorSpaceLab
VectorSpaceLab/AREX-Skill

passnet-solve

END-TO-END playbook for solving one PassNet sample: analyze the computation graphs, decide the optimization strategy (what to fuse, what to replace, what to leave alone), drive the iteration loop, and maximize the sample score. This is the ENTRY skill — invoke it first for any PassNet optimization task; it tells you when to use passnet-pattern-fusion, passnet-triton-opt and passnet-feedback.

★ 351
VectorSpaceLab
VectorSpaceLab/AREX-Skill

passnet-skill

PassNet GPU kernel optimization via compiler passes. Design and implement Triton-based optimization passes, create pass files under ./pass_dir/, self-evaluate with pass_evaluator, and iterate to maximize GPU speedup.

★ 351
VectorSpaceLab
VectorSpaceLab/AREX-Skill

passnet-pattern-fusion

Author PassNet pass files: write patterns that actually MATCH the FX graph, pick fusion regions (which ops to absorb into one Triton kernel), and structure multi-pass submissions with the mandatory shared-dispatch architecture. Use when creating or fixing pattern()/replacement_args()/replacement_func() files, when a pass "failed to match", or when deciding how to fuse multiple kernels/ops.

★ 351
VectorSpaceLab
VectorSpaceLab/AREX-Skill

passnet-orchestrate

Round/batch planning and decision support for PassNet graph optimization. Use for multi-sample triage, worker allocation, eval-budget policy, and post-eval keep/revert decisions. For solving one concrete sample end to end, use passnet-solve as the entry skill; consult this skill only when you need broader planning or a specific decision gate.

★ 351
VectorSpaceLab
VectorSpaceLab/AREX-Skill

passnet-feedback

Fast, deterministic feedback for PassNet work: pre-flight pattern/match verification WITHOUT burning a GPU evaluation, per-node bottleneck analysis of a sample's graphs, and eval-log parsing into per-variant status + estimated score + failure classification. Use BEFORE every GPU evaluation (check_pattern), at the START of a sample (analyze_graph), and AFTER every evaluation (parse_eval_log).

★ 351