// dohoda
copilot-instructions.md
Jak by se měl Copilot chovat v tomhle repozitáři.
Pro uživatele GitHub Copilot CLI
Copilot začíná každou relaci naslepo.
Vlastní instrukce říkají Copilotu, jak se má chovat. Neříkají, co je ve vašem repozitáři. Maguyva indexuje kódovou základnu a poskytuje ji zpět přes MCP, aby GitHub Copilot CLI upravoval, jako by kód už četl.
Free tarif: 3 repozitáře, Až 50K zaindexovaných řádků repa, bez kreditní karty.
Používejte instrukce pro chování. Používejte Maguyva pro aktuální fakta o kódové základně.Vrstvená architektura
Čtyři myšlenky. Každá dělá jednu věc.
// transport
MCP
Jak Copilot sahá po externích nástrojích a kontextu.
// kódová základna
Maguyva
MCP server, který vrací podložená fakta o repozitáři.
// kdo platí
Za pracovní prostor, ne za uživatele
Za agenty se neúčtují samostatné licenční poplatky. Zobrazit ceník
Vlastní instrukce jsou pracovní dohoda. Používejte je.
# .github/copilot-instructions.md
- Dávejte přednost stávajícím hranicím modulů.
- Před navržením merge spusťte testovací příkaz repozitáře.
- Nevymýšlejte cesty k souborům. Zeptejte se, než vytvoříte nový balíček.Trvalé instrukce patří do .github/copilot-instructions.md. To je správné místo pro:
- Build, test a lint příkazy, které má Copilot spouštět.
- Pravidla “vždy dělej X / nikdy nedělej Y” platná pro tento repozitář.
- Konvence pojmenování a preference při review.
- Odkazy na protokol rozhodnutí — ne výpis každého symbolu.
Ten soubor nikdy nebyl prohledávatelným indexem repozitáře. Říká Copilotu, jak pracovat. Neříká, co tam je.
Kde vlastní instrukce přestávají ve velkém měřítku fungovat
Čtyři chybové režimy, které Copilot nedokáže opravit z markdown souboru.
// instrukce nejsou index
Telling Copilot how to behave does not tell it which class owns parseConfig, or which package actually implements the public API. První úprava v neznámém stromu je odhad struktury souborů.
// dokumentace zastarává, kód ne
Blok instrukcí popisující autentizační tok z minulého čtvrtletí je jednoznačně nesprávný ve chvíli, kdy někdo rozdělí úložiště session. Copilot will prefer the file you committed over the code that shipped.
// závislosti nejsou v markdownu
“Co tohle importuje?” is a graph question. Instrukce nemohou vyjmenovat každého volajícího, a to byste stejně nechtěli.
// kontextová okna mají rozpočet
Nacpání více repozitáře do instrukcí mění tokeny pro uvažování za zastaralý snímek. Po pár KB platíte za horší mapu.
Maguyva jako přidaná vrstva
Copilot už uvažuje v instrukcích a nástrojích.
copilot-instructions.md
dohoda
jak se Copilot chová
MCP
kanál
jak se dostane k datům
Maguyva
fakta o kódu
co vidí
- Prohledávatelná mapa repozitáře poskytovaná přes MCP jako vzdálený streamable-HTTP server.
- 11 nástrojů pro zákazníky napříč sémantickým, strukturálním (AST), grafovým a textovým vyhledáváním, plus symboly, závislosti a načítání souborů.
- Seřazené výsledky s cestami k souborům a čísly řádků napříč 284+ jazyky a textovými technologiemi.
- Jedna konfigurace Stejný workspace odpovídá v nástrojích Copilot, Claude Code, Cursor, Codex a v jakémkoli jiném MCP klientovi.
Vlastní instrukce určují, jak se má Copilot chovat.
Maguyva dává nástroji Copilot prohledávatelnou mapu kódu.
Tři pracovní postupy
Zeptejte se mapy, než přijmete diff.
// workflow 01
Najděte skutečnou implementaci, ne testovací stub
copilot> jak normalizePhoneNumber zpracovává formát E.164? semantic::query("normalize phone E.164") src/util/phone.ts:88 normalizePhoneNumber() ← skutečná impl. test/util/phone.spec.ts:14 jest.mock(...) ← stub → Copilot otevře implementaci, ne mock. [exit 0]
Jména lžou. Mocky zakrývají skutečný kód. Maguyva řadí skutečnou implementaci nad testovací mock.
// workflow 02
Zkontrolujte dopad před refaktorováním
copilot> co volá QueueDispatcher.publish? graph::callers(QueueDispatcher.publish) 3 v src/billing/* 1 v src/audit/* 1 v src/notifications/* → Diff je podložen skutečnými importéry. [exit 0]
Místa volání napříč balíčky se zobrazují přímo. Diff je podložen skutečnými importéry, ne grepem, který používá Copilot.
// workflow 03
Přejmenujte sdílenou třídu, nejprve najděte každou závislost
copilot> rename PaymentClient → BillingClient graph::callers(PaymentClient) 12 odkazů ve 7 balíčcích graph::importers(src/payments/client.ts) 9 importérů graph::extends(PaymentClient) 2 podtřídy (RetryClient, MockClient) → Copilot navrhuje migraci se seznamem souborů přímo v odpovědi. [exit 0]
Copilot se zeptá Maguyva na závislosti předtím, než začne upravovat. Seznam migrace se vrací podložený skutečným grafem, ne pamětí nástroje Copilot.
Nastavení v GitHub Copilot CLI
Tři kroky. Free tarif: 3 repozitáře, Až 50K zaindexovaných řádků repa, bez kreditní karty.
// step 01
Zaindexujte repozitář na maguyva.ai
Vyberte ten, který už znáte, abyste mohli posoudit odpovědi. Zaregistrujte se zdarma, připojte GitHub, počkejte na indexaci.
// step 02
Přidejte Maguyva jako vzdálený MCP server v aplikaci Copilot
copilot mcp add --transport http --header "Authorization: Bearer mgv_xxxx" maguyva https://maguyva.tools/mcp~/.copilot/mcp-config.json{ "mcpServers": { "maguyva": { "type": "http", "url": "https://maguyva.tools/mcp", "headers": { "Authorization": "Bearer mgv_xxxx" } } } }// step 03
Zeptejte se na otázku, jejíž odpověď už znáte
Nezačínejte celou firmou. Zeptejte se na otázku, jejíž odpověď už znáte, a poté otevřete citovaný soubor.