@booklib/core 2.0.0

package/README.pt-BR.md

@@ -0,0 +1,198 @@
+<p align="center">
+  <a href="README.md">English</a> · <a href="README.zh-CN.md">中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.ko.md">한국어</a> · <a href="README.pt-BR.md">Português</a> · <a href="README.uk.md">Українська</a>
+</p>
+
+<p align="center">
+  <img src="assets/logo.svg" width="100" alt="booklib-ai skills"/>
+</p>
+
+<h1 align="center">booklib</h1>
+
+<p align="center">
+  Skills de agentes IA baseadas em livros canônicos — para Claude Code, Cursor, Copilot e Windsurf.<br/>
+  Conhecimento especializado de livros de referência, empacotado como skills, comandos, agentes e regras.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/booklib"><img src="https://img.shields.io/npm/v/booklib.svg" alt="versão npm"/></a>
+  <a href="https://www.npmjs.com/package/booklib"><img src="https://img.shields.io/npm/dw/booklib.svg" alt="downloads"/></a>
+  <a href="https://github.com/booklib-ai/booklib/stargazers"><img src="https://img.shields.io/github/stars/booklib-ai/booklib?style=flat" alt="estrelas"/></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="licença"/></a>
+</p>
+
+<p align="center">
+  <b>22 skills</b> &nbsp;·&nbsp; <b>8 agentes</b> &nbsp;·&nbsp; <b>6 regras</b> &nbsp;·&nbsp; <b>22 comandos</b> &nbsp;·&nbsp; <b>9 perfis</b>
+</p>
+
+---
+
+## O que é
+
+Cada skill empacota as principais práticas de um livro de programação em instruções estruturadas que um agente IA pode aplicar diretamente ao código. Em vez de um prompt genérico "seja um bom programador", você obtém conhecimento especializado e direcionado, fundamentado em fontes como *Effective Java*, *Designing Data-Intensive Applications* e *Clean Code*.
+
+```bash
+# Instalar tudo globalmente
+npx booklib add --all --global
+
+# Ou instalar apenas o que sua stack precisa
+npx booklib add --profile=ts --global       # TypeScript
+npx booklib add --profile=python --global   # Python
+npx booklib add --profile=rust --global     # Rust
+npx booklib add --profile=jvm --global      # Java / Kotlin
+```
+
+## Quatro camadas
+
+| Camada | Qtd | Como é ativada | Caminho de instalação |
+|--------|-----|---------------|-----------------------|
+| **Skills** | 22 | Automaticamente, com base no tipo de arquivo e contexto da tarefa | `.claude/skills/` |
+| **Comandos** | 22 | Explicitamente — `/effective-python`, `/design-patterns`, etc. | `.claude/commands/` |
+| **Agentes** | 8 | Sob demanda — `@python-reviewer`, `@architecture-reviewer` | `.claude/agents/` |
+| **Regras** | 6 | Sempre — carregadas em toda sessão, sem gatilho | `.claude/rules/` |
+
+**Perfis** agrupam todas as quatro camadas por linguagem ou domínio:
+
+```bash
+npx booklib add --profile=python        # Python skills + comandos + agente + regras
+npx booklib add --profile=ts            # TypeScript
+npx booklib add --profile=rust          # Rust
+npx booklib add --profile=jvm           # Java + Kotlin + Spring Boot
+npx booklib add --profile=architecture  # DDD + microsserviços + design de sistemas
+npx booklib add --profile=data          # Pipelines de dados + DDIA
+npx booklib add --profile=ui            # Refactoring UI + animações + visualização
+npx booklib add --profile=lean          # Lean Startup
+npx booklib add --profile=core          # Skill router + clean code — boa opção padrão
+```
+
+---
+
+## Skills
+
+| Skill | Livro | Autor |
+|-------|-------|-------|
+| [animation-at-work](./skills/animation-at-work/) | *Animation at Work* | Rachel Nabors |
+| [clean-code-reviewer](./skills/clean-code-reviewer/) | *Código Limpo (Clean Code)* | Robert C. Martin |
+| [data-intensive-patterns](./skills/data-intensive-patterns/) | *Projetando Sistemas de Dados Intensivos* | Martin Kleppmann |
+| [data-pipelines](./skills/data-pipelines/) | *Data Pipelines Pocket Reference* | James Densmore |
+| [design-patterns](./skills/design-patterns/) | *Head First Design Patterns* | Freeman & Robson |
+| [domain-driven-design](./skills/domain-driven-design/) | *Domain-Driven Design* | Eric Evans |
+| [effective-java](./skills/effective-java/) | *Effective Java* (3ª ed) | Joshua Bloch |
+| [effective-kotlin](./skills/effective-kotlin/) | *Effective Kotlin* (2ª ed) | Marcin Moskała |
+| [effective-python](./skills/effective-python/) | *Effective Python* (3ª ed) | Brett Slatkin |
+| [effective-typescript](./skills/effective-typescript/) | *Effective TypeScript* (2ª ed) | Dan Vanderkam |
+| [kotlin-in-action](./skills/kotlin-in-action/) | *Kotlin in Action* (2ª ed) | Elizarov & Isakova |
+| [lean-startup](./skills/lean-startup/) | *A Startup Enxuta (The Lean Startup)* | Eric Ries |
+| [microservices-patterns](./skills/microservices-patterns/) | *Microsserviços Patterns* | Chris Richardson |
+| [programming-with-rust](./skills/programming-with-rust/) | *Programming with Rust* | Donis Marshall |
+| [refactoring-ui](./skills/refactoring-ui/) | *Refactoring UI* | Wathan & Schoger |
+| [rust-in-action](./skills/rust-in-action/) | *Rust in Action* | Tim McNamara |
+| [skill-router](./skills/skill-router/) | Meta-skill — roteia automaticamente para a skill ideal | booklib-ai |
+| [spring-boot-in-action](./skills/spring-boot-in-action/) | *Spring Boot in Action* | Craig Walls |
+| [storytelling-with-data](./skills/storytelling-with-data/) | *Storytelling com Dados* | Cole Nussbaumer Knaflic |
+| [system-design-interview](./skills/system-design-interview/) | *System Design Interview* | Alex Xu |
+| [using-asyncio-python](./skills/using-asyncio-python/) | *Using Asyncio in Python* | Caleb Hattingh |
+| [web-scraping-python](./skills/web-scraping-python/) | *Web Scraping with Python* | Ryan Mitchell |
+
+---
+
+## Agentes
+
+Revisores autônomos que aplicam múltiplas skills em uma única execução. Invoque com `@nome-do-agente` no Claude Code.
+
+| Agente | Modelo | Skills aplicadas |
+|--------|--------|-----------------|
+| `@booklib-reviewer` | sonnet | Roteia automaticamente — use quando não souber qual skill usar |
+| `@python-reviewer` | sonnet | effective-python · asyncio · web-scraping |
+| `@ts-reviewer` | sonnet | effective-typescript · clean-code-reviewer |
+| `@jvm-reviewer` | sonnet | effective-java · effective-kotlin · kotlin-in-action · spring-boot |
+| `@rust-reviewer` | sonnet | programming-with-rust · rust-in-action |
+| `@architecture-reviewer` | opus | domain-driven-design · microservices-patterns · system-design · data-intensive |
+| `@data-reviewer` | sonnet | data-intensive-patterns · data-pipelines |
+| `@ui-reviewer` | sonnet | refactoring-ui · storytelling-with-data · animation-at-work |
+
+---
+
+## Regras
+
+Padrões de código sempre ativos — instalados em `.claude/rules/` e carregados automaticamente em toda sessão, sem condições de gatilho.
+
+| Regra | Linguagem | Fonte |
+|-------|-----------|-------|
+| `clean-code` | todas | *Clean Code* — nomenclatura, funções, comentários, estrutura |
+| `effective-python` | Python | *Effective Python* — estilo Pythônico, tipos, tratamento de erros |
+| `effective-typescript` | TypeScript | *Effective TypeScript* — tipos, inferência, null safety |
+| `effective-java` | Java | *Effective Java* — criação, classes, genéricos, concorrência |
+| `effective-kotlin` | Kotlin | *Effective Kotlin* — segurança, corrotinas, coleções |
+| `rust` | Rust | *Programming with Rust* + *Rust in Action* — ownership, erros, idiomas |
+
+```bash
+npx booklib add --rules             # instalar todas as regras
+npx booklib add --rules=python      # instalar regras de uma linguagem
+npx booklib add --hooks             # instalar o hook de sugestão de skills
+```
+
+---
+
+## Roteamento de skills
+
+Não sabe qual skill usar? A meta-skill `skill-router` seleciona a melhor automaticamente, e o agente `@booklib-reviewer` encapsula essa lógica de ponta a ponta:
+
+```
+Usuário: "Review my order processing service"
+
+→ skill-router seleciona:
+   Principal: domain-driven-design   — design do modelo de domínio (Agregados, Objetos de Valor)
+   Secundário: microservices-patterns — fronteiras de serviço e comunicação entre serviços
+```
+
+**Benchmark:** [`benchmark/`](./benchmark/) contém uma comparação entre uma revisão de PR padrão e o skill-router roteando para duas skills. O pipeline do skill-router encontrou ~47% mais problemas únicos.
+
+---
+
+## Qualidade
+
+As skills são avaliadas com e sem a skill ativa, usando `claude-haiku-4-5` como modelo e juiz. O delta em relação ao baseline é o indicador principal.
+
+**Limites:** taxa de aprovação ≥ 80% · delta ≥ 20pp · baseline < 70%
+
+Executar avaliações: `ANTHROPIC_API_KEY=... npx booklib eval <nome>`
+
+---
+
+## Estrutura do repositório
+
+```
+booklib-ai/booklib/
+├── skills/      22 skills baseadas em livros (SKILL.md + exemplos + avaliações)
+├── agents/      8 agentes revisores autônomos
+├── commands/    22 slash commands, um por skill
+├── rules/       6 padrões de linguagem sempre ativos
+├── hooks/       Hook UserPromptSubmit do Claude Code
+└── bin/         CLI (skills.js)
+```
+
+---
+
+## Contribuindo
+
+Se você leu um livro que merece estar aqui, abra um PR:
+
+```bash
+# 1. Copie uma skill existente como template
+cp -r skills/clean-code-reviewer skills/your-book-name
+
+# 2. Edite SKILL.md, examples/before.md, examples/after.md, evals/evals.json
+
+# 3. Valide
+npx booklib check your-book-name
+```
+
+Veja o [CONTRIBUTING.md](./CONTRIBUTING.md) para o guia completo, incluindo como adicionar agentes.
+
+**Solicitações em aberto** (tag `good first issue`): [The Pragmatic Programmer](https://github.com/booklib-ai/booklib/issues/2) · [Clean Architecture](https://github.com/booklib-ai/booklib/issues/3) · [A Philosophy of Software Design](https://github.com/booklib-ai/booklib/issues/4) · [Accelerate](https://github.com/booklib-ai/booklib/issues/8) · [mais →](https://github.com/booklib-ai/booklib/issues?q=is%3Aopen+label%3A%22good+first+issue%22)
+
+---
+
+## Licença
+
+MIT

package/README.uk.md

@@ -0,0 +1,241 @@
+<p align="center">
+  <a href="README.md">English</a> · <a href="README.zh-CN.md">中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.ko.md">한국어</a> · <a href="README.pt-BR.md">Português</a> · <a href="README.uk.md">Українська</a>
+</p>
+
+<p align="center">
+  <img src="assets/logo.svg" width="100" alt="booklib-ai skills"/>
+</p>
+
+<h1 align="center">booklib</h1>
+
+<p align="center">
+  Відкрита екосистема знань для AI-агентів.<br/>
+  Навички з канонічних книг — плюс пошук по спільноті, семантичний пошук та сумісність з оркестраторами.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/booklib"><img src="https://img.shields.io/npm/v/booklib.svg" alt="npm версія"/></a>
+  <a href="https://www.npmjs.com/package/booklib"><img src="https://img.shields.io/npm/dw/booklib.svg" alt="завантаження"/></a>
+  <a href="https://github.com/booklib-ai/booklib/stargazers"><img src="https://img.shields.io/github/stars/booklib-ai/booklib?style=flat" alt="зірки"/></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="ліцензія"/></a>
+</p>
+
+<p align="center">
+  <b>22 вбудовані навички</b> &nbsp;·&nbsp; <b>258+ для відкриття</b> &nbsp;·&nbsp; <b>8 агентів</b> &nbsp;·&nbsp; <b>сумісність з obra/superpowers та ruflo</b>
+</p>
+
+---
+
+## Що це таке
+
+BookLib пакує експертні знання з канонічних книг з програмування у навички, які AI-агенти можуть застосовувати безпосередньо до вашого коду. Бібліотека містить 22 перевірені навички — і рушій відкриття, який може знаходити, індексувати та впроваджувати сотні додаткових навичок зі спільноти.
+
+**Два рівні:**
+
+| Рівень | Що робить |
+|--------|-----------|
+| **Вбудована бібліотека** | 22 навички з канонічних книг, попередньо проіндексовані, готові до використання |
+| **Екосистема відкриття** | Знаходить і завантажує навички з GitHub-репозиторіїв, реєстрів спільноти та npm-пакетів |
+
+BookLib — не статична інсталяція. Це локальний рушій знань: семантичний пошук по вмісту навичок, автоматичне впровадження контексту через хуки, рольові профілі для агентів-зграй і міст синхронізації, що робить кожну завантажену навичку доступною для будь-якого оркестратора, сумісного з Claude Code.
+
+---
+
+## Як активуються навички
+
+| Механізм | Що його запускає | Подробиці |
+|----------|-----------------|-----------|
+| **Хук PreToolUse** | Редагування файлу, що відповідає `filePattern` навички | Впроваджує лише релевантні фрагменти — точно, автоматично, без сповіщень |
+| **Інструмент Skill** | `Skill("effective-kotlin")` | Повний дамп навички на вимогу — для оркестраторів та субагентів |
+| **Пошук** | `booklib search "<концепція>"` | Семантичний векторний пошук — повертає найрелевантніші фрагменти |
+| **Аудит** | `booklib audit <навичка> <файл>` | Застосовує принципи навички до конкретного файлу |
+
+**Хук** — точний рівень. Після `booklib hooks install` він спрацьовує при кожному виклику `Read`/`Edit`/`Write`/`Bash`, зіставляє шлях до файлу з патернами навичок і непомітно впроваджує відповідні секції навичок у контекст. Редагуйте `.kt` — отримуєте effective-kotlin. Редагуйте `.py` — отримуєте effective-python.
+
+---
+
+## Швидкий старт
+
+```bash
+# Встановити CLI
+npm install -g booklib
+
+# Побудувати локальний індекс пошуку
+booklib index
+
+# Встановити хук PreToolUse — автоматично впроваджує навички при редагуванні файлів
+booklib hooks install
+
+# Пошук мудрості за концепцією
+booklib search "як обробляти null-значення в Kotlin"
+
+# Відкрити та встановити всі довірені навички (вбудовані + спільноти)
+booklib setup
+
+# Синхронізувати всі завантажені навички → доступні для Skill tool і оркестраторів
+booklib sync
+```
+
+---
+
+## Вбудовані навички
+
+| Навичка | Книга | Автор |
+|---------|-------|-------|
+| [animation-at-work](./skills/animation-at-work/) | *Animation at Work* | Rachel Nabors |
+| [clean-code-reviewer](./skills/clean-code-reviewer/) | *Clean Code* | Robert C. Martin |
+| [data-intensive-patterns](./skills/data-intensive-patterns/) | *Designing Data-Intensive Applications* | Martin Kleppmann |
+| [data-pipelines](./skills/data-pipelines/) | *Data Pipelines Pocket Reference* | James Densmore |
+| [design-patterns](./skills/design-patterns/) | *Head First Design Patterns* | Freeman & Robson |
+| [domain-driven-design](./skills/domain-driven-design/) | *Domain-Driven Design* | Eric Evans |
+| [effective-java](./skills/effective-java/) | *Effective Java* (3-є вид.) | Joshua Bloch |
+| [effective-kotlin](./skills/effective-kotlin/) | *Effective Kotlin* (2-є вид.) | Marcin Moskała |
+| [effective-python](./skills/effective-python/) | *Effective Python* (3-є вид.) | Brett Slatkin |
+| [effective-typescript](./skills/effective-typescript/) | *Effective TypeScript* (2-є вид.) | Dan Vanderkam |
+| [kotlin-in-action](./skills/kotlin-in-action/) | *Kotlin in Action* (2-є вид.) | Elizarov & Isakova |
+| [lean-startup](./skills/lean-startup/) | *The Lean Startup* | Eric Ries |
+| [microservices-patterns](./skills/microservices-patterns/) | *Microservices Patterns* | Chris Richardson |
+| [programming-with-rust](./skills/programming-with-rust/) | *Programming with Rust* | Donis Marshall |
+| [refactoring-ui](./skills/refactoring-ui/) | *Refactoring UI* | Wathan & Schoger |
+| [rust-in-action](./skills/rust-in-action/) | *Rust in Action* | Tim McNamara |
+| [skill-router](./skills/skill-router/) | Мета-навичка — автоматично маршрутизує до правильної навички | booklib-ai |
+| [spring-boot-in-action](./skills/spring-boot-in-action/) | *Spring Boot in Action* | Craig Walls |
+| [storytelling-with-data](./skills/storytelling-with-data/) | *Storytelling with Data* | Cole Nussbaumer Knaflic |
+| [system-design-interview](./skills/system-design-interview/) | *System Design Interview* | Alex Xu |
+| [using-asyncio-python](./skills/using-asyncio-python/) | *Using Asyncio in Python* | Caleb Hattingh |
+| [web-scraping-python](./skills/web-scraping-python/) | *Web Scraping with Python* | Ryan Mitchell |
+
+---
+
+## Відкриття навичок
+
+BookLib може знаходити та індексувати навички поза вбудованим набором. Налаштуйте джерела у `booklib.config.json`:
+
+```json
+{
+  "sources": [
+    { "type": "registry", "trusted": true },
+    { "type": "manifest", "url": "./community/registry.json", "trusted": true },
+    { "type": "github-skills-dir", "repo": "obra/superpowers", "dir": "skills", "branch": "main", "trusted": true },
+    { "type": "github-org", "org": "your-org" },
+    { "type": "npm-scope", "scope": "@your-scope" }
+  ]
+}
+```
+
+```bash
+booklib discover              # перелік доступних навичок з усіх джерел
+booklib discover --refresh    # примусове повторне сканування
+booklib fetch naming-cheatsheet    # завантажити конкретну навичку
+booklib setup                 # завантажити всі довірені навички одразу
+```
+
+`"trusted": true` — навичка встановлюється автоматично через `booklib setup`. Ненадійні джерела видимі, але потребують явного підтвердження через `booklib fetch <назва>`.
+
+---
+
+## Сумісність з оркестраторами
+
+Після `booklib sync` кожна завантажена навичка знаходиться за шляхом `~/.claude/skills/<назва>/SKILL.md` — звідти читає нативний Skill tool Claude Code.
+
+```bash
+booklib sync    # записати всі завантажені навички до ~/.claude/skills/
+```
+
+| Оркестратор | Встановлення | Навички доступні через |
+|---|---|---|
+| [obra/superpowers](https://github.com/obra/superpowers) | `/plugin install superpowers` | Skill tool — доступний у кожній сесії |
+| [ruflo](https://github.com/ruvnet/ruflo) | `npm install -g ruflo` | Skill tool — доступний у кожній сесії |
+
+---
+
+## Зграї та рольові профілі
+
+```bash
+booklib profile reviewer     # навички для агента-рецензента коду
+booklib profile security     # навички для аудитора безпеки
+booklib profile architect    # навички для агента системного проєктування
+```
+
+Ролі: `architect` · `coder` · `reviewer` · `tester` · `security` · `frontend` · `optimizer` · `devops` · `ai-engineer` · `manager`
+
+```bash
+booklib swarm-config audit      # карта навичок для тригера аудиту
+booklib swarm-config feature    # architect → coder → reviewer → tester
+booklib swarm-config            # перелік усіх налаштованих тригерів
+```
+
+---
+
+## Агенти
+
+| Агент | Модель | Застосовані навички |
+|-------|--------|---------------------|
+| `@booklib-reviewer` | sonnet | Автоматична маршрутизація до найкращої навички |
+| `@python-reviewer` | sonnet | effective-python · asyncio · web-scraping |
+| `@ts-reviewer` | sonnet | effective-typescript · clean-code-reviewer |
+| `@jvm-reviewer` | sonnet | effective-java · effective-kotlin · kotlin-in-action · spring-boot |
+| `@rust-reviewer` | sonnet | programming-with-rust · rust-in-action |
+| `@architecture-reviewer` | opus | domain-driven-design · microservices-patterns · system-design · data-intensive |
+| `@data-reviewer` | sonnet | data-intensive-patterns · data-pipelines |
+| `@ui-reviewer` | sonnet | refactoring-ui · storytelling-with-data · animation-at-work |
+
+---
+
+## Семантичний пошук та аудит
+
+```bash
+booklib search "як обробляти null-значення в Kotlin"
+booklib search "event sourcing vs CQRS" --role=architect
+booklib audit effective-kotlin src/PaymentService.kt
+booklib scan    # теплова карта — порушення по навичках у всьому проєкті
+```
+
+---
+
+## Передача сесій
+
+```bash
+booklib save-state --goal="..." --next="..." --progress="..."
+booklib resume
+booklib recover-auto    # автовідновлення з останньої сесії або git-історії
+```
+
+Координація між агентами:
+
+```bash
+booklib sessions-list
+booklib sessions-merge auth-session,payment-session combined
+booklib sessions-lineage main feature-x "розгалужено для роботи з auth"
+booklib sessions-compare python-audit,kotlin-audit src/auth.ts comparison
+```
+
+---
+
+## Якість
+
+Кожна вбудована навичка оцінюється шляхом запиту до моделі переглянути код з навичкою та без неї. **Дельта** = відсоток проходження з навичкою мінус без неї — вона вимірює, наскільки навичка дійсно змінює поведінку моделі.
+
+Порогові значення: відсоток проходження ≥ 80% · дельта ≥ 20пп · базовий рівень < 70%
+
+---
+
+## Внесок у проєкт
+
+Щоб додати вбудовану навичку:
+
+```bash
+cp -r skills/clean-code-reviewer skills/назва-вашої-книги
+# Відредагуйте SKILL.md, examples/before.md, examples/after.md, evals/evals.json
+npx booklib check назва-вашої-книги
+```
+
+Щоб додати навичку спільноти — відредагуйте `community/registry.json` та відкрийте PR.
+
+Детальніше: [CONTRIBUTING.md](./CONTRIBUTING.md)
+
+---
+
+## Ліцензія
+
+MIT

package/README.zh-CN.md

@@ -0,0 +1,198 @@
+<p align="center">
+  <a href="README.md">English</a> · <a href="README.zh-CN.md">中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.ko.md">한국어</a> · <a href="README.pt-BR.md">Português</a> · <a href="README.uk.md">Українська</a>
+</p>
+
+<p align="center">
+  <img src="assets/logo.svg" width="100" alt="booklib-ai skills"/>
+</p>
+
+<h1 align="center">booklib</h1>
+
+<p align="center">
+  基于经典书籍的 AI 代理技能 — 适用于 Claude Code、Cursor、Copilot 和 Windsurf。<br/>
+  将权威书籍中的专家知识，打包为技能、命令、代理和规则。
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/booklib"><img src="https://img.shields.io/npm/v/booklib.svg" alt="npm 版本"/></a>
+  <a href="https://www.npmjs.com/package/booklib"><img src="https://img.shields.io/npm/dw/booklib.svg" alt="下载量"/></a>
+  <a href="https://github.com/booklib-ai/booklib/stargazers"><img src="https://img.shields.io/github/stars/booklib-ai/booklib?style=flat" alt="Star 数"/></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="许可证"/></a>
+</p>
+
+<p align="center">
+  <b>22 个技能</b> &nbsp;·&nbsp; <b>8 个代理</b> &nbsp;·&nbsp; <b>6 条规则</b> &nbsp;·&nbsp; <b>22 个命令</b> &nbsp;·&nbsp; <b>9 个配置文件</b>
+</p>
+
+---
+
+## 这是什么
+
+每个技能将某本编程书籍中的核心实践，打包成 AI 代理可以直接应用于代码的结构化指令。不再是泛泛的"成为一名好程序员"提示词，而是来自《Effective Java》、《Designing Data-Intensive Applications》和《Clean Code》等权威书籍的针对性专业知识。
+
+```bash
+# 全局安装所有内容
+npx booklib add --all --global
+
+# 或只安装适合你技术栈的内容
+npx booklib add --profile=ts --global       # TypeScript
+npx booklib add --profile=python --global   # Python
+npx booklib add --profile=rust --global     # Rust
+npx booklib add --profile=jvm --global      # Java / Kotlin
+```
+
+## 四个层级
+
+| 层级 | 数量 | 激活方式 | 安装路径 |
+|------|------|---------|---------|
+| **技能** | 22 | 自动，根据文件类型和任务上下文触发 | `.claude/skills/` |
+| **命令** | 22 | 显式调用 — `/effective-python`、`/design-patterns` 等 | `.claude/commands/` |
+| **代理** | 8 | 按需调用 — `@python-reviewer`、`@architecture-reviewer` | `.claude/agents/` |
+| **规则** | 6 | 始终生效 — 每次会话自动加载，无需触发条件 | `.claude/rules/` |
+
+**配置文件**按语言或领域捆绑以上所有层级：
+
+```bash
+npx booklib add --profile=python        # Python 技能 + 命令 + 代理 + 规则
+npx booklib add --profile=ts            # TypeScript
+npx booklib add --profile=rust          # Rust
+npx booklib add --profile=jvm           # Java + Kotlin + Spring Boot
+npx booklib add --profile=architecture  # DDD + 微服务 + 系统设计
+npx booklib add --profile=data          # 数据管道 + DDIA
+npx booklib add --profile=ui            # Refactoring UI + 动画 + 数据可视化
+npx booklib add --profile=lean          # 精益创业
+npx booklib add --profile=core          # 技能路由器 + 代码整洁 — 推荐默认值
+```
+
+---
+
+## 技能列表
+
+| 技能 | 书籍 | 作者 |
+|------|------|------|
+| [animation-at-work](./skills/animation-at-work/) | *Animation at Work* | Rachel Nabors |
+| [clean-code-reviewer](./skills/clean-code-reviewer/) | *Clean Code（代码整洁之道）* | Robert C. Martin |
+| [data-intensive-patterns](./skills/data-intensive-patterns/) | *Designing Data-Intensive Applications（数据密集型应用系统设计）* | Martin Kleppmann |
+| [data-pipelines](./skills/data-pipelines/) | *Data Pipelines Pocket Reference* | James Densmore |
+| [design-patterns](./skills/design-patterns/) | *Head First Design Patterns* | Freeman & Robson |
+| [domain-driven-design](./skills/domain-driven-design/) | *Domain-Driven Design（领域驱动设计）* | Eric Evans |
+| [effective-java](./skills/effective-java/) | *Effective Java（Effective Java 中文版）* (第3版) | Joshua Bloch |
+| [effective-kotlin](./skills/effective-kotlin/) | *Effective Kotlin* (第2版) | Marcin Moskała |
+| [effective-python](./skills/effective-python/) | *Effective Python（Effective Python 中文版）* (第3版) | Brett Slatkin |
+| [effective-typescript](./skills/effective-typescript/) | *Effective TypeScript* (第2版) | Dan Vanderkam |
+| [kotlin-in-action](./skills/kotlin-in-action/) | *Kotlin in Action* (第2版) | Elizarov & Isakova |
+| [lean-startup](./skills/lean-startup/) | *The Lean Startup（精益创业）* | Eric Ries |
+| [microservices-patterns](./skills/microservices-patterns/) | *Microservices Patterns（微服务架构设计模式）* | Chris Richardson |
+| [programming-with-rust](./skills/programming-with-rust/) | *Programming with Rust* | Donis Marshall |
+| [refactoring-ui](./skills/refactoring-ui/) | *Refactoring UI* | Wathan & Schoger |
+| [rust-in-action](./skills/rust-in-action/) | *Rust in Action* | Tim McNamara |
+| [skill-router](./skills/skill-router/) | 元技能 — 自动路由到最合适的技能 | booklib-ai |
+| [spring-boot-in-action](./skills/spring-boot-in-action/) | *Spring Boot in Action* | Craig Walls |
+| [storytelling-with-data](./skills/storytelling-with-data/) | *Storytelling with Data（用数据讲故事）* | Cole Nussbaumer Knaflic |
+| [system-design-interview](./skills/system-design-interview/) | *System Design Interview（系统设计面试）* | Alex Xu |
+| [using-asyncio-python](./skills/using-asyncio-python/) | *Using Asyncio in Python* | Caleb Hattingh |
+| [web-scraping-python](./skills/web-scraping-python/) | *Web Scraping with Python* | Ryan Mitchell |
+
+---
+
+## 代理
+
+自主审查器，在一次执行中应用多个技能。在 Claude Code 中使用 `@代理名称` 调用。
+
+| 代理 | 模型 | 应用的技能 |
+|------|------|-----------|
+| `@booklib-reviewer` | sonnet | 自动路由到最佳技能 — 不确定时使用此代理 |
+| `@python-reviewer` | sonnet | effective-python · asyncio · web-scraping |
+| `@ts-reviewer` | sonnet | effective-typescript · clean-code-reviewer |
+| `@jvm-reviewer` | sonnet | effective-java · effective-kotlin · kotlin-in-action · spring-boot |
+| `@rust-reviewer` | sonnet | programming-with-rust · rust-in-action |
+| `@architecture-reviewer` | opus | domain-driven-design · microservices-patterns · system-design · data-intensive |
+| `@data-reviewer` | sonnet | data-intensive-patterns · data-pipelines |
+| `@ui-reviewer` | sonnet | refactoring-ui · storytelling-with-data · animation-at-work |
+
+---
+
+## 规则
+
+始终生效的编码规范 — 安装到 `.claude/rules/`，每次会话自动加载，无需任何触发条件。
+
+| 规则 | 语言 | 来源 |
+|------|------|------|
+| `clean-code` | 所有语言 | *Clean Code* — 命名、函数、注释、结构 |
+| `effective-python` | Python | *Effective Python* — Pythonic 风格、类型、错误处理 |
+| `effective-typescript` | TypeScript | *Effective TypeScript* — 类型、推断、空值安全 |
+| `effective-java` | Java | *Effective Java* — 创建、类、泛型、并发 |
+| `effective-kotlin` | Kotlin | *Effective Kotlin* — 安全性、协程、集合 |
+| `rust` | Rust | *Programming with Rust* + *Rust in Action* — 所有权、错误、惯用模式 |
+
+```bash
+npx booklib add --rules             # 安装所有规则
+npx booklib add --rules=python      # 安装单个语言的规则
+npx booklib add --hooks             # 安装技能建议钩子
+```
+
+---
+
+## 技能路由
+
+不确定用哪个技能？`skill-router` 元技能会自动选择最佳匹配，而 `@booklib-reviewer` 代理则端到端地封装了整个流程：
+
+```
+用户："Review my order processing service"
+
+→ skill-router 选择：
+   主要：   domain-driven-design   — 领域模型设计（聚合根、值对象）
+   次要：   microservices-patterns — 服务边界和服务间通信
+```
+
+**基准测试：** [`benchmark/`](./benchmark/) 展示了标准 PR 审查与 skill-router 路由到两个技能的对比。skill-router 管道多发现了约 47% 的独特问题。
+
+---
+
+## 质量评估
+
+每个技能都在启用和不启用的情况下分别运行评估，使用 `claude-haiku-4-5` 作为模型和评判者。与基线的差值（delta）是关键指标。
+
+**阈值：** 通过率 ≥ 80% · delta ≥ 20pp · 基线 < 70%
+
+运行评估：`ANTHROPIC_API_KEY=... npx booklib eval <技能名>`
+
+---
+
+## 仓库结构
+
+```
+booklib-ai/booklib/
+├── skills/      22 个基于书籍的技能（SKILL.md + 示例 + 评估）
+├── agents/      8 个自主审查代理
+├── commands/    22 个斜杠命令，每个技能一个
+├── rules/       6 条始终生效的语言规范
+├── hooks/       Claude Code UserPromptSubmit 钩子
+└── bin/         CLI（skills.js）
+```
+
+---
+
+## 参与贡献
+
+如果你读过一本适合加入的书籍，欢迎提交 PR：
+
+```bash
+# 1. 基于现有技能创建新技能
+cp -r skills/clean-code-reviewer skills/your-book-name
+
+# 2. 编辑 SKILL.md、examples/before.md、examples/after.md、evals/evals.json
+
+# 3. 验证
+npx booklib check your-book-name
+```
+
+完整指南请参阅 [CONTRIBUTING.md](./CONTRIBUTING.md)，包括如何添加代理。
+
+**待认领的书籍**（标记为 `good first issue`）：[The Pragmatic Programmer](https://github.com/booklib-ai/booklib/issues/2) · [Clean Architecture](https://github.com/booklib-ai/booklib/issues/3) · [A Philosophy of Software Design](https://github.com/booklib-ai/booklib/issues/4) · [Accelerate](https://github.com/booklib-ai/booklib/issues/8) · [更多 →](https://github.com/booklib-ai/booklib/issues?q=is%3Aopen+label%3A%22good+first+issue%22)
+
+---
+
+## 许可证
+
+MIT

package/SECURITY.md

@@ -0,0 +1,9 @@
+# Security Policy
+
+## Reporting a Vulnerability
+
+Skills in this repository are markdown instruction files — they contain no executable code that runs on install. However, if you discover a skill that contains malicious instructions or attempts to exfiltrate data, please report it responsibly.
+
+**Do not open a public issue.** Instead, report security concerns via [GitHub's private vulnerability reporting](https://github.com/booklib-ai/booklib/security/advisories/new).
+
+We will respond within 48 hours and issue a fix promptly.