Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
16 commits
Select commit Hold shift + click to select a range
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .github/workflows/build.yml
Original file line number Diff line number Diff line change
Expand Up @@ -35,3 +35,6 @@ jobs:

- name: Build
run: npm run build

- name: Package generated skills
run: npm run skills:package
49 changes: 49 additions & 0 deletions .github/workflows/publish-skills.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
name: Publish Interview AI Skills

on:
push:
branches:
- main
workflow_dispatch:

permissions:
contents: write

concurrency:
group: publish-interview-skills
cancel-in-progress: false

jobs:
publish:
runs-on: ubuntu-latest

steps:
- name: Checkout sources
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
with:
persist-credentials: false

- name: Setup Node.js
uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7
with:
node-version: 26

- name: Generate and verify skills
run: npm run skills:check

- name: Package skills
run: npm run skills:package

- name: Publish downloadable archives
env:
GH_TOKEN: ${{ github.token }}
run: |
set -euo pipefail
if ! gh release view skills-latest >/dev/null 2>&1; then
gh release create skills-latest \
--target "$GITHUB_SHA" \
--title "Interview AI Skills (latest)" \
--notes "Automatically generated from the interview handbook on main." \
--latest=false
fi
gh release upload skills-latest dist/skill-archives/*.zip --clobber
4 changes: 4 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -12,3 +12,7 @@ pnpm-debug.log*
public/examples/angular
public/examples/react
dist

# Generated AI skills are published as GitHub Release assets
/skills/*/SKILL.md
/skills/*/references/
3 changes: 3 additions & 0 deletions .prettierignore
Original file line number Diff line number Diff line change
@@ -1,2 +1,5 @@
package-lock.json

# Generated from src/pages/**/index.md; maintained by npm run skills:generate
skills/*/SKILL.md
skills/*/references/*.md
25 changes: 25 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,31 @@
Вопросы и практические задания для подготовки разработчиков к собеседованиям: инженерные основы, Frontend, Backend,
архитектура, инфраструктура, командная работа и карьера.

## AI Skills для подготовки к собеседованиям

Кроме справочника, в репозитории есть [каталог AI Skills](https://angular-ru.github.io/interview/skills/). Каждый раздел
вопросов доступен как отдельный скилл для AI-агентов: он проводит пробное интервью по теме, проверяет ответы, объясняет
ошибки и адаптирует сложность под Junior, Middle или Senior.

Установить все тематические скиллы:

```bash
npx skills@latest add https://github.com/Angular-RU/angular-ru-interview-questions/releases/download/skills-latest/all.zip
```

Или только Angular:

```bash
npx skills@latest add https://github.com/Angular-RU/angular-ru-interview-questions/releases/download/skills-latest/angular.zip
```

Генератор использует `src/pages/**/index.md` как единственный источник вопросов и ответов. При сборке он создает
`skills/<тема>/SKILL.md` и `references/part-XX.md` локально; эти файлы **не хранятся в Git**. После каждого push в
`main` GitHub Actions публикует обновленные ZIP-архивы в
[GitHub Release `skills-latest`](https://github.com/Angular-RU/angular-ru-interview-questions/releases/tag/skills-latest).
Каждую тему можно установить отдельно, а `all.zip` содержит все 26 тем. После установки все вопросы и ответы доступны
без доступа к сайту. Генерация и проверка выполняются автоматически через `npm run skills:check`.

## Основы и инструменты

### Архитектура компьютера [<img src="public/logos/computer-science.svg" width="24" alt="Computer Science logo" />](public/logos/computer-science.svg)
Expand Down
9 changes: 6 additions & 3 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -18,14 +18,17 @@
"scripts": {
"predev": "npm run prebuild",
"dev": "astro dev",
"prebuild": "npm run build:public --workspaces --if-present",
"prebuild": "npm run skills:check && npm run build:public --workspaces --if-present",
"build": "astro build",
"postbuild": "pagefind --site dist --exclude-selectors \".sidebar-navigation, .site-search\"",
"preview": "astro preview",
"debug": "npm run build && astro preview --host 127.0.0.1 --port 4321",
"astro": "astro",
"format": "prettier \"!package-lock.json\" . --ignore-path .gitignore --write",
"format:check": "prettier \"!package-lock.json\" . --ignore-path .gitignore --check"
"format": "prettier \"!package-lock.json\" . --ignore-path .gitignore --ignore-path .prettierignore --write",
"format:check": "prettier \"!package-lock.json\" . --ignore-path .gitignore --ignore-path .prettierignore --check",
"skills:check": "npm run skills:generate && node scripts/check-skills.mjs && node scripts/generate-skills.mjs --check",
"skills:generate": "node scripts/generate-skills.mjs",
"skills:package": "bash scripts/package-skills.sh"
},
"devDependencies": {
"@astrojs/markdown-remark": "7.3.5",
Expand Down
38 changes: 38 additions & 0 deletions scripts/check-skills.mjs
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
import assert from 'node:assert/strict';
import {existsSync, readFileSync, readdirSync, statSync} from 'node:fs';
import {join} from 'node:path';

const root = new URL('../', import.meta.url).pathname;
const catalog = JSON.parse(readFileSync(join(root, 'skills/catalog.json'), 'utf8'));
const slugs = new Set();

for (const skill of catalog) {
assert.match(skill.slug, /^[a-z0-9]+(?:-[a-z0-9]+)*$/);
assert(!slugs.has(skill.slug), `Duplicate skill: ${skill.slug}`);
slugs.add(skill.slug);
assert(skill.title && skill.description && skill.category);
assert(skill.topics.length >= 3, `Missing topic coverage: ${skill.slug}`);

const pagePath = join(root, 'src/pages', skill.slug, 'index.md');
assert(existsSync(pagePath), `Missing topic page: ${skill.slug}`);
assert.match(readFileSync(pagePath, 'utf8'), /kind:\s*questions/);

const path = join(root, 'skills', skill.slug, 'SKILL.md');
assert(existsSync(path), `Missing SKILL.md: ${skill.slug}`);
const content = readFileSync(path, 'utf8');
assert(content.startsWith(`---\nname: ${skill.slug}\ndescription:`), `Invalid frontmatter: ${skill.slug}`);
assert(content.includes(`/interview/${skill.slug}/`), `Missing handbook link: ${skill.slug}`);
}

const pageSlugs = readdirSync(join(root, 'src/pages'))
.filter((entry) => existsSync(join(root, 'src/pages', entry, 'index.md')))
.filter((entry) => /kind:\s*questions/.test(readFileSync(join(root, 'src/pages', entry, 'index.md'), 'utf8')))
.sort();
assert.deepEqual([...slugs].sort(), pageSlugs, 'Catalog must match all question pages');

const skillDirs = readdirSync(join(root, 'skills'))
.filter((entry) => statSync(join(root, 'skills', entry)).isDirectory())
.sort();
assert.deepEqual(skillDirs, [...slugs].sort(), 'Skill directories must match catalog');

console.log(`Validated ${catalog.length} installable skills and question pages.`);
171 changes: 171 additions & 0 deletions scripts/generate-skills.mjs
Original file line number Diff line number Diff line change
@@ -0,0 +1,171 @@
import assert from 'node:assert/strict';
import {existsSync, mkdirSync, readFileSync, readdirSync, unlinkSync, writeFileSync} from 'node:fs';
import {join} from 'node:path';
import {fileURLToPath} from 'node:url';

const root = fileURLToPath(new URL('../', import.meta.url));
const catalog = JSON.parse(readFileSync(join(root, 'skills/catalog.json'), 'utf8'));
const check = process.argv.includes('--check');
const maxChunkSize = 48_000;
const generated = new Set();

function convertQuestions(source, slug) {
const body = source.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n/, '');
const sourceCount = (body.match(/<details(?:\s|>)/gi) ?? []).length;
let convertedCount = 0;

const converted = body.replace(
/<details>\s*<summary(?:\s[^>]*)?>([\s\S]*?)<\/summary>([\s\S]*?)<\/details>/gi,
(_, question, content) => {
convertedCount++;
const title = question.replace(/<[^>]+>/g, '').trim();
let answer = content
.trim()
.replace(/^<br\s*\/?>\s*/i, '')
.trim();
answer = answer.replace(/^<table><tr><td>\s*/i, '').replace(/\s*<\/td><\/tr><\/table>$/i, '');
return '\n\n#### Вопрос: ' + title + '\n\n' + answer.trim() + '\n\n';
},
);

assert(convertedCount > 0, 'No questions extracted from ' + slug);
// Some answers contain literal HTML examples with <details> tags.
assert(sourceCount - convertedCount <= 1, 'Unconverted questions in ' + slug);
const markdown = converted.replace(
/(!\[[^\]]*\]\()(assets\/[^)]+)(\))/g,
(_, before, asset, after) =>
before +
'https://raw.githubusercontent.com/Angular-RU/angular-ru-interview-questions/main/src/pages/' +
slug +
'/' +
asset +
after,
);

return {markdown, count: convertedCount};
}

function splitIntoChunks(markdown) {
const sections = markdown.split(/(?=^###\s)/m);
const chunks = [];
let current = {text: '', topics: new Set()};
let lastTopic = 'Основы';

const flush = () => {
if (!current.text.trim()) return;
chunks.push({text: current.text.trim(), topics: [...current.topics]});
current = {text: '', topics: new Set()};
};

for (const section of sections) {
const match = section.match(/^###\s+(.+)$/m);
if (match) lastTopic = match[1].trim();
const pieces = section.length > maxChunkSize ? section.split(/(?=^#### Вопрос: )/m) : [section];

for (const piece of pieces) {
if (!piece.trim()) continue;
if (current.text.length && current.text.length + piece.length > maxChunkSize) flush();
current.text += piece;
current.topics.add(lastTopic);
}
}
flush();
return chunks;
}

function generateSkill(skill) {
const page = readFileSync(join(root, 'src/pages', skill.slug, 'index.md'), 'utf8');
const {markdown, count} = convertQuestions(page, skill.slug);
const chunks = splitIntoChunks(markdown);
const items = new Map();
const index = [];
for (const [i, chunk] of chunks.entries()) {
const filename = 'part-' + String(i + 1).padStart(2, '0') + '.md';
const file = 'skills/' + skill.slug + '/references/' + filename;
const questions = (chunk.text.match(/^#### Вопрос: /gm) ?? []).length;
const topics = chunk.topics.join(', ');
items.set(
file,
[
'# ' + skill.title + ' — вопросы и ответы, часть ' + (i + 1),
'',
'> Автоматически сгенерировано из src/pages/' + skill.slug + '/index.md. Не редактируйте вручную.',
'',
chunk.text,
'',
].join('\n'),
);
index.push('- [' + topics + '](references/' + filename + ') — ' + questions + ' вопросов');
}
assert.equal(
chunks.reduce((sum, chunk) => sum + (chunk.text.match(/^#### Вопрос: /gm) ?? []).length, 0),
count,
);

items.set(
'skills/' + skill.slug + '/SKILL.md',
[
'---',
'name: ' + skill.slug,
'description: ' +
JSON.stringify(
'Вопросы и ответы для технического собеседования по теме ' +
skill.title +
'. Используйте для подготовки, проверки знаний и проведения интервью.',
),
'---',
'',
'# ' + skill.title + ' — подготовка к собеседованию',
'',
'Скилл содержит **' +
count +
' вопросов с ответами** из репозитория Angular-RU/angular-ru-interview-questions. Материалы включены в папку references/ и доступны без интернета.',
'',
'## Работа с вопросами',
'',
'1. Учитывайте запрос пользователя: обучение, объяснение конкретной темы, тренировка или пробное интервью.',
'2. При интервью задавайте **по одному вопросу** из файлов references/, не раскрывайте ответ до ответа кандидата.',
'3. Оценивайте ответ, сопоставляя его с Коротким ответом и Полным ответом исходного материала. Уточняйте пробелы и приводите примеры из базы вопросов.',
'4. Учитывайте желаемый уровень Junior, Middle или Senior. Не придумывайте содержимое источника и не выдавайте собственные дополнения за текст справочника.',
'5. Если пользователь попросил объяснение, отвечайте сразу, а не запускайте обязательное интервью. Сохраняйте язык общения пользователя.',
'6. Для API, которые могут измениться, отличайте формулировку источника от актуальных фактов. При необходимости проверяйте официальную документацию.',
'',
'## Вопросы и ответы по разделам',
'',
...index,
'',
'Исходный раздел: https://angular-ru.github.io/interview/' + skill.slug + '/',
'',
].join('\n'),
);
return items;
}

for (const skill of catalog) {
const items = generateSkill(skill);
for (const [relative, content] of items) {
generated.add(relative);
const absolute = join(root, relative);
if (check) {
assert(existsSync(absolute), 'Missing generated file: ' + relative);
assert.equal(readFileSync(absolute, 'utf8'), content, 'Outdated generated file: ' + relative);
} else {
mkdirSync(join(absolute, '..'), {recursive: true});
writeFileSync(absolute, content);
}
}

const references = join(root, 'skills', skill.slug, 'references');
if (existsSync(references)) {
for (const filename of readdirSync(references)) {
const relative = 'skills/' + skill.slug + '/references/' + filename;
if (!generated.has(relative) && filename.startsWith('part-') && filename.endsWith('.md')) {
if (check) throw new Error('Stale generated file: ' + relative);
unlinkSync(join(references, filename));
}
}
}
}
console.log(
(check ? 'Verified' : 'Generated') + ' question banks and skill instructions for ' + catalog.length + ' topics.',
);
30 changes: 30 additions & 0 deletions scripts/package-skills.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
#!/usr/bin/env bash
set -euo pipefail

out="dist/skill-archives"
mkdir -p "$out"
rm -f "$out"/*.zip

shopt -s nullglob
skill_dirs=(skills/*/)
if (( ${#skill_dirs[@]} == 0 )); then
echo "No generated skill directories found." >&2
exit 1
fi

for skill_dir in "${skill_dirs[@]}"; do
slug="${skill_dir#skills/}"
slug="${slug%/}"

if [[ ! -f "skills/$slug/SKILL.md" ]]; then
echo "Missing generated SKILL.md for $slug" >&2
exit 1
fi

(cd skills && zip -q -r -X "../$out/$slug.zip" "$slug")
unzip -tq "$out/$slug.zip" >/dev/null
done

(cd skills && zip -q -r -X "../$out/all.zip" */)
unzip -tq "$out/all.zip" >/dev/null
echo "Packaged ${#skill_dirs[@]} skills and the full bundle."
Loading
Loading