Publish the wiki in English, Danish and Bahasa Malaysia
Add a Danish (.da) and a Bahasa Malaysia (.ms) page for each of the five wiki pages, a language bar on every page and a three-language sidebar, as in the wiki of TirSystem/github-action. Each translation records the sha256 of the English page it follows and names English as authoritative.
This commit is contained in:
@@ -0,0 +1,42 @@
|
||||
<!-- translation of GettingStarted.md, source sha256 b030cafee29e -->
|
||||
|
||||
> Dette er en oversættelse af [`GettingStarted`](GettingStarted). Den engelske side er autoritativ, og ændringer her bliver overskrevet, næste gang wikien publiceres.
|
||||
|
||||
[English](GettingStarted) | Dansk | [Bahasa Melayu](GettingStarted.ms)
|
||||
|
||||
# Kom godt i gang
|
||||
|
||||
## Krav
|
||||
|
||||
| Værktøj | Bruges til |
|
||||
| --- | --- |
|
||||
| bash 4.4 eller nyere | scriptet (macOS leveres med 3.2: installér først en nyere bash) |
|
||||
| `git` | det lokale projekt og framework-submodulet |
|
||||
| `curl` | GitHub- og Gitea-API'erne |
|
||||
| `ssh` (valgfri) | SSH-kontrollen; uden den springes framework-trinnene over |
|
||||
| `jq` (valgfri) | JSON-læsning; uden den bruges en lille indbygget læser |
|
||||
|
||||
## Installation
|
||||
|
||||
```bash
|
||||
git clone https://git.tirsystem.com/TirSystem-BashScript/repo-foundry.git
|
||||
cd repo-foundry
|
||||
src/create-project.sh --help
|
||||
```
|
||||
|
||||
Intet installeres på hele systemet: scriptet kører fra checkout'et.
|
||||
|
||||
## Konfiguration
|
||||
|
||||
Kopiér `config.env.example` til `config.env` og `.env.example` til `.env`, og angiv derefter tjenesternes adresser og tokens (se [SSH og tokens](SshAndTokens.da)). `.env` indeholder credentials og committes aldrig.
|
||||
|
||||
## Kørsel
|
||||
|
||||
Start scriptet fra den mappe, der skal indeholde det nye projekt:
|
||||
|
||||
```bash
|
||||
src/create-project.sh # tør kørsel: læser fra værterne, opretter intet
|
||||
src/create-project.sh --apply # opretter alt efter et sidste ja
|
||||
```
|
||||
|
||||
Der laves ingen commit i det nye projekt. Arbejd på en branch der: frameworkets hooks afviser commits på `main`.
|
||||
@@ -1,3 +1,5 @@
|
||||
English | [Dansk](GettingStarted.da) | [Bahasa Melayu](GettingStarted.ms)
|
||||
|
||||
# Getting started
|
||||
|
||||
## Requirements
|
||||
|
||||
@@ -0,0 +1,42 @@
|
||||
<!-- translation of GettingStarted.md, source sha256 b030cafee29e -->
|
||||
|
||||
> Ini ialah terjemahan [`GettingStarted`](GettingStarted). Halaman bahasa Inggeris ialah teks yang sah, dan perubahan di sini akan ditimpa pada penerbitan wiki yang seterusnya.
|
||||
|
||||
[English](GettingStarted) | [Dansk](GettingStarted.da) | Bahasa Melayu
|
||||
|
||||
# Bermula
|
||||
|
||||
## Keperluan
|
||||
|
||||
| Alat | Digunakan untuk |
|
||||
| --- | --- |
|
||||
| bash 4.4 atau lebih baharu | skrip (macOS dibekalkan dengan 3.2: pasang bash yang lebih baharu dahulu) |
|
||||
| `git` | projek tempatan dan submodul framework |
|
||||
| `curl` | API GitHub dan Gitea |
|
||||
| `ssh` (pilihan) | semakan SSH; tanpanya langkah framework dilangkau |
|
||||
| `jq` (pilihan) | penghuraian JSON; tanpanya pembaca terbina dalam yang kecil digunakan |
|
||||
|
||||
## Pemasangan
|
||||
|
||||
```bash
|
||||
git clone https://git.tirsystem.com/TirSystem-BashScript/repo-foundry.git
|
||||
cd repo-foundry
|
||||
src/create-project.sh --help
|
||||
```
|
||||
|
||||
Tiada apa-apa dipasang pada seluruh sistem: skrip berjalan dari checkout.
|
||||
|
||||
## Konfigurasi
|
||||
|
||||
Salin `config.env.example` ke `config.env` dan `.env.example` ke `.env`, kemudian tetapkan alamat perkhidmatan dan token (lihat [SSH dan token](SshAndTokens.ms)). `.env` mengandungi kelayakan (credentials) dan tidak pernah di-commit.
|
||||
|
||||
## Larian
|
||||
|
||||
Mulakan skrip dari folder yang akan menyimpan projek baharu:
|
||||
|
||||
```bash
|
||||
src/create-project.sh # larian percubaan: membaca dari hos, tidak mencipta apa-apa
|
||||
src/create-project.sh --apply # mencipta semuanya selepas ya terakhir
|
||||
```
|
||||
|
||||
Tiada commit dibuat dalam projek baharu. Bekerja pada branch di sana: hook framework menolak commit pada `main`.
|
||||
@@ -0,0 +1,27 @@
|
||||
<!-- translation of Home.md, source sha256 3ab3ef0f5a55 -->
|
||||
|
||||
> Dette er en oversættelse af [`Home`](Home). Den engelske side er autoritativ, og ændringer her bliver overskrevet, næste gang wikien publiceres.
|
||||
|
||||
[English](Home) | Dansk | [Bahasa Melayu](Home.ms)
|
||||
|
||||
# Repo Foundry
|
||||
|
||||
Repo Foundry (`src/create-project.sh`) opretter et nyt projekt i én kørsel:
|
||||
|
||||
- et **Gitea**-repository, som er den autoritative kilde;
|
||||
- eventuelt et tomt **GitHub**-repository, der får alt via et push-spejl fra Gitea;
|
||||
- et **lokalt projekt** med én remote uden credentials, `origin`, og SQA-QC-Framework som git-submodul, med dets skills, git-hooks og skabeloner installeret.
|
||||
|
||||
Det er et Bash-script. Det viser først en plan og opretter intet, før du angiver `--apply` og svarer ja.
|
||||
|
||||
## Sider
|
||||
|
||||
| Side | Hvad den dækker |
|
||||
| --- | --- |
|
||||
| [Kom godt i gang](GettingStarted.da) | Krav, installation og første kørsel |
|
||||
| [SSH og tokens](SshAndTokens.da) | SSH-adgang til Gitea og de to adgangstokens |
|
||||
| [Opdatering af frameworket](UpdatingTheFramework.da) | Hold et projekts framework-submodul opdateret |
|
||||
| [Fejlfinding](Troubleshooting.da) | Almindelige fejl og hvad du skal gøre |
|
||||
|
||||
Den fulde reference (konfigurationsfiler, sikkerhedsbeslutninger, fejlhåndtering, kendte begrænsninger) er [README](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/src/branch/main/README.md).
|
||||
Meld et problem som en [issue](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/issues).
|
||||
@@ -1,3 +1,5 @@
|
||||
English | [Dansk](Home.da) | [Bahasa Melayu](Home.ms)
|
||||
|
||||
# Repo Foundry
|
||||
|
||||
Repo Foundry (`src/create-project.sh`) sets up a new project in one run:
|
||||
|
||||
@@ -0,0 +1,27 @@
|
||||
<!-- translation of Home.md, source sha256 3ab3ef0f5a55 -->
|
||||
|
||||
> Ini ialah terjemahan [`Home`](Home). Halaman bahasa Inggeris ialah teks yang sah, dan perubahan di sini akan ditimpa pada penerbitan wiki yang seterusnya.
|
||||
|
||||
[English](Home) | [Dansk](Home.da) | Bahasa Melayu
|
||||
|
||||
# Repo Foundry
|
||||
|
||||
Repo Foundry (`src/create-project.sh`) menyediakan projek baharu dalam satu larian:
|
||||
|
||||
- repositori **Gitea**, iaitu sumber yang sah;
|
||||
- secara pilihan repositori **GitHub** kosong yang menerima semuanya melalui push mirror dari Gitea;
|
||||
- **projek tempatan** dengan satu remote tanpa kelayakan (credentials), `origin`, dan SQA-QC-Framework sebagai submodul git, dengan skill, git hook dan templatnya terpasang.
|
||||
|
||||
Ia ialah skrip Bash. Ia memaparkan pelan dahulu dan tidak mencipta apa-apa sehingga anda memberikan `--apply` dan menjawab ya.
|
||||
|
||||
## Halaman
|
||||
|
||||
| Halaman | Kandungan |
|
||||
| --- | --- |
|
||||
| [Bermula](GettingStarted.ms) | Keperluan, pemasangan dan larian pertama |
|
||||
| [SSH dan token](SshAndTokens.ms) | Akses SSH ke Gitea dan dua token akses |
|
||||
| [Mengemas kini framework](UpdatingTheFramework.ms) | Pastikan submodul framework projek sentiasa terkini |
|
||||
| [Diagnosis](Troubleshooting.ms) | Kegagalan lazim dan tindakan yang perlu diambil |
|
||||
|
||||
Rujukan penuh (fail konfigurasi, keputusan keselamatan, pengendalian ralat, had yang diketahui) ialah [README](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/src/branch/main/README.md).
|
||||
Laporkan masalah sebagai [issue](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/issues).
|
||||
@@ -0,0 +1,31 @@
|
||||
<!-- translation of SshAndTokens.md, source sha256 52d740c096c8 -->
|
||||
|
||||
> Dette er en oversættelse af [`SshAndTokens`](SshAndTokens). Den engelske side er autoritativ, og ændringer her bliver overskrevet, næste gang wikien publiceres.
|
||||
|
||||
[English](SshAndTokens) | Dansk | [Bahasa Melayu](SshAndTokens.ms)
|
||||
|
||||
# SSH og tokens
|
||||
|
||||
## SSH-adgang til Gitea
|
||||
|
||||
Framework-submodulet hentes over SSH på port **10022**. Før du kører scriptet:
|
||||
|
||||
1. Tilføj din offentlige SSH-nøgle til din Gitea-konto.
|
||||
2. Opret forbindelse én gang manuelt, så serverens hostnøgle er kendt (scriptet afviser ukendte hostnøgler):
|
||||
|
||||
```bash
|
||||
ssh -p 10022 -T git@git.tirsystem.com
|
||||
```
|
||||
|
||||
En besked om, at du er godkendt, uden shell-adgang, betyder, at det virker.
|
||||
|
||||
> **Nøgler med adgangskode.** Scriptet beder aldrig om en adgangskode. En nøgle med adgangskode skal allerede være indlæst i `ssh-agent` (`ssh-add`). Det følges i [issue 77](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/issues/77).
|
||||
|
||||
## Tokens
|
||||
|
||||
| Token | Nøgle i `.env` | Nødvendig | Type |
|
||||
| --- | --- | --- | --- |
|
||||
| Gitea-adgangstoken | `GITEA_TOKEN` | altid | adgangstoken med scopes |
|
||||
| GitHub personal access token | `GITHUB_PAT` | kun hvis du vælger GitHub | **klassisk** personal access token |
|
||||
|
||||
Trin for trin med billeder: [sådan opretter du adgangstokens](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/src/branch/main/howto/create-access-tokens.md). De præcise tilladelser står under [Token permissions](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/src/branch/main/README.md#token-permissions) i README.
|
||||
@@ -1,3 +1,5 @@
|
||||
English | [Dansk](SshAndTokens.da) | [Bahasa Melayu](SshAndTokens.ms)
|
||||
|
||||
# SSH and tokens
|
||||
|
||||
## SSH access to Gitea
|
||||
|
||||
@@ -0,0 +1,31 @@
|
||||
<!-- translation of SshAndTokens.md, source sha256 52d740c096c8 -->
|
||||
|
||||
> Ini ialah terjemahan [`SshAndTokens`](SshAndTokens). Halaman bahasa Inggeris ialah teks yang sah, dan perubahan di sini akan ditimpa pada penerbitan wiki yang seterusnya.
|
||||
|
||||
[English](SshAndTokens) | [Dansk](SshAndTokens.da) | Bahasa Melayu
|
||||
|
||||
# SSH dan token
|
||||
|
||||
## Akses SSH ke Gitea
|
||||
|
||||
Submodul framework diambil melalui SSH pada port **10022**. Sebelum anda menjalankan skrip:
|
||||
|
||||
1. Tambahkan kunci awam SSH anda ke akaun Gitea anda.
|
||||
2. Sambung sekali secara manual supaya kunci hos pelayan dikenali (skrip menolak kunci hos yang tidak dikenali):
|
||||
|
||||
```bash
|
||||
ssh -p 10022 -T git@git.tirsystem.com
|
||||
```
|
||||
|
||||
Mesej bahawa anda telah berjaya disahkan, tanpa akses shell, bermakna ia berfungsi.
|
||||
|
||||
> **Kunci dengan frasa laluan.** Skrip tidak pernah meminta frasa laluan. Kunci dengan frasa laluan mesti sudah dimuatkan dalam `ssh-agent` (`ssh-add`). Perkara ini dijejaki dalam [issue 77](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/issues/77).
|
||||
|
||||
## Token
|
||||
|
||||
| Token | Kunci dalam `.env` | Diperlukan | Jenis |
|
||||
| --- | --- | --- | --- |
|
||||
| Token akses Gitea | `GITEA_TOKEN` | sentiasa | token akses dengan skop |
|
||||
| GitHub personal access token | `GITHUB_PAT` | hanya jika anda memilih GitHub | personal access token **klasik** |
|
||||
|
||||
Langkah demi langkah dengan gambar: [cara mencipta token akses](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/src/branch/main/howto/create-access-tokens.md). Kebenaran yang tepat terdapat di bawah [Token permissions](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/src/branch/main/README.md#token-permissions) dalam README.
|
||||
@@ -0,0 +1,16 @@
|
||||
<!-- translation of Troubleshooting.md, source sha256 da17de6a5d61 -->
|
||||
|
||||
> Dette er en oversættelse af [`Troubleshooting`](Troubleshooting). Den engelske side er autoritativ, og ændringer her bliver overskrevet, næste gang wikien publiceres.
|
||||
|
||||
[English](Troubleshooting) | Dansk | [Bahasa Melayu](Troubleshooting.ms)
|
||||
|
||||
# Fejlfinding
|
||||
|
||||
| Symptom | Hvad du skal kontrollere |
|
||||
| --- | --- |
|
||||
| Planen siger, at SSH-testen mislykkedes | Din nøgle er i din Gitea-konto, hostnøglen er kendt (`ssh -p 10022 -T git@git.tirsystem.com`), og en nøgle med adgangskode er indlæst med `ssh-add` |
|
||||
| Scriptet stopper ved værktøjskontrollen | bash er 4.4 eller nyere, og `git` og `curl` er installeret |
|
||||
| En vært afviser tokenet | Tokenet er gyldigt og har de scopes, der står under [SSH og tokens](SshAndTokens.da) |
|
||||
| En kørsel stoppede undervejs | Ret årsagen og kør den samme kommando igen med `--apply`: det, der allerede er oprettet, tilbydes genbrugt |
|
||||
|
||||
Mere: [Error handling and recovery](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/src/branch/main/README.md#error-handling-and-recovery) og [Known limitations](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/src/branch/main/README.md#known-limitations) i README.
|
||||
@@ -1,3 +1,5 @@
|
||||
English | [Dansk](Troubleshooting.da) | [Bahasa Melayu](Troubleshooting.ms)
|
||||
|
||||
# Troubleshooting
|
||||
|
||||
| Symptom | What to check |
|
||||
|
||||
@@ -0,0 +1,16 @@
|
||||
<!-- translation of Troubleshooting.md, source sha256 da17de6a5d61 -->
|
||||
|
||||
> Ini ialah terjemahan [`Troubleshooting`](Troubleshooting). Halaman bahasa Inggeris ialah teks yang sah, dan perubahan di sini akan ditimpa pada penerbitan wiki yang seterusnya.
|
||||
|
||||
[English](Troubleshooting) | [Dansk](Troubleshooting.da) | Bahasa Melayu
|
||||
|
||||
# Diagnosis
|
||||
|
||||
| Gejala | Perkara yang perlu disemak |
|
||||
| --- | --- |
|
||||
| Pelan menyatakan ujian SSH gagal | Kunci anda ada dalam akaun Gitea anda, kunci hos dikenali (`ssh -p 10022 -T git@git.tirsystem.com`), dan kunci dengan frasa laluan dimuatkan dengan `ssh-add` |
|
||||
| Skrip berhenti pada semakan alat | bash ialah 4.4 atau lebih baharu, dan `git` serta `curl` dipasang |
|
||||
| Hos menolak token | Token masih sah dan mempunyai skop yang disenaraikan dalam [SSH dan token](SshAndTokens.ms) |
|
||||
| Larian berhenti separuh jalan | Betulkan puncanya dan jalankan arahan yang sama sekali lagi dengan `--apply`: apa yang telah dicipta ditawarkan untuk digunakan semula |
|
||||
|
||||
Lagi: [Error handling and recovery](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/src/branch/main/README.md#error-handling-and-recovery) dan [Known limitations](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/src/branch/main/README.md#known-limitations) dalam README.
|
||||
@@ -0,0 +1,64 @@
|
||||
<!-- translation of UpdatingTheFramework.md, source sha256 3e450f6c8f34 -->
|
||||
|
||||
> Dette er en oversættelse af [`UpdatingTheFramework`](UpdatingTheFramework). Den engelske side er autoritativ, og ændringer her bliver overskrevet, næste gang wikien publiceres.
|
||||
|
||||
[English](UpdatingTheFramework) | Dansk | [Bahasa Melayu](UpdatingTheFramework.ms)
|
||||
|
||||
# Opdatering af frameworket
|
||||
|
||||
Et projekt oprettet af Repo Foundry har SQA-QC-Framework som git-submodulet `framework`. En clone eller en `git pull` flytter det ikke: projektet bliver på den framework-commit, det har registreret. For at holde frameworket opdateret kører du dette i projektet, fra dets rod:
|
||||
|
||||
```bash
|
||||
git submodule update --init --remote --recursive framework
|
||||
```
|
||||
|
||||
| Del | Hvorfor |
|
||||
| --- | --- |
|
||||
| `--init` | henter submodulet, hvis det ikke findes endnu |
|
||||
| `--remote` | flytter `framework` til den nyeste commit i framework-repositoryet i stedet for den commit, projektet har registreret |
|
||||
| `--recursive` | opdaterer også det submodul, frameworket selv har (`framework/qc`, checklisterne) |
|
||||
|
||||
## Efter opdateringen
|
||||
|
||||
1. Installér skills igen, så kopierne i `.claude/skills/` og `.agents/skills/` svarer til det nye framework:
|
||||
|
||||
```bash
|
||||
bash framework/scripts/install-skills.sh
|
||||
```
|
||||
|
||||
2. Gennemgå, hvad der er ændret, og commit derefter den nye framework-commit på en branch (frameworkets hooks afviser commits på `main`):
|
||||
|
||||
```bash
|
||||
git status
|
||||
git switch -c update-framework
|
||||
git add framework
|
||||
git commit -m "Update the framework"
|
||||
```
|
||||
|
||||
3. Opdatér `AGENTS.md` (næste afsnit).
|
||||
|
||||
## Opdatér AGENTS.md til den nyeste skabelon
|
||||
|
||||
`AGENTS.md` i dit projekt blev kopieret fra `framework/templates/AGENTS-template.md`, da projektet blev oprettet. Det er en kopi, så den ændres ikke, når frameworket ændres. Skabelonen indeholder de regler, frameworkets skills og hooks forventer (for eksempel superviseret og autonom tilstand), så opdatér den efter hver framework-opdatering.
|
||||
|
||||
1. Se, hvad der er forskelligt:
|
||||
|
||||
```bash
|
||||
diff -u AGENTS.md framework/templates/AGENTS-template.md
|
||||
```
|
||||
|
||||
2. Hvis du aldrig har redigeret `AGENTS.md`, erstat den:
|
||||
|
||||
```bash
|
||||
cp framework/templates/AGENTS-template.md AGENTS.md
|
||||
```
|
||||
|
||||
3. Hvis du har tilføjet egne regler, kopiér de nye eller ændrede skabelonafsnit ind i `AGENTS.md` i hånden og behold dine egne. Hvis du erstatter filen, mister du dem.
|
||||
|
||||
Repo Foundry lægger `/AGENTS.md` i `.git/info/exclude` i det nye projekt, så git ikke viser filen, og ændringen er ikke en commit: den påvirker kun din arbejdskopi. Erstat ikke `docs/artifact-registry.md` på samme måde: den indeholder dit projekts egne rækker, så sammenlign den kun med `framework/templates/artifact-registry-template.md` og kopiér det, du har brug for.
|
||||
|
||||
## Noter
|
||||
|
||||
- `--remote` følger framework-repositoryets standardbranch, ikke et release-tag. For at blive på et release skal du i stedet checke tagget ud i submodulet: `git -C framework checkout <tag>`, og derefter committe `framework` som ovenfor.
|
||||
- En anden person, der clone'r projektet eller henter din commit, får den registrerede framework-commit med `git submodule update --init --recursive`.
|
||||
- Submodulet hentes over SSH på port 10022, så [SSH-opsætningen](SshAndTokens.da) gælder også for opdateringer.
|
||||
@@ -1,3 +1,5 @@
|
||||
English | [Dansk](UpdatingTheFramework.da) | [Bahasa Melayu](UpdatingTheFramework.ms)
|
||||
|
||||
# Updating the framework
|
||||
|
||||
A project created by Repo Foundry holds the SQA-QC-Framework as the git submodule `framework`. A clone or a `git pull` does not move it: the project stays on the framework commit it recorded. To keep the framework up to date, run this in the project, from its root:
|
||||
@@ -49,7 +51,7 @@ git submodule update --init --remote --recursive framework
|
||||
|
||||
3. If you added your own rules, copy the new or changed template sections into `AGENTS.md` by hand and keep yours. Replacing the file would lose them.
|
||||
|
||||
Repo Foundry adds `/AGENTS.md` to `.git/info/exclude` in the new project, so git does not list the file and the change is not a commit: it only affects your working copy. Do not do the same with `docs/artifact-registry.md`: it holds your project's own rows, so only compare it with `framework/templates/artifact-registry-template.md` and copy what you need.
|
||||
Repo Foundry adds `/AGENTS.md` to `.git/info/exclude` in the new project, so git does not list the file and the change is not a commit: it only affects your working copy. Do not replace `docs/artifact-registry.md` the same way: it holds your project's own rows, so only compare it with `framework/templates/artifact-registry-template.md` and copy what you need.
|
||||
|
||||
## Notes
|
||||
|
||||
|
||||
@@ -0,0 +1,64 @@
|
||||
<!-- translation of UpdatingTheFramework.md, source sha256 3e450f6c8f34 -->
|
||||
|
||||
> Ini ialah terjemahan [`UpdatingTheFramework`](UpdatingTheFramework). Halaman bahasa Inggeris ialah teks yang sah, dan perubahan di sini akan ditimpa pada penerbitan wiki yang seterusnya.
|
||||
|
||||
[English](UpdatingTheFramework) | [Dansk](UpdatingTheFramework.da) | Bahasa Melayu
|
||||
|
||||
# Mengemas kini framework
|
||||
|
||||
Projek yang dicipta oleh Repo Foundry menyimpan SQA-QC-Framework sebagai submodul git `framework`. Clone atau `git pull` tidak menggerakkannya: projek kekal pada commit framework yang direkodkannya. Untuk memastikan framework sentiasa terkini, jalankan ini dalam projek, dari akarnya:
|
||||
|
||||
```bash
|
||||
git submodule update --init --remote --recursive framework
|
||||
```
|
||||
|
||||
| Bahagian | Sebab |
|
||||
| --- | --- |
|
||||
| `--init` | mengambil submodul jika ia belum ada |
|
||||
| `--remote` | menggerakkan `framework` ke commit terkini repositori framework, bukannya commit yang direkodkan oleh projek |
|
||||
| `--recursive` | turut mengemas kini submodul yang dimiliki framework sendiri (`framework/qc`, senarai semak) |
|
||||
|
||||
## Selepas kemas kini
|
||||
|
||||
1. Pasang semula skill, supaya salinan dalam `.claude/skills/` dan `.agents/skills/` sepadan dengan framework baharu:
|
||||
|
||||
```bash
|
||||
bash framework/scripts/install-skills.sh
|
||||
```
|
||||
|
||||
2. Semak apa yang berubah, kemudian commit commit framework baharu pada sebuah branch (hook framework menolak commit pada `main`):
|
||||
|
||||
```bash
|
||||
git status
|
||||
git switch -c update-framework
|
||||
git add framework
|
||||
git commit -m "Update the framework"
|
||||
```
|
||||
|
||||
3. Kemas kini `AGENTS.md` (bahagian seterusnya).
|
||||
|
||||
## Kemas kini AGENTS.md kepada templat terkini
|
||||
|
||||
`AGENTS.md` dalam projek anda disalin daripada `framework/templates/AGENTS-template.md` semasa projek dicipta. Ia ialah salinan, jadi ia tidak berubah apabila framework berubah. Templat itu mengandungi peraturan yang dijangka oleh skill dan hook framework (contohnya mod diselia dan mod autonomi), jadi kemas kininya selepas setiap kemas kini framework.
|
||||
|
||||
1. Lihat apa yang berbeza:
|
||||
|
||||
```bash
|
||||
diff -u AGENTS.md framework/templates/AGENTS-template.md
|
||||
```
|
||||
|
||||
2. Jika anda tidak pernah mengedit `AGENTS.md`, gantikannya:
|
||||
|
||||
```bash
|
||||
cp framework/templates/AGENTS-template.md AGENTS.md
|
||||
```
|
||||
|
||||
3. Jika anda menambah peraturan sendiri, salin bahagian templat yang baharu atau berubah ke dalam `AGENTS.md` secara manual dan kekalkan peraturan anda. Menggantikan fail akan menghilangkannya.
|
||||
|
||||
Repo Foundry menambah `/AGENTS.md` ke `.git/info/exclude` dalam projek baharu, jadi git tidak menyenaraikan fail itu dan perubahan itu bukan commit: ia hanya memberi kesan kepada salinan kerja anda. Jangan gantikan `docs/artifact-registry.md` dengan cara yang sama: ia mengandungi baris projek anda sendiri, jadi bandingkannya sahaja dengan `framework/templates/artifact-registry-template.md` dan salin apa yang anda perlukan.
|
||||
|
||||
## Nota
|
||||
|
||||
- `--remote` mengikuti branch lalai repositori framework, bukan tag keluaran. Untuk kekal pada keluaran, checkout tag di dalam submodul: `git -C framework checkout <tag>`, kemudian commit `framework` seperti di atas.
|
||||
- Orang lain yang meng-clone projek, atau menarik commit anda, mendapat commit framework yang direkodkan dengan `git submodule update --init --recursive`.
|
||||
- Submodul diambil melalui SSH pada port 10022, jadi [persediaan SSH](SshAndTokens.ms) juga terpakai untuk kemas kini.
|
||||
@@ -1,5 +1,25 @@
|
||||
**Repo Foundry**
|
||||
|
||||
**English**
|
||||
|
||||
- [Home](Home)
|
||||
- [Getting started](GettingStarted)
|
||||
- [SSH and tokens](SshAndTokens)
|
||||
- [Updating the framework](UpdatingTheFramework)
|
||||
- [Troubleshooting](Troubleshooting)
|
||||
|
||||
**Dansk**
|
||||
|
||||
- [Hjem](Home.da)
|
||||
- [Kom godt i gang](GettingStarted.da)
|
||||
- [SSH og tokens](SshAndTokens.da)
|
||||
- [Opdatering af frameworket](UpdatingTheFramework.da)
|
||||
- [Fejlfinding](Troubleshooting.da)
|
||||
|
||||
**Bahasa Melayu**
|
||||
|
||||
- [Utama](Home.ms)
|
||||
- [Bermula](GettingStarted.ms)
|
||||
- [SSH dan token](SshAndTokens.ms)
|
||||
- [Mengemas kini framework](UpdatingTheFramework.ms)
|
||||
- [Diagnosis](Troubleshooting.ms)
|
||||
|
||||
Reference in New Issue
Block a user