İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

aggrega skills

Aggrega becerisini bir AI asistanına kurma

Kullanım

aggrega skills

Açıklama

Install the skill that teaches an AI assistant to install and use Aggrega.
A skill is a folder holding a SKILL.md file in the open Agent Skills format,
which many assistants read from a skill folder of their own. The Aggrega skill
tells an assistant how to install Aggrega, how to connect it to the aggrega MCP
server, how to start a workspace, and how to run the authoring loop — scaffold,
validate, build. It carries no copy of any schema: it sends the assistant to
this binary for every structural question and to the published documentation
for every conceptual one.
The skill is built into this binary, so the copy it installs matches the
version you have.

Alt komutlar

KomutAçıklama
aggrega skills installAggrega becerisini bir yapay zekâ asistanının beceri klasörüne yazar
aggrega skills listBu ikili dosyanın içerdiği becerileri ve bunları kurabileceği asistanları listeler

aggrega skills install açıklaması

Write the Aggrega skill into the skill folder of each assistant named with
--agent, so the assistant knows how to install and use Aggrega.
By default the skill goes into the assistant's project skill folder at the root
of your workspace — the one found from the directory you run the command in, or
named with --workspace-root; a directory no workspace marks is its own root —
which is where a project's own skills are committed. With --global it goes
into the assistant's per-user skill folder in your home directory instead,
where the assistant reads it in every project.
Every folder and file a project installation writes is held to the workspace:
a skill folder reached through a link leading out of it is refused, and
nothing is written.
--agent may be given more than once. Where several of the named assistants read
the same folder, the skill is written there once.
With --global and no --agent, the skill is installed for the assistants found
on this machine: each one whose configuration folder is in your home directory
or whose command is on your PATH, as the table below names them. The command
prints each assistant it found and what found it. At a terminal it then asks
before writing: press Enter to install for those, or type the identifiers of
other assistants to add them. Where standard input is not a terminal it
installs for the assistants found without asking. Where it finds none and is
given none, it writes nothing and says so. A project installation is for the
assistants a project's people use rather than those on one machine, so it
always names them with --agent.
The skill is written as a folder named aggrega holding SKILL.md, and every file
written carries a comment line saying where it comes from. Running the command
again replaces a copy carrying that line, which is how a newer aggrega brings
the skill up to its own version. A file at the target that does not carry it
was not written by this command, so the command refuses, names the file and
writes nothing; move it aside or remove it, then run the command again. Every
target is checked before anything is written, so a refusal leaves every folder
as it was.
The assistants it installs for, the folders each one reads, and what finds each
on this machine — its configuration folder in your home directory, or its
command on your PATH:
--agent assistant project folder per-user folder found by
amp Amp .agents/skills ~/.config/amp/skills ~/.config/amp, amp
antigravity Antigravity .agents/skills ~/.gemini/config/skills ~/.gemini/antigravity, antigravity
antigravity-cli Antigravity CLI .agents/skills ~/.gemini/antigravity-cli/skills ~/.gemini/antigravity-cli
claude-code Claude Code .claude/skills ~/.claude/skills ~/.claude, claude
cline Cline .cline/skills ~/.cline/skills ~/.cline, cline
codex Codex .agents/skills ~/.agents/skills ~/.codex, codex
cursor Cursor .cursor/skills ~/.cursor/skills ~/.cursor, cursor
gemini-cli Gemini CLI .gemini/skills ~/.gemini/skills gemini
github-copilot GitHub Copilot .github/skills ~/.copilot/skills ~/.copilot, copilot
goose Goose .agents/skills ~/.agents/skills ~/.config/goose, goose
opencode OpenCode .opencode/skills ~/.config/opencode/skills ~/.config/opencode, opencode
windsurf Windsurf .devin/skills ~/.codeium/windsurf/skills ~/.codeium/windsurf, windsurf
zed Zed .agents/skills ~/.agents/skills ~/.config/zed, zed
An assistant that is not listed is refused by name. It can still use Aggrega
through its MCP server: connect it to "aggrega mcp" as
https://aggrega.ai/docs/install/ describes.

aggrega skills install bayrakları

BayrakVarsayılanAçıklama
--agent[]Becerinin kurulacağı asistan, tanımlayıcıyla (örneğin claude-code, codex, cursor ya da gemini-cli). Yinelenebilir; yardım, her tanımlayıcıyı ve her birinin yazdığı klasörü listeler. —global olmadan zorunludur; —global ile ve hiçbiri verilmediğinde beceri, bu makinede bulunan asistanlar için kurulur.
--globalfalseÇalışma alanınızın kökündeki proje beceri klasörü yerine, giriş dizininizdeki her asistanın kullanıcıya özgü beceri klasörüne kurar; asistan bu klasörü her projede okur.

