agent-quality-kit 0.4.0 → 0.4.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +15 -0
- package/README.ru.md +15 -0
- package/package.json +1 -1
- package/tool/i18n/en.mjs +1 -1
- package/tool/i18n/ru.mjs +1 -1
- package/tool/i18n/templates-en.mjs +1 -0
- package/tool/i18n/templates-ru.mjs +1 -0
package/README.md
CHANGED
|
@@ -125,6 +125,21 @@ replaces. So `aqk badge` prints nothing over a red gate, and `aqk badge --check`
|
|
|
125
125
|
pipeline on the day the README and the repository part ways. The badge at the top of this file
|
|
126
126
|
is checked that way on every push.
|
|
127
127
|
|
|
128
|
+
## In your pipeline
|
|
129
|
+
|
|
130
|
+
```yaml
|
|
131
|
+
- uses: arsen-ask-lx/Agent_Quality_Kit@v0.4.1
|
|
132
|
+
with:
|
|
133
|
+
min: 1 # the build fails below AQK-1, or if any declared gate failed
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
The action is a thin wrapper around one command and holds no logic of its own — without it,
|
|
137
|
+
the same thing in a single line:
|
|
138
|
+
|
|
139
|
+
```yaml
|
|
140
|
+
- run: npx agent-quality-kit doctor --run --min 1
|
|
141
|
+
```
|
|
142
|
+
|
|
128
143
|
## Installing a gate
|
|
129
144
|
|
|
130
145
|
```bash
|
package/README.ru.md
CHANGED
|
@@ -124,6 +124,21 @@ aqk badge --check # в конвейере: код 1 в тот день, ког
|
|
|
124
124
|
роняет конвейер в тот день, когда README и репозиторий разошлись. Значок в начале этого файла
|
|
125
125
|
проверяется так на каждом пуше.
|
|
126
126
|
|
|
127
|
+
## В твоём конвейере
|
|
128
|
+
|
|
129
|
+
```yaml
|
|
130
|
+
- uses: arsen-ask-lx/Agent_Quality_Kit@v0.4.1
|
|
131
|
+
with:
|
|
132
|
+
min: 1 # сборка падает ниже AQK-1 или если упал любой объявленный гейт
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
Действие — тонкая обёртка над одной командой и своей логики не имеет; без него то же самое
|
|
136
|
+
одной строкой:
|
|
137
|
+
|
|
138
|
+
```yaml
|
|
139
|
+
- run: npx agent-quality-kit doctor --run --min 1
|
|
140
|
+
```
|
|
141
|
+
|
|
127
142
|
## Поставить гейт
|
|
128
143
|
|
|
129
144
|
```bash
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agent-quality-kit",
|
|
3
|
-
"version": "0.4.
|
|
3
|
+
"version": "0.4.1",
|
|
4
4
|
"description": "AQK — Agent Quality Kit: переносимый комплект, приводящий проект в состояние, пригодное для работы агентов. Правила, механические упоры, накопленные уроки. Одна команда, любой инструмент.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
package/tool/i18n/en.mjs
CHANGED
|
@@ -361,7 +361,7 @@ export const en = {
|
|
|
361
361
|
notReached: (cmd) => `AQK-0 is not reached — there is nothing to put on a badge. What is missing: ${cmd}`,
|
|
362
362
|
redGates: (n, names) =>
|
|
363
363
|
`Red gates: ${n} (${names}). A badge issued over a red gate is the author's claim, not a machine's fact.`,
|
|
364
|
-
hint: (n) => `Proven by a run: ${n}
|
|
364
|
+
hint: (n) => `Proven by a run. Green gates: ${n}. Paste the line above into your README.`,
|
|
365
365
|
keepTrue: (cmd) => `To keep the badge from turning into a lie, put this in your pipeline: ${cmd}`,
|
|
366
366
|
checkMissing: (places) => `No AQK badge in any of: ${places}. This is the line to paste:`,
|
|
367
367
|
checkMismatch: (where, level) => `The badge lies: ${where}, while the run says AQK-${level}. Replace it with:`,
|
package/tool/i18n/ru.mjs
CHANGED
|
@@ -362,7 +362,7 @@ export const ru = {
|
|
|
362
362
|
notReached: (cmd) => `AQK-0 не достигнут — значок выдавать не за что. Чего не хватает: ${cmd}`,
|
|
363
363
|
redGates: (n, names) =>
|
|
364
364
|
`Красных гейтов: ${n} (${names}). Значок при красном гейте — заявление автора, а не факт машины.`,
|
|
365
|
-
hint: (n) => `Проверено
|
|
365
|
+
hint: (n) => `Проверено прогоном. Зелёных гейтов: ${n}. Строку выше — в README.`,
|
|
366
366
|
keepTrue: (cmd) => `Чтобы значок не превратился во враньё, поставь в конвейер: ${cmd}`,
|
|
367
367
|
checkMissing: (places) => `Значка AQK нет ни в одном из файлов: ${places}. Вставить нужно этот:`,
|
|
368
368
|
checkMismatch: (where, level) => `Значок врёт: ${where}, а прогон говорит AQK-${level}. Заменить на:`,
|
|
@@ -42,6 +42,7 @@ Running them is your job. The human looks at the list of holes and decides which
|
|
|
42
42
|
| \`aqk find "…"\` | searches by meaning for an existing check | before inventing your own |
|
|
43
43
|
| \`aqk note "…"\` | writes a lesson into the shared journal | the process or an instrument let you down: a check lied, a rule was bypassed |
|
|
44
44
|
| \`aqk report\` | assembles a report from an actual run: what is in place and with which recipe, what is missing, what the kit told you to read | **mandatory** at the end of working with the kit — instead of a summary from memory |
|
|
45
|
+
| \`aqk badge\` | prints a level badge for the README — but only after running the declared gates, and stays silent over a red one; \`--check\` fails the pipeline when the badge stops matching the run | the human asked to show the level, or you are setting up CI |
|
|
45
46
|
|
|
46
47
|
If there is no \`aqk\` command on the system, the kit was used without installing. Then write
|
|
47
48
|
\`npx agent-quality-kit\` instead of \`aqk\`. Every command prints the invocation that will
|
|
@@ -47,6 +47,7 @@ const AGENTS_MD = `# AGENTS.md
|
|
|
47
47
|
| \`aqk find "…"\` | ищет по смыслу, есть ли уже такая проверка | прежде чем изобретать свою |
|
|
48
48
|
| \`aqk note "…"\` | пишет урок в общий журнал | процесс или прибор подвели: проверка соврала, правило обошли |
|
|
49
49
|
| \`aqk report\` | собирает прогоном отчёт: что стоит и каким рецептом, чего нет, что комплект велел прочитать | **обязательно** в конце работы с комплектом — вместо пересказа по памяти |
|
|
50
|
+
| \`aqk badge\` | печатает значок уровня для README — но только после прогона объявленных гейтов, а при красном молчит; \`--check\` роняет конвейер, когда значок разошёлся с прогоном | человек попросил показать уровень; настраиваешь конвейер |
|
|
50
51
|
|
|
51
52
|
Если команды \`aqk\` нет в системе — комплект ставили разово, без установки. Тогда вместо
|
|
52
53
|
\`aqk\` пиши \`npx agent-quality-kit\`. Любая команда сама печатает тот
|