agent-quality-kit 0.2.2 → 0.2.4
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 +9 -4
- package/package.json +12 -3
- package/tool/lib/core.mjs +3 -1
- package/tool/lib/templates.mjs +1 -1
- package/tool/program.mjs +5 -5
package/README.md
CHANGED
|
@@ -1,5 +1,9 @@
|
|
|
1
1
|
# AQK — Agent Quality Kit
|
|
2
2
|
|
|
3
|
+
[](https://www.npmjs.com/package/agent-quality-kit)
|
|
4
|
+
[](https://github.com/arsen-ask-lx/Agent_Quality_Kit/actions/workflows/ci.yml)
|
|
5
|
+
[](LICENSE)
|
|
6
|
+
|
|
3
7
|
**Стандарт готовности репозитория к тому, что код в нём пишет агент.** Обещание проекта
|
|
4
8
|
становится командой с кодом возврата — и его держит машина, а не чья-то добрая воля.
|
|
5
9
|
|
|
@@ -7,12 +11,13 @@
|
|
|
7
11
|
инструменту: [«тёмная фабрика» и обязательный минимум](kit/docs/ai/project-baseline.md).
|
|
8
12
|
|
|
9
13
|
```bash
|
|
10
|
-
npx
|
|
11
|
-
npx
|
|
14
|
+
npx agent-quality-kit start # кода ещё нет: сторожа дня 0 сразу
|
|
15
|
+
npx agent-quality-kit doctor # код уже есть: уровень и что поставить
|
|
12
16
|
```
|
|
13
17
|
|
|
14
|
-
|
|
15
|
-
|
|
18
|
+
Ставить ничего не нужно, `npx` скачает пакет сам (230 КБ). Свежая версия прямо из репозитория —
|
|
19
|
+
`npx github:arsen-ask-lx/Agent_Quality_Kit doctor`, но первый запуск такого вида молчит две-три
|
|
20
|
+
минуты: он клонирует репозиторий целиком.
|
|
16
21
|
|
|
17
22
|
**Что нужно.** Node 18+ и оболочка `sh` — она есть в macOS, Linux и WSL; на Windows подойдёт
|
|
18
23
|
Git Bash. Переносимые проверки написаны на `sh` намеренно: он есть везде, где собирают код.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agent-quality-kit",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.4",
|
|
4
4
|
"description": "AQK — Agent Quality Kit: переносимый комплект, приводящий проект в состояние, пригодное для работы агентов. Правила, механические упоры, накопленные уроки. Одна команда, любой инструмент.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -19,16 +19,21 @@
|
|
|
19
19
|
"author": "Arsen Askaryants",
|
|
20
20
|
"repository": {
|
|
21
21
|
"type": "git",
|
|
22
|
-
"url": "https://github.com/arsen-ask-lx/Agent_Quality_Kit.git"
|
|
22
|
+
"url": "git+https://github.com/arsen-ask-lx/Agent_Quality_Kit.git"
|
|
23
23
|
},
|
|
24
24
|
"keywords": [
|
|
25
25
|
"aqk",
|
|
26
26
|
"agent-quality-kit",
|
|
27
27
|
"ai-agents",
|
|
28
|
+
"agentic",
|
|
28
29
|
"quality-gates",
|
|
30
|
+
"code-quality",
|
|
31
|
+
"ci",
|
|
29
32
|
"claude-code",
|
|
30
33
|
"codex",
|
|
31
|
-
"
|
|
34
|
+
"cursor",
|
|
35
|
+
"harness",
|
|
36
|
+
"repository-standard"
|
|
32
37
|
],
|
|
33
38
|
"knip": {
|
|
34
39
|
"entry": [
|
|
@@ -37,5 +42,9 @@
|
|
|
37
42
|
"project": [
|
|
38
43
|
"tool/**/*.mjs"
|
|
39
44
|
]
|
|
45
|
+
},
|
|
46
|
+
"homepage": "https://github.com/arsen-ask-lx/Agent_Quality_Kit#readme",
|
|
47
|
+
"bugs": {
|
|
48
|
+
"url": "https://github.com/arsen-ask-lx/Agent_Quality_Kit/issues"
|
|
40
49
|
}
|
|
41
50
|
}
|
package/tool/lib/core.mjs
CHANGED
|
@@ -33,7 +33,9 @@ const exists = async (p) => access(p, constants.F_OK).then(() => true, () => fal
|
|
|
33
33
|
// Как звать программу — зависит от того, как её запустили. Через npx команды `aqk` в системе
|
|
34
34
|
// нет: подсказка «aqk doctor» отправляет человека в «команда не найдена» на первом же шаге.
|
|
35
35
|
// Печатаем то, что можно скопировать и выполнить прямо сейчас.
|
|
36
|
-
|
|
36
|
+
// Имя в реестре, а не адрес репозитория: короче, скачивается 230 КБ вместо клона всего
|
|
37
|
+
// репозитория и не заставляет человека ждать три минуты в тишине на первой же команде.
|
|
38
|
+
const REPO = "agent-quality-kit";
|
|
37
39
|
|
|
38
40
|
function selfCmd() {
|
|
39
41
|
const p = process.argv[1] || "";
|
package/tool/lib/templates.mjs
CHANGED
|
@@ -45,7 +45,7 @@ const AGENTS_MD = `# AGENTS.md
|
|
|
45
45
|
| \`aqk note "…"\` | пишет урок в общий журнал | процесс или прибор подвели: проверка соврала, правило обошли |
|
|
46
46
|
|
|
47
47
|
Если команды \`aqk\` нет в системе — комплект ставили разово, без установки. Тогда вместо
|
|
48
|
-
\`aqk\` пиши \`npx
|
|
48
|
+
\`aqk\` пиши \`npx agent-quality-kit\`. Любая команда сама печатает тот
|
|
49
49
|
вызов, который сработает у тебя.
|
|
50
50
|
|
|
51
51
|
**Три вещи, которые надо понимать, а не запоминать:**
|
package/tool/program.mjs
CHANGED
|
@@ -9,10 +9,10 @@
|
|
|
9
9
|
// цепочке поставок. Инструмент, который ставят одной командой в чужой проект, обязан быть
|
|
10
10
|
// проверяемым глазами за один присест.
|
|
11
11
|
//
|
|
12
|
-
// npx
|
|
13
|
-
// npx
|
|
14
|
-
// npx
|
|
15
|
-
// npx
|
|
12
|
+
// npx agent-quality-kit init разложить комплект в текущий проект
|
|
13
|
+
// npx agent-quality-kit init --force перезаписать уже существующие файлы
|
|
14
|
+
// npx agent-quality-kit note "..." записать урок в общий журнал
|
|
15
|
+
// npx agent-quality-kit doctor проверить, что разложено и чего не хватает
|
|
16
16
|
|
|
17
17
|
import { realpathSync } from "node:fs";
|
|
18
18
|
import { fileURLToPath } from "node:url";
|
|
@@ -74,7 +74,7 @@ if (IS_MAIN) {
|
|
|
74
74
|
${c.bold(`${SELF} note`)} "…" записать урок в общий журнал шишек
|
|
75
75
|
${c.bold(`${SELF} blob`)} собрать методички в один файл GOD_AI.md
|
|
76
76
|
|
|
77
|
-
${c.dim("Без установки: npx
|
|
77
|
+
${c.dim("Без установки: npx agent-quality-kit init")}
|
|
78
78
|
`);
|
|
79
79
|
process.exit(cmd ? 1 : 0);
|
|
80
80
|
}
|