From ai-agnostic-setup
Použij, když máš nastavit, synchronizovat nebo diagnostikovat AI agnostické prostředí repozitáře sdílené mezi Claude Code, Cursor a GitHub Copilot – třeba u proseb „nastav agenty po klonu", „přidej sdílený MCP server" nebo „proč Cursor nevidí skills". Udržuješ instrukce, skills a MCP konfiguraci z jednoho kanonu a umíš zapojit nového agenta. Nepoužívej pro psaní obsahu samotných skills či instrukcí.
How this skill is triggered — by the user, by Claude, or both
Slash command
/ai-agnostic-setup:ai-agnostic-setupThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Udržuje shodu tří AI agentů (**Claude Code**, **Cursor**, **GitHub Copilot**) na stejných instrukcích, skills a MCP serverech bez ručního kopírování.
Udržuje shodu tří AI agentů (Claude Code, Cursor, GitHub Copilot) na stejných instrukcích, skills a MCP serverech bez ručního kopírování.
Detailní architektura: Doc/ai-agents/sjednoceni.md
| Vrstva | Kanon (git) | Claude Code | Cursor | GitHub Copilot |
|---|---|---|---|---|
| Instrukce (krátké) | AGENTS.md | CLAUDE.md → AGENTS | .cursorrules + AGENTS | .github/copilot-instructions.md → AGENTS |
| Instrukce (detail) | .cursorrules | na vyžádání | auto-load | na vyžádání |
| Skills | skills/ | junction .claude/skills | junction .cursor/skills | čte skills/ přímo dle instrukce |
| MCP (sdílené) | agent/mcp.json | .mcp.json (sync skript) | .cursor/mcp.json (sync skript) | VS Code workspace settings (ruční) |
| MCP (lokální) | — | ~/.claude.json | ~/.cursor/mcp.json | VS Code user settings |
Pravidlo údržby: edituj vždy kanon, nikdy generované soubory. Generované .mcp.json a .cursor/mcp.json jsou v .gitignore.
# 1. Junction na skills (Cursor + Claude vidí skills/)
.\scripts\setup-agent-symlinks.ps1
# 2. Sync MCP z kanonu do .mcp.json a .cursor/mcp.json
.\scripts\sync-agent-mcp.ps1
# 3. Restart IDE – Cursor: Settings → MCP (zelený stav)
# Claude: claude mcp list
Env proměnné (PowerShell profil nebo systémové):
| Proměnná | Kdy povinná |
|---|---|
CONTEXT7_API_KEY | vždy |
YOUTRACK_URL, YOUTRACK_TOKEN, YOUTRACK_MCP_SERVER_PATH | jen lokální YouTrack MCP |
| Typ změny | Kde editovat |
|---|---|
| Nové krátké pravidlo pro všechny agenty | AGENTS.md |
| Detailní postup, tabulky, architektura | .cursorrules |
| Postup pro konkrétní úkol | skills/<název>/SKILL.md (nová podsložka) |
| Nový sdílený MCP server | agent/mcp.json → sync-agent-mcp.ps1 |
| Lokální / per-vývojář MCP | agent/mcp.local.json nebo ~/.cursor/mcp.json |
| Pravidlo jen pro Copilot | .github/copilot-instructions.md |
| Pravidlo jen pro Claude | CLAUDE.md |
| Modulární pravidlo jen pro Cursor | .cursor/rules/<název>.md |
Kritérium sdíleného kanonu (obojí musí platit):
npx bez absolutní lokální cestyPostup:
agent/mcp.json:
"nazev-serveru": {
"command": "npx",
"args": ["-y", "@balicek/mcp-server"],
"env": { "API_KEY": "${NAZEV_PROMENNE}" }
}
CONTRIBUTING.md..\scripts\sync-agent-mcp.ps1.vscode/mcp.json nebo VS Code user settings (viz sekce Copilot níže).AGENTS.md.Pokud server vyžaduje lokální cestu nebo osobní token → patří jen do agent/mcp.local.json nebo globálního uživatelského configu.
Tato sekce se používá až při reálné poptávce. Pro Claude, Cursor a Copilot jsou vstupní soubory hotové.
Šablona vstupního souboru (krátký, odkazuje na kanon):
# <Název nástroje> – Imatrade / REFIZ
1. Řiď se **[AGENTS.md](AGENTS.md)** – pravidla, skills, MCP.
2. Před úkolem přečti příslušný **`skills/<název>/SKILL.md`** (index: [skills/README.md](skills/README.md)).
3. Detail: **[.cursorrules](.cursorrules)**.
<krátký checklist klíčových pravidel projektu>
Po vytvoření vstupního souboru:
setup-agent-symlinks.ps1.sync-agent-mcp.ps1 nebo zdokumentovat ruční postup.AGENTS.md a Doc/ai-agents/sjednoceni.md.| Součást | Soubor | Poznámka |
|---|---|---|
| Vstup | CLAUDE.md | krátký, odkazuje na AGENTS.md |
| Skills | .claude/skills → junction na skills/ | setup-agent-symlinks.ps1 |
| MCP (projekt) | .mcp.json | generuje sync-agent-mcp.ps1; schválit při prvním spuštění |
| MCP (osobní) | ~/.claude.json | mimo git |
| Detailní pravidla | .cursorrules | Claude otevírá na vyžádání |
Ověření:
# Junction existuje?
Test-Path ".claude\skills"
# MCP načten?
claude mcp list
| Součást | Soubor | Poznámka |
|---|---|---|
| Vstup | .cursorrules | auto-load při otevření projektu |
| Modulární pravidla | .cursor/rules/*.md | frontmatter alwaysApply / glob |
| Skills | .cursor/skills → junction na skills/ | setup-agent-symlinks.ps1 |
| MCP (projekt) | .cursor/mcp.json | generuje sync-agent-mcp.ps1 |
| MCP (osobní) | ~/.cursor/mcp.json | mimo git; TeamCity, Docker gateway atd. |
Ověření:
# Junction existuje?
Test-Path ".cursor\skills"
# MCP config existuje?
Test-Path ".cursor\mcp.json"
# V Cursor UI: Settings → MCP → zelený stav serverů
| Součást | Soubor | Poznámka |
|---|---|---|
| Vstup | .github/copilot-instructions.md | auto-load v VS Code s Copilot rozšířením |
| Skills | skills/ (bez junction) | Copilot čte soubory přímo dle instrukce |
| MCP | VS Code workspace .vscode/mcp.json nebo user settings | není v sync-agent-mcp.ps1 – ruční sync |
Ruční sync MCP pro Copilot (.vscode/mcp.json):
{
"servers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"],
"env": { "CONTEXT7_API_KEY": "${CONTEXT7_API_KEY}" }
},
"playwright": {
"command": "npx",
"args": ["-y", "@playwright/mcp"]
}
}
}
Pokud se
.vscode/mcp.jsonpřidá do gitu, zkontroluj nejdřív.gitignore.
Ověření:
VS Code → Command Palette → "GitHub Copilot: Show Agent Instructions" → vidí AGENTS.md?
VS Code → Settings → MCP → servery běží?
Agent ignoruje instrukce?
├── Vstupní soubor existuje? (CLAUDE.md / .cursorrules / copilot-instructions.md)
│ └── NE → vytvoř dle šablony výše
├── Odkazuje vstupní soubor na AGENTS.md?
│ └── NE → doplň odkaz
└── AGENTS.md odkazuje na příslušný SKILL.md?
└── NE → doplň řádek do tabulky skills v AGENTS.md
Agent nepoužívá skills?
├── Junction existuje? (Test-Path ".claude\skills" / ".cursor\skills")
│ └── NE → spusť setup-agent-symlinks.ps1
├── Příslušný SKILL.md byl přečten před úkolem?
│ └── NE → instrukce v AGENTS.md říká "před úkolem přečti SKILL.md" – agent to musí dodržet
└── Copilot: instrukce říká číst skills/ explicitně?
└── NE → doplň do .github/copilot-instructions.md
Agent nevidí MCP?
├── .mcp.json / .cursor/mcp.json existuje?
│ └── NE → spusť sync-agent-mcp.ps1
├── Env proměnná CONTEXT7_API_KEY nastavena?
│ └── NE → doplň do PowerShell profilu nebo systémových proměnných
└── IDE bylo restartováno po změně MCP?
└── NE → restartuj
Po jakékoli změně v AGENTS.md, skills/, nebo agent/mcp.json:
sync-agent-mcp.ps1 spuštěn (pokud změna MCP)Test-Path ".claude\skills", Test-Path ".cursor\skills")AGENTS.md a skills/README.md aktuálníDoc/ai-agents/sjednoceni.md aktuálníagent/mcp.local.json, .mcp.json, .cursor/mcp.json nejsou v commituCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub fullcom-systems/claude-code-plugins-marketplace