strider2038/backend-structure
.cursor/skills/backend-structure/SKILL.md
Структура backend knowledge-db (cmd/, internal/). Используй при добавлении handlers, пакетов internal/, работе с kb и ingestion.
development
Updated Apr 16, 2026
$ install --global
skillsauthnpx skillsauth add strider2038/knowledge-db backend-structureInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 17, 2026, 12:59 AM12.2s1 file scanned
SKILL.md
- name:
- backend-structure
- description:
- Структура backend knowledge-db (cmd/, internal/). Используй при добавлении handlers, пакетов internal/, работе с kb и ingestion.
Структура backend knowledge-db
Расположение кода
/
├── cmd/
│ ├── kb-server/ # API + UI + Telegram bot + MCP
│ └── kb-cli/ # validate, init
├── internal/
│ ├── kb/ # работа с data/, валидация, дерево тем
│ ├── api/ # HTTP handlers, роутинг
│ ├── ingestion/ # интерфейс Ingester, pipeline
│ ├── mcp/ # MCP endpoint /api/mcp
│ └── ui/ # embed статики (embed.go, static/)
├── web/ # React исходники
└── .cursor/skills/ # agent skills
internal/kb
- Валидация структуры базы (темы 2–3 уровня, узлы с {dirname}.md и frontmatter)
- Чтение дерева тем, списка узлов
- Путь к базе —
KB_DATA_PATH(env)
internal/api
- Роутинг:
net/http.ServeMux(Go 1.22+) - Эндпоинты: GET /api/nodes/{path}, GET /api/tree, GET /api/search, POST /api/ingest
- Раздача embedded статики для /
- Маппинг ошибок в HTTP-статусы
internal/ingestion
- Интерфейс
Ingester:IngestText(text),IngestURL(url) - LLM-оркестратор в
internal/ingestion/llm— использует OpenAI Responses API (не Chat Completions)
internal/mcp
- Endpoint
/api/mcpна том же сервере - Протокол MCP для чатботов
cmd/kb-server
- main: чтение env (KB_DATA_PATH, TELEGRAM_TOKEN)
- HTTP-сервер, Telegram bot (runnable), MCP
cmd/kb-cli
- Cobra:
validate,init - validate: вызов internal/kb
- init: .gitignore, копирование skills с подстановкой {{DATA_PATH}}
Хранение
- Нет СУБД — файловая система (markdown, JSON в data/)
- Репозитории — интерфейсы для доступа к данным, реализации работают с файлами
Related Skills
strider2038/knowledge-db
development
VerifiedTrustedCommunity
Knowledge base layout and node format for knowledge-db. Use when creating or editing KB markdown files. Root path placeholder {{DATA_PATH}}.
SKILL.mdUpdated May 25, 2026
strider2038/web-frontend
development
VerifiedTrustedCommunity
Frontend web/ (React, TypeScript, Vite). Используй при работе с web/src/**/*.tsx, web/src/**/*.ts.
SKILL.mdUpdated Apr 16, 2026
strider2038/runnable-background-processes
tools
VerifiedTrustedCommunity
Регистрация фоновых процессов через pior/runnable. Используй при добавлении Telegram bot и других воркеров в kb-server.
SKILL.mdUpdated Apr 16, 2026
strider2038/openspec-verify-change
testing
VerifiedTrustedCommunity
Verify implementation matches change artifacts. Use when the user wants to validate that implementation is complete, correct, and coherent before archiving.
SKILL.mdUpdated Apr 16, 2026