Oskuste korraldamine

Korralda oskustekogu ümber nii, et nimed kodeerivad, mida iga oskus tegelikult puudutab, ning hoia symlink’id ja ristviited ümbernimetamisel järjepidevad.

Paljudes seadistustes on ÜKS kanooniline oskustekogu jagatud kataloogis ja see on symlinkitud iga tööriista hub’i (nt ~/.claude/skills/, ~/.codex/skills/). Mõned oskused elavad projekti repos ja on hub’i symlinkitud. Üks ümbernimetamine võib seega puudutada mitut symlink’i ning iga dokumenti, mis viitab vanale nimele — seda hajumist see oskus haldab.

Samm 1 — Inventuur

Loetle iga oskus ja kus see tegelikult elab. Hub’i kirje on tavaliselt symlink kanoonilisele kataloogile:

for hub in <hub-1> <hub-2>; do
  echo "== $hub =="; ls -la "$hub"
done

Lahenda iga nimi tegelikuks kataloogiks käsuga readlink -f. Märgi, millised oskused elavad projekti repos versus jagatud kogus — repo-siseste ümbernimetamiste jaoks peab selles repos kasutama git mv.

Samm 2 — Klassifitseeri backend’i järgi (nimetamisreegel)

Konventsioon: eesliide nimetab backend’i, millest oskus sõltub, otsustatud selle järgi, mida see tegelikult kutsub, mitte teema järgi. Otsi igast oskusekataloogist iseloomulikku sõltuvust:

grep -rlE "<api-host>/api|/api/<x>|<db-client>|<AUTH_TOKEN_NAME>" "$skill_dir"

• Kutsub konkreetse toote API-d / andmebaasi → selle toote eesliide (nt acme-*).
• Puhtalt kohalik (brauseri automatiseerimine, offline SOP, failitöötlus, backend’ita) → üldine/kohalik eesliide.
• Hoia temaatilist infiksi, kui perekond on suur (nt acme-seo-* vs acme-reddit-*), et seotud oskused sorteeruksid koos.

Esita klassifikatsioon kasutajale enne ümbernimetamist. Oskus, mis tundub tootespetsiifiline, aga ei tee ühtegi backend-kutset, kuulub kohalikku korvi, ja vastupidi — mine sõltuvuse järgi.

Samm 3 — Nimeta ümber (ja paranda kõik, mida ümbernimetamine katkestab)

Iga ümbernimetamise OLD → NEW jaoks:

1. Teisalda kanooniline kataloog. - Jagatud kogus: mv <lib>/OLD <lib>/NEW - Repo-sisene: cd <repo> && git mv <skills-path>/OLD <skills-path>/NEW && git commit - Valesti paigutatud valesse reposse? Teisalda see jagatud kogusse, mitte lihtsalt ümber nimetades kohapeal.
2. Ühenda symlink’id igas hub’is ümber. Eemalda aegunud link, loo uus, mis osutab kanoonilisele kataloogile. Tee seda iga tööriista hub’i jaoks, mis peegeldab kogu.
3. Uuenda name: frontmatter failis NEW/SKILL.md, et see vastaks kataloogile — laadija võtmeks on see, mitte kausta nimi.
4. Paranda ristviited. Teised oskused ja mis tahes pikaajalise mälu/märkmete failid võivad mainida OLD-i nime või vana tee järgi: bash grep -rln "OLD" <lib> <memory-dirs> 2>/dev/null Asenda esmalt kõige spetsiifilisem string (täielik vana tee enne paljast nime), et oskus, mis samuti liikus, saaks oma tee puhtalt uuendatud.

Samm 4 — Kontrolli

# broken symlinks in any hub
for hub in <hub-1> <hub-2>; do
  find -L "$hub" -maxdepth 1 -type l ! -exec test -e {} \; -print
done
# no lingering old names
grep -rn "OLD" <lib> 2>/dev/null
# each renamed skill's name: matches its dir
grep -m1 "^name:" <lib>/NEW/SKILL.md

Kinnita, et laadija registreerib iga ümbernimetatud oskuse uue nime all. Eemalda kõik eelnevalt surnud symlink’id, mida pühkimisel leiad — odav parandada, segadust tekitav jätta.

Märkused

• Ära kunagi kustuta oskust, mida sa ei ümber nimetanud. Puuduta ainult seda, mida konventsioon nõuab.
• Ümbernimetamised on odavad ja tagasipööratavad; katkised ristviited on tegelik kulu — sammude 3.4 ja 4 on selle oskuse mõte, mitte mv.
• Commit’i repo-siseseid ümbernimetamisi üks loogiline ümbernimetamine commit’i kohta, et need bisect’iksid ja revert’iksid iseseisvalt.