Brian
8b4da79161
* refactor: group v6 deprecation shims into v6-shims folders Move the nine backward-compatibility forwarders into dedicated v6-shims/ folders so the deprecation set is visible in one place and can later be made an install-time include/exclude option before removal at the v7 cut. core-skills/v6-shims/: the five review and editorial husks bmm-skills/v6-shims/: the four PRD and architecture husks Grouping only — no content changes. The installer discovers skills by a recursive walk and installs each under its own name, so installed paths and skill IDs are unchanged. Verified by diffing a full headless install against main: identical .claude/skills listing and file content, and an identical _bmad tree. The only delta is the path column in skill-manifest.csv, which now records the new source location. External module repos (gds, loop, tea, bmb, os-utils) and enterprise users still invoke these IDs, so they continue to ship by default. * refactor(core): merge editorial review into bmad-review as lenses All reviews are reviews. bmad-editorial-review's two passes become two more bmad-review lenses, leaving one lens runtime instead of two skills with overlapping trigger descriptions — "review this document" matched both before, so which one ran was close to arbitrary. Lenses now declare what they apply to. applies_to is "code", "docs", or "any", and is the first filter on a default review; `when` still refines it in prose. adversarial stays "any" — it is a stance, not a subject- matter method, and is the lens a code/doc skill split could not have placed. edge-case-hunter's `when` was "always", which is why it would have fired on prose; it now gates on having a behavioral surface. A lens may also declare `after`, naming a lens it builds on: prose runs on top of the structure findings, as it always has. The runner announces the plan, runs the independent lenses (in parallel via subagents when available), then the dependent ones on their results. Lens wording is unchanged. The three code lens files are byte-identical; the editorial passes moved verbatim into references/lens-structure.md, references/lens-prose.md, and references/editorial-common.md, which carries what both share — the content-sacrosanct rule, style guide handling, reader calibration, and the findings table. That material used to load unconditionally; as lenses it loads just-in-time, so a code review no longer pays for it. bmad-editorial-review becomes the sixth v6 shim, forwarding with the structure and prose lenses named. It keeps its customize.toml so existing team and user overrides still resolve, and forwards them as pre-resolved values. The four other husks now name bmad-review and their lens explicitly. Each still pins its own legacy output contract. bmm's four document skills point doc_standards at the merged skill with named lenses. Docs updated across all five locales. Core is 7 skills. A headless install produces the same 47-skill set as main, with all six shims resolving. * fix(core): honor forwarded customization and de-hardcode the lens set Follow-up to the editorial/review merge, from review of #2608. Contract fixes: - bmad-review gains a Forwarded activation clause matching bmad-prd and bmad-architecture, so the bmad-editorial-review shim's pre-resolved fields are honored instead of being silently overwritten by the skill's own customize.toml. Existing bmad-editorial-review overrides resolve again. - The announce step is skipped when a caller pinned an exact output contract, and a forwarder's contract now governs everything emitted rather than the findings block alone. The edge-case (raw JSON) and verification-gap (one exact line) forwarders no longer get a prose line prepended. Lens set is no longer hardcoded: - The description and body intro present the shipped lenses as examples and point at whatever {workflow.lenses} resolves to. Docs carry a matching note in all five locales. Also: - Document the `lenses=` directive form in Inputs and in the four bmm doc_standards comments that use it. - module-help.csv review row rewritten to the house "Use to..." convention, naming the reviewable content types and the situations that should trigger a suggestion. - Shim customize.toml trimmed to a lean legacy-key surface with empty defaults, so unset keys fall through to bmad-review and project-context.md is no longer loaded twice. - Redundant `when` clauses dropped where applies_to already encodes the rule. - Core skill count corrected to seven/four and the edge-case applies_to cell fixed to match its actual value, across all five locales.
13 KiB
title, description, sidebar
| title | description | sidebar | ||
|---|---|---|---|---|
| Základní nástroje | Reference vestavěných skills základního modulu. |
|
Každá instalace BMad zahrnuje základní modul — malou sadu skills, které fungují napříč všemi projekty, všemi moduly a všemi fázemi. Tato stránka pokrývá těchto sedm základních skills: čtyři jádrové nástroje plus tři myšlenkové skills (brainstorming, forge idea, party mode).
:::tip[Rychlá cesta]
Spusťte jakýkoli nástroj zadáním jeho názvu skillu (např. bmad-help) ve vašem IDE. Nevyžaduje relaci agenta.
:::
Přehled
Základní modul (vždy nainstalován):
| Nástroj | Účel |
|---|---|
bmad-help |
Kontextové poradenství, co dělat dál |
bmad-advanced-elicitation |
Iterativní zdokonalování LLM výstupu |
bmad-review |
Revize z více perspektiv — adversariální, hraniční případy a mezery ve verifikaci pro kód; struktura a text pro dokumenty |
bmad-customize |
Vytváření a ověřování přizpůsobení BMad |
Myšlenkové skills:
| Nástroj | Účel |
|---|---|
bmad-brainstorming |
Facilitace interaktivních brainstormingových sezení |
bmad-forge-idea |
Zátěžový test nápadu, dokud se nezpevní, nepotvrdí, nebo levně nezemře |
bmad-party-mode |
Orchestrace skupinových diskuzí více agentů |
:::note[Přesunuto a odstraněno]
bmad-spec se nyní dodává s modulem BMM jako plánovací workflow Fáze 2 — viz Mapa workflow. Utility bmad-shard-doc a bmad-index-docs byly odstraněny. Dřívější skills bmad-editorial-review, bmad-editorial-review-prose, bmad-editorial-review-structure, bmad-review-adversarial-general, bmad-review-edge-case-hunter a bmad-review-verification-gap jsou všechny sloučeny do bmad-review, jehož redakční perspektivy nahrazují samostatný redakční skill; staré identifikátory se stále rozliší přes přesměrování kvůli kompatibilitě.
:::
bmad-help
Váš inteligentní průvodce tím, co přijde dál. — Zkoumá stav vašeho projektu, detekuje, co bylo uděláno, a doporučuje další povinný nebo volitelný krok.
Použijte když:
- Dokončili jste workflow a chcete vědět, co dál
- Jste noví v BMad a potřebujete orientaci
- Jste uvízlí a chcete kontextovou radu
- Nainstalovali jste nové moduly a chcete vidět, co je dostupné
Jak to funguje:
- Skenuje projekt pro existující artefakty (PRD, architektura, stories atd.)
- Detekuje nainstalované moduly a dostupné workflow
- Doporučuje další kroky v pořadí priority — nejprve povinné, pak volitelné
- Prezentuje každé doporučení s příkazem skillu a stručným popisem
Vstup: Volitelný dotaz v přirozeném jazyce (např. bmad-help I have a SaaS idea, where do I start?)
Výstup: Prioritizovaný seznam doporučených dalších kroků s příkazy skills
bmad-advanced-elicitation
Přiměje LLM přehodnotit, zdokonalit a vylepšit svůj nedávný výstup. — Sdílený zdokonalovací checkpoint BMad: ostatní skills jej vyvolávají při přirozených pauzách a vy jej můžete zavolat přímo na cokoli nedávného v konverzaci.
Použijte když:
- LLM výstup působí povrchně nebo genericky
- Chcete prozkoumat téma z více analytických úhlů
- Zdokonalujete kritický dokument a chcete hlubší myšlení
- Chcete známou metodu jménem — sokratovská, první principy, pre-mortem, red team
Jak to funguje:
- Cílí na nejnovější výstup v konverzaci, pokud jej nenasměrujete jinam
- Nabídne krátké menu elicitačních metod nejlépe odpovídajících obsahu
- Aplikuje zvolené metody na cíl
- Vrátí vylepšenou verzi, aby vyvolávající tok pokračoval tam, kde se zastavil
Vstup: Nedávný výstup ke zdokonalení (výchozí), nebo jakýkoli obsah, na který ukážete; volitelně pojmenovaná metoda
Výstup: Vylepšená verze obsahu s aplikovanými zlepšeními
bmad-review
Revize z více perspektiv nad jakýmkoli diffem, dokumentem nebo artefaktem. — Spouští revizní perspektivy — každou s vlastní metodou a postojem — a hlásí každý nález v jednom kanonickém tvaru. Nula nálezů je platný výsledek; nikdy nedoplňuje, aby vypadal důkladně. Každá perspektiva deklaruje, na co se vztahuje: diff vyvolá perspektivy pro kód, dokument ty redakční.
Dodávané perspektivy:
| Perspektiva | Vztahuje se na | Metoda |
|---|---|---|
| Adversariální | Jakýkoli obsah | Skeptická revize předpokládající existenci problémů — hledá, co chybí, ne jen co je špatně |
| Hraniční případy | Jakýkoli obsah | Projde každou větvící se cestu a hraniční podmínku v obsahu, který definuje chování |
| Mezery ve verifikaci | Kód | Hledá změněné chování, které by mohlo regredovat, aniž by to spolehlivá verifikace zachytila |
| Struktura | Dokumenty | Navrhuje škrty, sloučení, přesuny a zhuštění — slouží tvar dokumentu jeho účelu? |
| Text | Dokumenty | Redakčně upravuje komunikační problémy, které brání porozumění |
Obě redakční perspektivy považují obsah za nedotknutelný: nikdy nezpochybňují vaše myšlenky, pouze jejich uspořádání a vyjádření, a navrhují místo toho, aby zasahovaly. Je-li vybráno obojí, textová perspektiva běží nad nálezy strukturní.
Sada není pevná: přepis v customize.toml může perspektivy přidat nebo nahradit dodávané a revize spustí ty, které se skutečně vyhodnotí.
Použijte když:
- Potřebujete zajištění kvality před finalizací výstupu
- Chcete vyčerpávající pokrytí hraničních případů kódu nebo logiky
- Chcete vědět, zda je změna dostatečně ověřena
- Napsali jste dokument a chcete jej zpřesnit a vyladit
- Chcete zkrátit délku při zachování srozumitelnosti
Jak to funguje:
- Načte obsah, identifikuje jeho typ — diff, soubor, funkce nebo dokument — a zda jde o kód či dokumentaci
- Vybere perspektivy: ty, které pojmenujete, nebo každou povolenou perspektivu, jejíž použitelnost a podmínky obsahu odpovídají
- Oznámí plán — které perspektivy poběží a které staví na nálezech jiné
- Spustí nezávislé perspektivy — paralelně přes subagenty, pokud to platforma podporuje — a poté ty závislé
- Sestaví jeden seznam nálezů; překryv mezi perspektivami je signál, ne duplikace
Vstup:
content(povinné) — Diff, větev, nezakomitované změny, soubor, specifikace, story nebo jakýkoli dokumentlenses(volitelné) — jeden nebo více kódů či názvů perspektiv; výchozí je plná revizealso_consider(volitelné) — Další oblasti k zváženístyle_guide/reader_type(volitelné, redakční perspektivy) — projektový průvodce stylem ahumans(výchozí) nebollm
Výstup: JSON pole nálezů a/nebo markdown report seskupený podle perspektiv. Vlastní perspektivy lze přidat — a dodávané doladit či vypnout — přes customize.toml skillu
bmad-customize
Vytváření a ověřování přizpůsobení. — Pomůže vám změnit chování nainstalovaného BMad agenta nebo workflow bez ručního psaní TOML.
Použijte když:
- Chcete změnit chování agenta nebo workflow
- Potřebujete přidat trvalé fakty, aktivační hooky nebo vlastní položky menu
- Chcete, aby byl správný rozsah přepisu vybrán a ověřen automaticky
Jak to funguje:
- Skenuje nainstalované BMad skills pro přizpůsobitelné plochy
- Vybere správný rozsah pro požadovanou změnu
- Zapíše přepisové soubory pod
_bmad/custom/ - Ověří sloučenou konfiguraci
Vstup: Popis požadovaného přizpůsobení v přirozeném jazyce
Výstup: TOML přepisové soubory pod _bmad/custom/. Podrobný návod viz Jak přizpůsobit BMad
Myšlenkové skills
Tři skills níže doplňují základní modul — obecné myšlenkové nástroje, o které se může opřít kterákoli fáze či modul.
bmad-brainstorming
Generování různorodých nápadů prostřednictvím interaktivních kreativních technik. — Facilitované brainstormingové sezení, které načítá osvědčené ideační metody z knihovny technik a vede vás k 100+ nápadům před organizací.
Použijte když:
- Začínáte nový projekt a potřebujete prozkoumat problémový prostor
- Jste uvízlí s generováním nápadů a potřebujete strukturovanou kreativitu
- Chcete použít osvědčené ideační frameworky (SCAMPER, reverzní brainstorming atd.)
Jak to funguje:
- Nastaví brainstormingové sezení s vaším tématem
- Načte kreativní techniky z knihovny metod
- Provede vás technikou za technikou, generuje nápady
- Aplikuje anti-bias protokol — mění kreativní doménu každých 10 nápadů
Vstup: Téma brainstormingu nebo formulace problému, volitelný kontextový soubor
Výstup: samostatný brainstorm.html jako památka na sezení, volitelný brainstorm-intent.md pro navazující skills a záznam sezení .memlog.md
:::note[Cíl množství] Kouzlo se děje v nápadech 50–100. Workflow povzbuzuje generování 100+ nápadů před organizací. :::
bmad-forge-idea
Zátěžový test nápadu, dokud se nezpevní, nepotvrdí, nebo levně nezemře. — Adversariální tazatel žene napůl zformovaný nápad otázku po otázce, do každého větvení přivádí dvě postavy, dokud to, co přežije, není něco, na čem můžete s přesvědčením stavět.
Použijte když:
- Máte nápad a chcete jej otestovat, než do něj investujete
- Chcete upřímný pohled na to, zda jej zabít
- Potřebujete myšlenkového partnera, který se vzepře, místo aby souhlasil
Jak to funguje:
- Předem stanoví cíl a podle něj směruje dotazování
- Pracuje otázku po otázce v pořadí závislostí a předkládá doporučenou odpověď, proti které se lze vymezit
- Do každého větvení přivádí dva hlasy — jeden z vaší nainstalované sestavy, jeden vyvolaný tématem
- Zpochybňuje mlhavé pojmy a testuje tvrzení proti materiálu existujícího projektu
- Končí jako Zpevněný, Zabitý nebo Jasnější, se samostatným reportem, který si můžete ponechat
Vstup: Nápad z jakékoli domény — funkce, byznys model, výzkumná hypotéza, životní rozhodnutí
Výstup: Destilát forged-idea.md, když se nápad zpevní (volitelné), plus forge-report.html z každého běhu
bmad-party-mode
Orchestrace skupinových diskuzí více agentů. — Načte všechny nainstalované BMad agenty a facilituje přirozenou konverzaci, kde každý agent přispívá svou unikátní odborností a osobností.
Použijte když:
- Potřebujete více expertních perspektiv na rozhodnutí
- Chcete, aby agenti zpochybňovali předpoklady ostatních
- Zkoumáte složité téma překračující více domén
Jak to funguje:
- Načte manifest agentů se všemi nainstalovanými osobnostmi
- Analyzuje vaše téma a vybere 2–3 nejrelevantnější agenty
- Agenti se střídají v přispívání, s přirozenou kříženou diskuzí a nesouhlasy
- Rotuje účast agentů pro zajištění různorodých perspektiv
- Ukončete pomocí
goodbye,end partyneboquit
Vstup: Diskuzní téma nebo otázka, s volitelnou specifikací person
Výstup: Real-time multi-agentní konverzace s udržovanými osobnostmi agentů