aggrega skills list açıklaması

List the skills built into this binary, and the assistants "aggrega skills
install" can write them for, with the project folder and the per-user folder
each assistant reads skills from. It writes nothing.

Ne yapar

aggrega skills install, Aggrega becerisini --agent ile adlandırdığınız her yapay zekâ asistanının ya da --global ile ve --agent olmadan, bu makinede bulduğu her asistanın beceri klasörüne yazar. Beceri, açık Agent Skills biçiminde bir SKILL.md dosyası içeren bir klasördür: beceriyi adlandıran ve ne zaman kullanılacağını söyleyen kısa bir ön bilgi bloğu ve ardından talimatlar. Becerileri okuyan bir asistan, isteğiniz eşleştiğinde onu yükler; böylece Aggrega’nın nasıl kurulacağını, aggrega mcp sunucusuna nasıl bağlanılacağını, bir çalışma alanının nasıl başlatılacağını ve Aggrega dosyalarını yazma sayfasında açıklanan yazma döngüsünün nasıl çalıştırılacağını bilir.

Beceri, hiçbir şemanın ya da varlık sözleşmesinin kopyasını taşımaz. Asistana her yapısal yanıtı ikili dosyaya sormasını — sunucu bağlıysa MCP araçlarıyla, değilse aggrega komut satırıyla — ve şeylerin ne anlama geldiği için yayımlanmış belgeleri okumasını söyler. Beceri ikili dosyaya yerleşiktir; bu nedenle yazdığı kopya kurduğunuz sürümle eşleşir.

Terminal window
aggrega skills install --agent claude-code
Installed the aggrega skill for Claude Code at /home/you/project/.claude/skills/aggrega

Becerinin yerleştiği yer

--global olmadan beceri, çalışma alanınızın kökündeki asistanın proje beceri klasörüne gider; asistan projenin becerilerini burada arar ve siz de bunları burada işlersiniz. Çalışma alanı, her komutun bulduğu çalışma alanıdır — --workspace-root ile adlandırılan ya da komutu çalıştırdığınız dizinden bulunan; bu nedenle komutu bir alt klasörden çalıştırmak da kurulumu köke yapar — ve hiçbir çalışma alanının işaretlemediği bir dizin kendi köküdür. --global ile beceri, giriş dizininizdeki asistanın kullanıcıya özgü beceri klasörüne gider; asistan bu klasörü her projede okur. Yukarıdaki açıklamadaki tablo her asistan için her iki klasörü de verir; her biri o asistanın kendi belgelerinin adlandırdığı klasördür ve ~ giriş dizininizi temsil eder.

Birkaç asistan paylaşılan .agents/skills klasörünü okur. Bunlardan birden fazlasını adlandırmak beceriyi oraya bir kez yazar ve bunu bildiren tek satırda hepsini adlandırır:

Terminal window
aggrega skills install --agent codex --agent zed --global
Installed the aggrega skill for Codex and Zed at /home/you/.agents/skills/aggrega

Bu makinedeki asistanlar

--global ile ve --agent olmadan komut, beceriyi bu makinede bulduğu asistanlar için kurar. Bir asistan, kendi yapılandırma klasörü ev dizininizde olduğunda ya da komutu PATH üzerinde olduğunda bulunmuş sayılır; yukarıdaki açıklamada yer alan tablonun found by sütunu her asistan için ikisini de belirtir. Bir klasör ya da komut yalnızca tek başına o asistana ait olduğu yerde kullanılır; bu nedenle onun bulunması hiçbir zaman başka bir asistan yerine geçmez: paylaşılan .agents/skills klasörü kimseyi bulmaz ve Gemini CLI ile Antigravity’nin ikisinin de dosya tuttuğu .gemini ikisini de bulmaz — Gemini CLI gemini komutuyla, her Antigravity ürünü ise .gemini altındaki kendi klasörüyle bulunur. Yapılandırması sisteminizde başka bir yerde bulunan bir asistan, komutuyla bulunur ya da --agent ile adlandırılır.

Komut, bulduğu her asistanı ve onu neyin bulduğunu yazdırır, ardından kurar:

Terminal window
aggrega skills install --global
Found Claude Code (claude-code), from the folder /home/you/.claude
Found Codex (codex), from the command /usr/local/bin/codex
Installed the aggrega skill for Claude Code at /home/you/.claude/skills/aggrega
Installed the aggrega skill for Codex at /home/you/.agents/skills/aggrega

