Lang Protobuf
Lint and generate Protobuf and gRPC contracts.
Skill metadata
| Source | Bundled (installed by default) |
| Path | skills/software-development/lang-protobuf |
| Version | 1.0.0 |
| Author | VibeOS |
| License | MIT |
| Platforms | linux, macos, windows |
Reference: full SKILL.md
信息
The following is the complete skill definition that VibeOS loads when this skill is triggered. This is what the agent sees as instructions when the skill is active.
Protobuf / gRPC Language Pack Skill
Drive Protobuf / gRPC work with the project index and standard CLI recipes.
LSP hint: none (toolchain CLI) (editor-side when applicable). Zero new core tools.
What this language is (beginner)
Язык описания структур данных и RPC-контрактов. Один .proto → код на Go/TS/Java/… для клиентов и серверов.
Лучше всего для:
- микросервисные контракты
- gRPC API
- codegen клиентов на многих языках
- версионируемые схемы
When to Use
Выбирай этот pack, если:
- есть *.proto / buf.yaml
- сервисы общаются по gRPC
- нужен стабильный контракт между командами
Manifests (автодетект репозитория): buf.yaml, buf.gen.yaml, buf.work.yaml, *.proto
Обычно рядом: Go/Java/TypeScript сервисы; часто рядом с Docker/K8s.
См. также skill choose-language-pack и vibeos language recommend "…".
When NOT to use
- публичный HTTP JSON API для браузера → REST/GraphQL
- простой монолит → язык приложения без IDL
- только БД-схема → sql / prisma
Prerequisites
vibeos pack apply lang-protobuf --apply
vibeos pack apply project-intelligence --apply
How to Run
vibeos project index build
buf lint
buf generate || true
Quick Reference
| Goal | Command |
|---|---|
| Apply pack | vibeos pack apply lang-protobuf --apply |
| Doctor | vibeos language doctor protobuf |
| Primary test | buf lint |
| Choose guide | skill choose-language-pack |
| Recommend | vibeos language recommend "…" |
Procedure
- Для нового продукта сначала
choose-language-pack/vibeos language recommend. - Work from the project root that matches pack manifests.
- Prefer project-local toolchain and committed config (sqlfluff/buf/elm.json).
- Explain destructive DB or breaking contract changes; wait for explicit ask.
- Do not invent core tools; stay on
terminal+read_file+ index CLI.
Pitfalls
- Prefer buf over ad-hoc protoc flags when buf.yaml exists.
- Breaking changes need explicit review (buf breaking).
Verification
vibeos language doctor protobuf
vibeos project index status