mr.zeroandClaude Opus 5
5ceff41668
REPO_REFACT.md and ECOSYSTEM_PLAN.md moved out of the un-versioned workspace root into the devarea repo, next to WIKI_CONNECTION.md. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
3.8 KiB
name, description, allowed-tools
| name | description | allowed-tools |
|---|---|---|
| ttg-new-repo | Create a repo on the TTG forge in the right org and register it everywhere it has to appear — clone list, wiki page, WIKI_CONNECTION table, and CI if it builds something. Use when the user wants a new repository, project or tool ("új repo", "create repo", "kezdjünk egy új projektet"). | Bash, Read, Edit, Write, Grep, Glob |
ttg-new-repo
Új repo létrehozása úgy, hogy ne maradjon árván. A tapasztalat szerint a repo elkészül, a nyilvántartásból meg kimarad — ez a skill ezt előzi meg.
1. Melyik org
Az org a repo rendeltetését jelöli; a titkosságot a repo private kapcsolója adja, nem az org. A mai kiosztás és az egymondatos definíciók a devarea/REPO_REFACT.md-ben vannak. Röviden:
| Org | Mi kerül bele |
|---|---|
games |
katalógus-termék, amivel valaki játszik |
demos |
platformbemutató (katalógus-státusz demo) |
engines |
újrafelhasználható motor/könyvtár, amitől más repók függnek |
bbs |
BBS szerverek és showcase-ek |
build |
CI toolchain és builder image |
services |
ami a mi szerverünkön fut |
tools |
amit egy ember telepít és futtat magának |
infra |
maga a kiszolgáló-környezet |
Ha a besorolás vitatható, kérdezd meg a felhasználót — a rossz org később org-váltást és utókövetést jelent.
2. Létrehozás
tea api --login ttg -X POST -d '{"name":"<repo>","private":false,"auto_init":false}' /orgs/<org>/repos
A private a tartalom érzékenységéről szóljon, ne az orgról.
3. Nyilvántartásba vétel
devarea/scripts/repos.list— új sor<workspace-útvonal>|ssh://git@git.teletypegames.org:2222/<org>/<repo>alakban, ábécérendben a blokkján belül. A workspace-mappa és az org szándékosan nem azonos: a mappák aszerint csoportosítanak, hogyan dolgozol rajtuk, az orgok aszerint, mi a repo.devarea/scripts/check-repos.sh— futtasd. Ha zöld, a lista fedi a szervert. Ez a lépés fogja el a „elkészült, de sehol nincs nyilvántartva" hibát.devarea/WIKI_CONNECTION.md— ha lesz wiki-oldala, új sor a táblázatba (Folder,Org,Title,Wiki file,URL). Ha nem lesz, vedd fel a „Folders without a wiki page" felsorolásba.
4. Wiki-oldal
Ha a repo dokumentálást érdemel, hozz létre wiki-pages/pages/<szekció>/<repo>/default.md-t. Szekció-választás a rendeltetés szerint: development/ platformok, infrastructure/ kiszolgáló, others/ eszközök, projects/ termékek.
A frontmatter kötelező mezői: title, visible, id, description, date, locale, repo, taxonomy.tag. Az id legyen egyedi — ellenőrizd (grep -rh "^id:" pages/ | sort | uniq -d), a legnagyobb használt fölött adj újat. A config/sitenav.yaml-ba is kerüljön bejegyzés, ha a menüben a helye.
5. CI
Ha a repo buildel valamit, futtasd a ttg-ci-enroll skillt.
6. Kezdő tartalom
Legyen README.md az első committól. Ha a repo egy meglévő minta rokona (pl. új *-tools vagy új store), nézd meg a testvért, és kövesd a szerkezetét — ne találj ki újat.
Ha új orgot kell létrehozni
Nem elég a puszta org: adj neki megjelenítendő nevet és Teletypers csapatot a games mintájára, különben kilóg a sorból.
tea api --login ttg -X POST -d '{"username":"<org>","visibility":"public"}' /orgs
tea api --login ttg -X PATCH -d '{"full_name":"Teletype Games <Név>","description":"<egy mondat>"}' /orgs/<org>
A csapat konfigurációját ne gépeld be — olvasd ki a mintából és másold:
tea api --login ttg /orgs/games/teams # a Teletypers csapat units_map-je és beállításai
tea api --login ttg /teams/<id>/members # a tagok
tea api --login ttg -X POST -d '<spec>' /orgs/<org>/teams
tea api --login ttg -X PUT /teams/<új-id>/members/<login>