Bir terminalde önce sorar. Bulduklarını adlandıran satırlardan sonra sizden onay ister: bunlar için kurmak üzere Enter’a basın ya da başka asistanları eklemek için tanımlayıcılarını boşluk veya virgülle ayırarak yazın. Hiçbirini bulamadığında bunun yerine tanımlayıcıları sorar ve boş bir yanıt hiçbir şey yazmaz. Standart girdi bir terminal olmadığında — bir betik, komutu sizin yerinize çalıştıran bir asistan ya da asistanın bunun için kullandığı kendi aracı — hiçbir şey sormaz ve bulduğu asistanlar için kurar. Hiçbirini bulamadığında ve kendisine hiçbiri verilmediğinde hiçbir şey yazmaz, bunu belirtir ve sıfırdan farklı bir kodla çıkar.

Herhangi bir --agent adlandırmak aramayı atlar: komut yalnızca adlandırdığınız asistanlar için kurar, başkaları için kurmaz. --global olmadan yapılan bir proje kurulumu onları her zaman adlandırır: bu kurulum, projede çalışan kişilerin kullandığı asistanlar içindir ve bunu bu makine söyleyemez.

Yeniden kurmak ve neyi reddettiği

Komutun yazdığı her dosya, ön bilginin hemen ardından, aggrega ikili dosyasına yerleşik beceriden geldiğini ve yeniden kurmanın onu değiştireceğini söyleyen bir yorum satırı taşır. Komut kendi kopyasını sizinkinden bu satırla ayırt eder:

  • Bu satırı taşıyan bir kopya değiştirilir. Aggrega’yı yükselttikten sonra komutu yeniden çalıştırmak beceriyi yeni sürüme getirir ve yazdırdığı satır Installed yerine Replaced der.
  • Bu satırı taşımayan bir dosya reddedilir. Hedefte zaten bulunan ve komutun yazmadığı bir SKILL.md sizindir; bu nedenle komut yolunu adlandırır, hiçbir yere hiçbir şey yazmaz ve sıfır olmayan bir kodla çıkar. Dosyayı kenara taşıyın ya da kaldırın, ardından komutu yeniden çalıştırın. Kendi değişikliklerinizi korumak için onları başka adlı bir beceride tutun.
  • Çalışma alanının dışına çıkan bir bağlantı üzerinden ulaşılan bir klasör reddedilir. --global olmadan, komutun yazacağı her klasör ve dosya çalışma alanına bağlı tutulur: bir asistanın beceri klasörü ya da ona giden yoldaki bir klasör çalışma alanının dışına çıkan bir bağlantıysa komut bağlantıyı ve nereye çıktığını adlandırır, hiçbir yere hiçbir şey yazmaz ve sıfır olmayan bir kodla çıkar — bu, A path the operation writes leads through a link out of the directory it must stay inside (İşlemin yazdığı bir yol, bir bağlantı üzerinden içinde kalması gereken dizinin dışına çıkıyor) sayfasında açıklanan koşuldur. Çalışma alanının içinde kalan bir bağlantının içinden yazılır.

Herhangi bir şey yazılmadan önce her hedef denetlenir; bu nedenle bir asistan için verilen ret, diğer her asistanın klasörünü de olduğu gibi bırakır. Becerinin klasöründe becerinin yazmadığı dosyalara dokunulmaz.

Tanımadığı asistanlar

--agent yalnızca yukarıdaki tablodaki tanımlayıcıları alır; her biri, açık beceriler komut satırı aracının aynı asistan için kullandığı tanımlayıcıdır. Diğer her tanımlayıcı, bildiği tanımlayıcıların listesiyle birlikte adıyla reddedilir. Listede olmayan bir asistan yine de Aggrega’yı kullanabilir: onu MCP sunucusunu bağlama sayfasının açıkladığı gibi MCP sunucusuna bağlayın; becerinin işaret ettiği aynı araçlara ve başvuru malzemelerine ulaşır.

Örnekler

Beceriyi bu projede Claude Code için kurun:

Terminal window
aggrega skills install --agent claude-code

Her projenizde Gemini CLI ve Cursor için kurun:

Terminal window
aggrega skills install --agent gemini-cli --agent cursor --global

Bu makinedeki asistanlar için tüm projelerinize kurun:

Terminal window
aggrega skills install --global

Kurulu bir kopyayı az önce yükselttiğiniz ikili dosyaya getirin:

Terminal window
aggrega skills install --agent claude-code

Bildiklerini listelemek

aggrega skills list, bu ikili dosyaya yerleşik becerileri açıklamalarıyla, ardından aggrega skills install komutunun bildiği her asistanı proje klasörü ve kullanıcıya özgü klasörüyle yazdırır. Hiçbir şey yazmaz.

Terminal window
aggrega skills list