From b03ef49a5c1fc88fcf8016defaf8b6e4ae87cc7e Mon Sep 17 00:00:00 2001 From: Sergio Alexander Florez Galeano Date: Thu, 16 Jul 2026 15:04:13 +0000 Subject: [PATCH 1/7] docs: document AI Diff Reviewer as fifth shipping addon Add the dedicated kit catalog page (/kit/ai-diff-reviewer) and update spec/addons, init, kit, quickstart, and UI strings across all 17 languages so onboarding and the site catalog match deepworkplan-skill v2.17.0. Co-authored-by: Cursor --- src/content/kit/de/ai-diff-reviewer.md | 61 ++++++++++++++++++++++++++ src/content/kit/de/dailybot.md | 2 +- src/content/kit/en/ai-diff-reviewer.md | 61 ++++++++++++++++++++++++++ src/content/kit/en/dailybot.md | 2 +- src/content/kit/es/ai-diff-reviewer.md | 61 ++++++++++++++++++++++++++ src/content/kit/es/dailybot.md | 2 +- src/content/kit/fr/ai-diff-reviewer.md | 61 ++++++++++++++++++++++++++ src/content/kit/fr/dailybot.md | 2 +- src/content/kit/hi/ai-diff-reviewer.md | 61 ++++++++++++++++++++++++++ src/content/kit/hi/dailybot.md | 2 +- src/content/kit/id/ai-diff-reviewer.md | 61 ++++++++++++++++++++++++++ src/content/kit/id/dailybot.md | 2 +- src/content/kit/it/ai-diff-reviewer.md | 61 ++++++++++++++++++++++++++ src/content/kit/it/dailybot.md | 2 +- src/content/kit/ja/ai-diff-reviewer.md | 61 ++++++++++++++++++++++++++ src/content/kit/ja/dailybot.md | 2 +- src/content/kit/ko/ai-diff-reviewer.md | 61 ++++++++++++++++++++++++++ src/content/kit/ko/dailybot.md | 2 +- src/content/kit/pl/ai-diff-reviewer.md | 61 ++++++++++++++++++++++++++ src/content/kit/pl/dailybot.md | 2 +- src/content/kit/pt/ai-diff-reviewer.md | 61 ++++++++++++++++++++++++++ src/content/kit/pt/dailybot.md | 2 +- src/content/kit/ru/ai-diff-reviewer.md | 61 ++++++++++++++++++++++++++ src/content/kit/ru/dailybot.md | 2 +- src/content/kit/th/ai-diff-reviewer.md | 61 ++++++++++++++++++++++++++ src/content/kit/th/dailybot.md | 2 +- src/content/kit/tr/ai-diff-reviewer.md | 61 ++++++++++++++++++++++++++ src/content/kit/tr/dailybot.md | 2 +- src/content/kit/uk/ai-diff-reviewer.md | 61 ++++++++++++++++++++++++++ src/content/kit/uk/dailybot.md | 2 +- src/content/kit/vi/ai-diff-reviewer.md | 61 ++++++++++++++++++++++++++ src/content/kit/vi/dailybot.md | 2 +- src/content/kit/zh/ai-diff-reviewer.md | 61 ++++++++++++++++++++++++++ src/content/kit/zh/dailybot.md | 2 +- src/content/pages/de/init.md | 6 ++- src/content/pages/de/kit.md | 1 + src/content/pages/de/quickstart.md | 4 +- src/content/pages/en/init.md | 12 +++-- src/content/pages/en/kit.md | 3 +- src/content/pages/en/quickstart.md | 4 +- src/content/pages/es/init.md | 8 ++-- src/content/pages/es/kit.md | 1 + src/content/pages/es/quickstart.md | 4 +- src/content/pages/fr/init.md | 6 ++- src/content/pages/fr/kit.md | 1 + src/content/pages/fr/quickstart.md | 4 +- src/content/pages/hi/init.md | 3 +- src/content/pages/hi/kit.md | 1 + src/content/pages/hi/quickstart.md | 2 +- src/content/pages/id/init.md | 6 ++- src/content/pages/id/kit.md | 1 + src/content/pages/id/quickstart.md | 4 +- src/content/pages/it/init.md | 6 ++- src/content/pages/it/kit.md | 1 + src/content/pages/it/quickstart.md | 4 +- src/content/pages/ja/init.md | 3 +- src/content/pages/ja/kit.md | 1 + src/content/pages/ja/quickstart.md | 2 +- src/content/pages/ko/init.md | 3 +- src/content/pages/ko/kit.md | 1 + src/content/pages/ko/quickstart.md | 4 +- src/content/pages/pl/init.md | 3 +- src/content/pages/pl/kit.md | 1 + src/content/pages/pl/quickstart.md | 4 +- src/content/pages/pt/init.md | 6 ++- src/content/pages/pt/kit.md | 1 + src/content/pages/pt/quickstart.md | 4 +- src/content/pages/ru/init.md | 5 ++- src/content/pages/ru/kit.md | 1 + src/content/pages/ru/quickstart.md | 4 +- src/content/pages/th/init.md | 3 +- src/content/pages/th/kit.md | 1 + src/content/pages/th/quickstart.md | 4 +- src/content/pages/tr/init.md | 5 ++- src/content/pages/tr/kit.md | 1 + src/content/pages/tr/quickstart.md | 2 +- src/content/pages/uk/init.md | 3 +- src/content/pages/uk/kit.md | 1 + src/content/pages/uk/quickstart.md | 4 +- src/content/pages/vi/init.md | 4 +- src/content/pages/vi/kit.md | 1 + src/content/pages/vi/quickstart.md | 4 +- src/content/pages/zh/init.md | 3 +- src/content/pages/zh/kit.md | 1 + src/content/pages/zh/quickstart.md | 4 +- src/content/spec/de/addons.md | 18 ++++++-- src/content/spec/en/addons.md | 18 ++++++-- src/content/spec/es/addons.md | 18 ++++++-- src/content/spec/fr/addons.md | 16 ++++++- src/content/spec/hi/addons.md | 16 ++++++- src/content/spec/id/addons.md | 16 ++++++- src/content/spec/it/addons.md | 16 ++++++- src/content/spec/ja/addons.md | 18 ++++++-- src/content/spec/ko/addons.md | 16 ++++++- src/content/spec/pl/addons.md | 16 ++++++- src/content/spec/pt/addons.md | 18 ++++++-- src/content/spec/ru/addons.md | 16 ++++++- src/content/spec/th/addons.md | 16 ++++++- src/content/spec/tr/addons.md | 16 ++++++- src/content/spec/uk/addons.md | 16 ++++++- src/content/spec/vi/addons.md | 16 ++++++- src/content/spec/zh/addons.md | 18 ++++++-- src/lib/translations/de.ts | 4 +- src/lib/translations/en.ts | 4 +- src/lib/translations/es.ts | 4 +- src/lib/translations/fr.ts | 4 +- src/lib/translations/hi.ts | 4 +- src/lib/translations/id.ts | 4 +- src/lib/translations/it.ts | 4 +- src/lib/translations/ja.ts | 4 +- src/lib/translations/ko.ts | 4 +- src/lib/translations/pl.ts | 4 +- src/lib/translations/pt.ts | 4 +- src/lib/translations/ru.ts | 4 +- src/lib/translations/th.ts | 4 +- src/lib/translations/tr.ts | 4 +- src/lib/translations/uk.ts | 4 +- src/lib/translations/vi.ts | 4 +- src/lib/translations/zh.ts | 4 +- 119 files changed, 1438 insertions(+), 151 deletions(-) create mode 100644 src/content/kit/de/ai-diff-reviewer.md create mode 100644 src/content/kit/en/ai-diff-reviewer.md create mode 100644 src/content/kit/es/ai-diff-reviewer.md create mode 100644 src/content/kit/fr/ai-diff-reviewer.md create mode 100644 src/content/kit/hi/ai-diff-reviewer.md create mode 100644 src/content/kit/id/ai-diff-reviewer.md create mode 100644 src/content/kit/it/ai-diff-reviewer.md create mode 100644 src/content/kit/ja/ai-diff-reviewer.md create mode 100644 src/content/kit/ko/ai-diff-reviewer.md create mode 100644 src/content/kit/pl/ai-diff-reviewer.md create mode 100644 src/content/kit/pt/ai-diff-reviewer.md create mode 100644 src/content/kit/ru/ai-diff-reviewer.md create mode 100644 src/content/kit/th/ai-diff-reviewer.md create mode 100644 src/content/kit/tr/ai-diff-reviewer.md create mode 100644 src/content/kit/uk/ai-diff-reviewer.md create mode 100644 src/content/kit/vi/ai-diff-reviewer.md create mode 100644 src/content/kit/zh/ai-diff-reviewer.md diff --git a/src/content/kit/de/ai-diff-reviewer.md b/src/content/kit/de/ai-diff-reviewer.md new file mode 100644 index 0000000..d571929 --- /dev/null +++ b/src/content/kit/de/ai-diff-reviewer.md @@ -0,0 +1,61 @@ +--- +title: AI Diff Reviewer +description: "Optionales DWP-Addon: erweitert die Sicherheitsprüfung um einen lokalen AI Diff Reviewer-Durchlauf, optionalen Flow-B-CI-Merge-Gate (v2), gemeinsame Erweiterungsdatei und apply-review-Begleiter." +kind: addon +lang: de +order: 5 +--- + +# AI Diff Reviewer Addon + +Verbindet die Deep Work Plan-Ausführung mit dem **[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)** (Marketplace-Eintrag **"AI Diff Reviewer"**, aktuelle Version **v2.0.0**), sodass die obligatorische abschließende Aufgabe **Sicherheitsprüfung** eine strukturierte lokale Überprüfung erhält — Urteil, Ergebnistabelle und Schweregrad — und, bei Wahl von Flow B, jeder Pull-Request durch dieselbe Überprüfung in CI gesperrt werden kann. Ein **optionales** Addon; nie erforderlich für AI-first-Konformität. + +Die Kernmethodologie von Deep Work Plan hat **null** Abhängigkeit vom AI Diff Reviewer. Ein Repository ohne Addons ist vollständig konform. Biete dieses Addon nur an, wenn der Entwickler oder das Team strukturierte Überprüfungsqualität wünscht; niemals automatisch für alle installieren. Immer Flow A vs. Flow B erfragen — niemals einen Standard annehmen. + +## Wann es zu verwenden ist + +| Signal | Aktion | +|--------|--------| +| Team möchte einen CI-PR-Merge-Gate mit strukturierten Ergebnissen | **Flow B empfehlen** beim Onboarding | +| Persönliches oder experimentelles Repository; lokale Pre-Push-Überprüfung reicht aus | **Flow A anbieten** | +| Kein Interesse an einer zusätzlichen Überprüfungsoberfläche | **Überspringen** — die Basis-Sicherheitsprüfung gilt weiterhin | + +## Zwei Adoptionsflows + +| Flow | Was du erhältst | +|------|----------------| +| **A — nur lokal** | Vendored Skill + erforderliche `.review/extension.md` (über `generate-extension`). Erweitert die Sicherheitsprüfung um einen lokalen Durchlauf. Kein GitHub Actions-Workflow. | +| **B — doppelte Oberfläche** | Flow A plus `setup` schreibt `.github/workflows/pr-review.yml` (Action `@v2`), dieselbe Erweiterungsdatei für lokal und CI. Optionaler `apply-review`-Begleiter nach CI-Ergebnissen. | + +Die Erkennung für die Sicherheitsprüfungserweiterung erfordert **Skill + eine Erweiterungsdatei** an einem dieser Orte: `.review/extension.md`, `.github/ai-diff-reviewer/extension.md` oder `.github/ai-pr-reviewer/extension.md`. Der Skill allein reicht nicht aus. + +## Was dieses Addon verbindet (bewusst begrenzt) + +Das DWP-Addon **erfindet** den Reviewer nicht neu. Es delegiert Installation, Methodik, den CI-Assistenten, Erweiterungsautorenschaft, PR-Entwurf und Post-CI-Durchsicht an die fünf Sub-Skills des Upstream-Skills (übergeordneter Standardflow, `generate-extension`, `setup`, `open-pr`, `apply-review`). + +### Erweiterung der Sicherheitsprüfung + +Bei Erkennung fügen `create` / `execute` einen lokalen Überprüfungsschritt zur obligatorischen Sicherheitsprüfungsaufgabe hinzu. Die Ausgabe wird unter `## AI Diff Reviewer local review` in `analysis_results/SECURITY_REVIEW.md` angehängt. + +- **Soft-Fail (nur Aufruf):** fehlender Skill, fehlende Erweiterung oder Aufruffehler → einmal warnen und fortfahren; Aufgabe nie für diesen Fehler scheitern lassen. +- **Gate nach einem abgeschlossenen Durchlauf:** `critical`-Ergebnisse blockieren weiterhin den Abschluss der Sicherheitsprüfung bis zur Korrektur oder expliziten Annahme (bestehender SR-Vertrag). `warning` / `info` werden dokumentiert, sind aber nicht blockierend. +- **Flow A benötigt kein CI-Secret.** Ein nicht gesetzter `CURSOR_API_KEY` darf den lokalen Durchlauf nicht unterdrücken. + +### Flow-B-CI-Gate (optional) + +Gepinnte Action `DailybotHQ/ai-diff-reviewer@v2`, typischerweise Label-gesperrt (`ready`), mit einem stabil benannten **AI review gate**-Job für Branch-Schutz und optionalem `skip-review-label: skip-ai-review`. Gemeinsames `prompt.md` + Erweiterung richten Methodik und Schweregrad aus; unter iterationsbewusster Überprüfung können CI-Runden 2+ kürzer sein, während der lokale Durchlauf vollständig bleibt. + +### Optionaler `apply-review`-Begleiter + +Nach CI-Veröffentlichung einer Überprüfung kann der Entwickler `apply-review` während `execute` aufrufen, um Ergebnisse einzeln zu durchlaufen (anwenden / zurückstellen / überspringen) mit Zustimmung. Standardmäßig nur lesend; nie eine Planaufgabendatei (würde die obligatorische Aufgabenreihenfolge brechen). + +## Verhalten + +- **Flow erfragen; niemals raten.** Ein unaufgefordert installierten Workflow hat einen größeren Fußabdruck als beim Flow A zu bleiben. +- **Abstimmen, nicht überschreiben.** Vorhandener Skill, Erweiterung oder `pr-review.yml` bleiben erhalten; nur Lücken füllen. +- **Auth verschoben.** Provider-Secrets für CI werden vom Maintainer konfiguriert; dieses Addon speichert keine Anmeldeinformationen. +- **Anbieterneutral.** Ablehnen hinterlässt ein vollständig AI-first-Repository. + +## Hinweise + +Optional und nie erforderlich. Upstream-Skill: [DailybotHQ/ai-diff-reviewer](https://github.com/DailybotHQ/ai-diff-reviewer). Spec-Seite: [Add-ons](/spec/addons). diff --git a/src/content/kit/de/dailybot.md b/src/content/kit/de/dailybot.md index f4be502..947fe57 100644 --- a/src/content/kit/de/dailybot.md +++ b/src/content/kit/de/dailybot.md @@ -124,7 +124,7 @@ Die Installation der Dailybot-Agent-Skill bringt weit mehr als das DWP-Addon ver ## Onboarding-Ablauf -Während DWP `onboard` **Phase 7b**, nach dem zentralen AI-first-Scaffolding, bietet der Ablauf vier optionale Addons. Akzeptiert der Entwickler Dailybot: +Während DWP `onboard` **Phase 7b**, nach dem zentralen AI-first-Scaffolding, bietet der Ablauf fünf optionale Addons. Akzeptiert der Entwickler Dailybot: 1. Bestehendes Setup erkennen (Skill, CLI, `.dailybot/profile.json`, Hooks, Report-Schritt). 2. Skill-/CLI-Installation über Dailybots Einwilligungsflows anbieten. diff --git a/src/content/kit/en/ai-diff-reviewer.md b/src/content/kit/en/ai-diff-reviewer.md new file mode 100644 index 0000000..09df5df --- /dev/null +++ b/src/content/kit/en/ai-diff-reviewer.md @@ -0,0 +1,61 @@ +--- +title: AI Diff Reviewer +description: "Opt-in DWP addon: augment Security Review with a local AI Diff Reviewer pass, optional Flow B CI merge gate (v2), shared extension file, and apply-review companion." +kind: addon +lang: en +order: 5 +--- + +# AI Diff Reviewer addon + +Connect Deep Work Plan execution to the **[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)** (marketplace listing **"AI Diff Reviewer"**, current **v2.0.0**) so the mandatory **Security Review** final task gains a structured local review — verdict, findings table, and severity — and, when you choose Flow B, every pull request can be gated by the same review in CI. An **opt-in** addon; never required for AI-first conformance. + +The core Deep Work Plan methodology has **zero** AI Diff Reviewer dependency. A repository with zero addons is fully conformant. Offer this addon only when the developer or team wants structured review quality; never auto-install for everyone. Always ask Flow A vs Flow B — never default. + +## When to use it + +| Signal | Action | +|--------|--------| +| Team wants a CI PR merge gate with structured findings | **Recommend Flow B** during onboarding | +| Personal or experimental repo; local pre-push review is enough | **Offer Flow A** | +| No appetite for an extra review surface | **Skip** — baseline Security Review still applies | + +## Two adoption flows + +| Flow | What you get | +|------|----------------| +| **A — local-only** | Vendored skill + required `.review/extension.md` (via `generate-extension`). Augments Security Review with a local pass. No GitHub Actions workflow. | +| **B — dual-surface** | Flow A plus `setup` writes `.github/workflows/pr-review.yml` (Action `@v2`), same extension file for local and CI. Optional `apply-review` companion after CI posts findings. | + +Detection for the Security Review augmentation requires **skill + an extension file** at one of: `.review/extension.md`, `.github/ai-diff-reviewer/extension.md`, or `.github/ai-pr-reviewer/extension.md`. Skill alone is not enough. + +## What this addon wires (narrow by design) + +The DWP addon does **not** reinvent the reviewer. It defers install, methodology, the CI wizard, extension authoring, PR drafting, and post-CI walkthrough to the upstream skill's five sub-skills (parent default flow, `generate-extension`, `setup`, `open-pr`, `apply-review`). + +### Security Review augmentation + +When detected, `create` / `execute` add a local review step to the mandatory Security Review task. Output appends under `## AI Diff Reviewer local review` in `analysis_results/SECURITY_REVIEW.md`. + +- **Soft-fail (invocation only):** missing skill, missing extension, or invocation error → warn once and continue; never fail the task for that miss. +- **Gate after a completed pass:** `critical` findings still block Security Review completion until fixed or explicitly accepted (existing SR contract). `warning` / `info` are documented but non-blocking. +- **Flow A needs no CI secret.** An unset `CURSOR_API_KEY` must not suppress the local pass. + +### Flow B CI gate (optional) + +Pinned Action `DailybotHQ/ai-diff-reviewer@v2`, typically label-gated (`ready`), with a stable-named **AI review gate** job for branch protection and opt-in `skip-review-label: skip-ai-review`. Shared `prompt.md` + extension align methodology and severity; under Iteration-Aware Review, CI round 2+ may be shorter while the local pass stays full. + +### Optional `apply-review` companion + +After CI posts a review, the developer may invoke `apply-review` during `execute` to walk findings per-finding (apply / defer / skip) with consent. Read-only by default; never a plan task file (would break mandatory final-task order). + +## Behavior + +- **Ask the flow; never guess.** Installing a workflow unrequested is a larger footprint than staying on Flow A. +- **Reconcile, don't clobber.** Existing skill, extension, or `pr-review.yml` are preserved; fill gaps only. +- **Auth deferred.** Provider secrets for CI are maintainer-configured; this addon never stores credentials. +- **Vendor-neutral.** Declining leaves a fully AI-first repo. + +## Notes + +Opt-in and never required. Upstream skill: [DailybotHQ/ai-diff-reviewer](https://github.com/DailybotHQ/ai-diff-reviewer). Spec page: [Add-ons](/spec/addons). diff --git a/src/content/kit/en/dailybot.md b/src/content/kit/en/dailybot.md index c382360..3b3583a 100644 --- a/src/content/kit/en/dailybot.md +++ b/src/content/kit/en/dailybot.md @@ -124,7 +124,7 @@ Public reference: [dailybot.com/skill.md](https://www.dailybot.com/skill.md). So ## Onboarding flow -During DWP `onboard` **Phase 7b**, after core AI-first scaffolding, the flow offers four opt-in addons. If the developer accepts Dailybot: +During DWP `onboard` **Phase 7b**, after core AI-first scaffolding, the flow offers five opt-in addons. If the developer accepts Dailybot: 1. Detect existing setup (skill, CLI, `.dailybot/profile.json`, hooks, report step). 2. Offer skill/CLI install through Dailybot's consent flows. diff --git a/src/content/kit/es/ai-diff-reviewer.md b/src/content/kit/es/ai-diff-reviewer.md new file mode 100644 index 0000000..df28837 --- /dev/null +++ b/src/content/kit/es/ai-diff-reviewer.md @@ -0,0 +1,61 @@ +--- +title: AI Diff Reviewer +description: "Addon DWP opcional: amplía la Revisión de Seguridad con un pase local de AI Diff Reviewer, compuerta de CI opcional de Flujo B (v2), archivo de extensión compartido y compañero apply-review." +kind: addon +lang: es +order: 5 +--- + +# Addon de AI Diff Reviewer + +Conecta la ejecución de Deep Work Plan con el **[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)** (publicado en el marketplace como **"AI Diff Reviewer"**, versión actual **v2.0.0**) para que la tarea final obligatoria de **Revisión de Seguridad** adquiera una revisión local estructurada — veredicto, tabla de hallazgos y severidad — y, al elegir el Flujo B, cualquier pull request puede bloquearse con la misma revisión en CI. Un addon **opcional**; nunca requerido para la conformidad AI-first. + +La metodología central de Deep Work Plan tiene **cero** dependencia de AI Diff Reviewer. Un repositorio sin addons es plenamente conforme. Ofrece este addon solo cuando el desarrollador o el equipo desea calidad de revisión estructurada; nunca lo instales automáticamente para todos. Siempre pregunta Flujo A vs Flujo B — nunca elijas por defecto. + +## Cuándo usarlo + +| Señal | Acción | +|--------|--------| +| El equipo quiere una compuerta de fusión en CI con hallazgos estructurados | **Recomendar Flujo B** durante la incorporación | +| Repositorio personal o experimental; la revisión local previa al push es suficiente | **Ofrecer Flujo A** | +| Sin apetito por una superficie de revisión adicional | **Omitir** — la Revisión de Seguridad de base sigue aplicándose | + +## Dos flujos de adopción + +| Flujo | Qué obtienes | +|------|----------------| +| **A — solo local** | Skill vendorizada + `.review/extension.md` requerido (vía `generate-extension`). Amplía la Revisión de Seguridad con un pase local. Sin flujo de GitHub Actions. | +| **B — doble superficie** | Flujo A más `setup` escribe `.github/workflows/pr-review.yml` (Action `@v2`), mismo archivo de extensión para local y CI. Compañero opcional `apply-review` tras los hallazgos de CI. | + +La detección para la ampliación de la Revisión de Seguridad requiere **skill + un archivo de extensión** en alguna de: `.review/extension.md`, `.github/ai-diff-reviewer/extension.md` o `.github/ai-pr-reviewer/extension.md`. La skill sola no es suficiente. + +## Qué conecta este addon (acotado por diseño) + +El addon de DWP **no** reinventa el revisor. Delega la instalación, la metodología, el asistente de CI, la autoría de extensiones, la redacción de PRs y el recorrido post-CI a las cinco sub-skills de la skill upstream (flujo padre por defecto, `generate-extension`, `setup`, `open-pr`, `apply-review`). + +### Ampliación de la Revisión de Seguridad + +Cuando se detecta, `create` / `execute` añaden un paso de revisión local a la tarea obligatoria de Revisión de Seguridad. La salida se añade bajo `## AI Diff Reviewer local review` en `analysis_results/SECURITY_REVIEW.md`. + +- **Fallo suave (solo invocación):** skill ausente, extensión ausente o error de invocación → advertir una vez y continuar; nunca fallar la tarea por eso. +- **Compuerta tras un pase completado:** los hallazgos `critical` siguen bloqueando la finalización de la Revisión de Seguridad hasta que se corrijan o se acepten explícitamente (contrato SR existente). Los hallazgos `warning` / `info` se documentan pero no bloquean. +- **El Flujo A no necesita secreto de CI.** Un `CURSOR_API_KEY` no configurado no debe suprimir el pase local. + +### Compuerta de CI del Flujo B (opcional) + +Action fijada `DailybotHQ/ai-diff-reviewer@v2`, típicamente bloqueada por etiqueta (`ready`), con un trabajo de nombre estable **AI review gate** para la protección de ramas y etiqueta de omisión opcional `skip-review-label: skip-ai-review`. El `prompt.md` compartido + extensión alinean metodología y severidad; bajo Revisión Consciente de Iteraciones, las rondas de CI 2+ pueden ser más breves mientras el pase local permanece completo. + +### Compañero `apply-review` opcional + +Tras publicar CI una revisión, el desarrollador puede invocar `apply-review` durante `execute` para recorrer los hallazgos uno a uno (aplicar / diferir / omitir) con consentimiento. Solo lectura por defecto; nunca un archivo de tarea del plan (rompería el orden obligatorio de tareas finales). + +## Comportamiento + +- **Pregunta el flujo; nunca asumas.** Instalar un flujo no solicitado es una huella mayor que permanecer en el Flujo A. +- **Reconcilia, no sobreescriba.** La skill, extensión o `pr-review.yml` existentes se preservan; solo rellena huecos. +- **Auth diferida.** Los secretos del proveedor para CI los configura el mantenedor; este addon nunca almacena credenciales. +- **Neutral respecto al proveedor.** Rechazarlo deja un repositorio plenamente AI-first. + +## Notas + +Opcional y nunca requerido. Skill upstream: [DailybotHQ/ai-diff-reviewer](https://github.com/DailybotHQ/ai-diff-reviewer). Página de spec: [Add-ons](/spec/addons). diff --git a/src/content/kit/es/dailybot.md b/src/content/kit/es/dailybot.md index 8e31c85..b938331 100644 --- a/src/content/kit/es/dailybot.md +++ b/src/content/kit/es/dailybot.md @@ -124,7 +124,7 @@ Referencia pública: [dailybot.com/skill.md](https://www.dailybot.com/skill.md). ## Flujo de incorporación -Durante la **Fase 7b** de `onboard` de DWP, tras el andamiaje AI-first central, el flujo ofrece cuatro addons opcionales. Si el desarrollador acepta Dailybot: +Durante la **Fase 7b** de `onboard` de DWP, tras el andamiaje AI-first central, el flujo ofrece cinco addons opcionales. Si el desarrollador acepta Dailybot: 1. Detectar configuración existente (skill, CLI, `.dailybot/profile.json`, hooks, paso de reporte). 2. Ofrecer instalación de skill/CLI mediante los flujos de consentimiento de Dailybot. diff --git a/src/content/kit/fr/ai-diff-reviewer.md b/src/content/kit/fr/ai-diff-reviewer.md new file mode 100644 index 0000000..cfc1647 --- /dev/null +++ b/src/content/kit/fr/ai-diff-reviewer.md @@ -0,0 +1,61 @@ +--- +title: AI Diff Reviewer +description: "Addon DWP optionnel : renforce la Revue de sécurité avec un passage local AI Diff Reviewer, porte de fusion CI optionnelle Flow B (v2), fichier d\'extension partagé et compagnon apply-review." +kind: addon +lang: fr +order: 5 +--- + +# Addon AI Diff Reviewer + +Connecte l'exécution de Deep Work Plan à l'**[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)** (référencé sur le marketplace sous **"AI Diff Reviewer"**, version actuelle **v2.0.0**) afin que la tâche finale obligatoire de **Revue de sécurité** bénéficie d'une revue locale structurée — verdict, tableau de résultats et sévérité — et, en choisissant Flow B, chaque pull request peut être bloquée par la même revue en CI. Un addon **optionnel** ; jamais requis pour la conformité AI-first. + +La méthodologie centrale de Deep Work Plan a **zéro** dépendance envers AI Diff Reviewer. Un dépôt sans addons est entièrement conforme. Proposez cet addon uniquement lorsque le développeur ou l'équipe souhaite une qualité de revue structurée ; ne jamais l'installer automatiquement pour tous. Demandez toujours Flow A ou Flow B — ne jamais supposer. + +## Quand l'utiliser + +| Signal | Action | +|--------|--------| +| L'équipe souhaite une porte de fusion CI avec des résultats structurés | **Recommander Flow B** lors de l'intégration | +| Dépôt personnel ou expérimental ; la revue locale avant push est suffisante | **Proposer Flow A** | +| Pas d'appétit pour une surface de revue supplémentaire | **Ignorer** — la Revue de sécurité de base s'applique toujours | + +## Deux flux d'adoption + +| Flux | Ce que vous obtenez | +|------|----------------| +| **A — local uniquement** | Skill vendorisée + `.review/extension.md` requis (via `generate-extension`). Renforce la Revue de sécurité avec un passage local. Sans workflow GitHub Actions. | +| **B — double surface** | Flow A plus `setup` écrit `.github/workflows/pr-review.yml` (Action `@v2`), même fichier d'extension pour local et CI. Compagnon optionnel `apply-review` après que CI publie les résultats. | + +La détection pour le renforcement de la Revue de sécurité requiert **skill + un fichier d'extension** dans l'un de : `.review/extension.md`, `.github/ai-diff-reviewer/extension.md` ou `.github/ai-pr-reviewer/extension.md`. La skill seule ne suffit pas. + +## Ce que cet addon connecte (limité par conception) + +L'addon DWP ne **réinvente pas** le reviewer. Il délègue l'installation, la méthodologie, l'assistant CI, la création d'extensions, la rédaction des PR et le parcours post-CI aux cinq sous-skills de la skill upstream (flux parent par défaut, `generate-extension`, `setup`, `open-pr`, `apply-review`). + +### Renforcement de la Revue de sécurité + +Lorsque détecté, `create` / `execute` ajoutent une étape de revue locale à la tâche obligatoire de Revue de sécurité. La sortie s'ajoute sous `## AI Diff Reviewer local review` dans `analysis_results/SECURITY_REVIEW.md`. + +- **Échec doux (invocation uniquement) :** skill manquante, extension manquante ou erreur d'invocation → avertir une fois et continuer ; ne jamais échouer la tâche pour cela. +- **Porte après un passage complet :** les résultats `critical` bloquent toujours la finalisation de la Revue de sécurité jusqu'à correction ou acceptation explicite (contrat SR existant). `warning` / `info` sont documentés mais non bloquants. +- **Flow A ne nécessite pas de secret CI.** Un `CURSOR_API_KEY` non défini ne doit pas supprimer le passage local. + +### Porte CI Flow B (optionnelle) + +Action épinglée `DailybotHQ/ai-diff-reviewer@v2`, typiquement bloquée par étiquette (`ready`), avec un job nommé stablement **AI review gate** pour la protection des branches et étiquette de contournement optionnelle `skip-review-label: skip-ai-review`. `prompt.md` partagé + extension alignent méthodologie et sévérité ; sous la Revue consciente des itérations, les rondes CI 2+ peuvent être plus courtes tandis que le passage local reste complet. + +### Compagnon `apply-review` optionnel + +Après que CI publie une revue, le développeur peut invoquer `apply-review` pendant `execute` pour parcourir les résultats un par un (appliquer / différer / ignorer) avec consentement. Lecture seule par défaut ; jamais un fichier de tâche du plan (briserait l'ordre des tâches finales obligatoires). + +## Comportement + +- **Demander le flux ; ne jamais supposer.** Installer un workflow sans demande a une empreinte plus grande que rester sur Flow A. +- **Réconcilier, ne pas écraser.** Skill, extension ou `pr-review.yml` existants sont préservés ; combler uniquement les lacunes. +- **Auth différée.** Les secrets du fournisseur pour CI sont configurés par le mainteneur ; cet addon ne stocke jamais de credentials. +- **Neutre vis-à-vis du fournisseur.** Refuser laisse un dépôt entièrement AI-first. + +## Notes + +Optionnel et jamais requis. Skill upstream : [DailybotHQ/ai-diff-reviewer](https://github.com/DailybotHQ/ai-diff-reviewer). Page spec : [Add-ons](/spec/addons). diff --git a/src/content/kit/fr/dailybot.md b/src/content/kit/fr/dailybot.md index 98384d2..9b2d3df 100644 --- a/src/content/kit/fr/dailybot.md +++ b/src/content/kit/fr/dailybot.md @@ -124,7 +124,7 @@ Référence publique : [dailybot.com/skill.md](https://www.dailybot.com/skill.md ## Flux d'onboarding -Pendant la **Phase 7b** de `onboard` DWP, après le scaffolding AI-first central, le flux propose quatre addons optionnels. Si le développeur accepte Dailybot : +Pendant la **Phase 7b** de `onboard` DWP, après le scaffolding AI-first central, le flux propose cinq addons optionnels. Si le développeur accepte Dailybot : 1. Détecter la configuration existante (skill, CLI, `.dailybot/profile.json`, hooks, étape de rapport). 2. Proposer l'installation skill/CLI via les flux de consentement de Dailybot. diff --git a/src/content/kit/hi/ai-diff-reviewer.md b/src/content/kit/hi/ai-diff-reviewer.md new file mode 100644 index 0000000..dc09157 --- /dev/null +++ b/src/content/kit/hi/ai-diff-reviewer.md @@ -0,0 +1,61 @@ +--- +title: AI Diff Reviewer +description: "वैकल्पिक DWP ऐड-ऑन: स्थानीय AI Diff Reviewer पास से सुरक्षा समीक्षा को बेहतर बनाएं, वैकल्पिक Flow B CI मर्ज गेट (v2), साझा एक्सटेंशन फ़ाइल, और apply-review साथी।" +kind: addon +lang: hi +order: 5 +--- + +# AI Diff Reviewer ऐड-ऑन + +Deep Work Plan के निष्पादन को **[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)** (मार्केटप्लेस पर **"AI Diff Reviewer"**, वर्तमान संस्करण **v2.0.0**) से जोड़ें ताकि अनिवार्य अंतिम कार्य **सुरक्षा समीक्षा** को एक संरचित स्थानीय समीक्षा मिले — निर्णय, निष्कर्ष तालिका, और गंभीरता — और, Flow B चुनने पर, हर pull request को CI में उसी समीक्षा द्वारा नियंत्रित किया जा सके। यह एक **वैकल्पिक** ऐड-ऑन है; AI-first अनुपालन के लिए कभी आवश्यक नहीं। + +Deep Work Plan की मूल पद्धति में AI Diff Reviewer पर **शून्य** निर्भरता है। बिना ऐड-ऑन के रिपॉजिटरी पूरी तरह अनुपालन में है। यह ऐड-ऑन केवल तभी प्रदान करें जब डेवलपर या टीम संरचित समीक्षा गुणवत्ता चाहती हो; सभी के लिए कभी स्वचालित रूप से इंस्टॉल न करें। हमेशा Flow A और Flow B के बारे में पूछें — कभी डिफ़ॉल्ट न मानें। + +## कब उपयोग करें + +| संकेत | कार्रवाई | +|--------|--------| +| टीम संरचित निष्कर्षों के साथ CI PR मर्ज गेट चाहती है | ऑनबोर्डिंग के दौरान **Flow B की सिफारिश करें** | +| व्यक्तिगत या प्रयोगात्मक रिपॉजिटरी; पुश से पहले स्थानीय समीक्षा पर्याप्त है | **Flow A प्रदान करें** | +| अतिरिक्त समीक्षा सतह की कोई इच्छा नहीं | **छोड़ें** — आधारभूत सुरक्षा समीक्षा अभी भी लागू होती है | + +## दो अपनाने के प्रवाह + +| प्रवाह | आपको क्या मिलता है | +|------|----------------| +| **A — केवल स्थानीय** | वेंडर्ड स्किल + आवश्यक `.review/extension.md` (`generate-extension` के माध्यम से)। सुरक्षा समीक्षा को स्थानीय पास से बेहतर बनाता है। कोई GitHub Actions वर्कफ़्लो नहीं। | +| **B — दोहरी सतह** | Flow A के साथ `setup` `.github/workflows/pr-review.yml` (Action `@v2`) लिखता है, स्थानीय और CI के लिए एक ही एक्सटेंशन फ़ाइल। CI निष्कर्ष पोस्ट करने के बाद वैकल्पिक `apply-review` साथी। | + +सुरक्षा समीक्षा वृद्धि की पहचान के लिए निम्नलिखित में से किसी एक स्थान पर **स्किल + एक्सटेंशन फ़ाइल** की आवश्यकता है: `.review/extension.md`, `.github/ai-diff-reviewer/extension.md`, या `.github/ai-pr-reviewer/extension.md`। केवल स्किल पर्याप्त नहीं है। + +## यह ऐड-ऑन क्या जोड़ता है (जानबूझकर सीमित) + +DWP ऐड-ऑन समीक्षक को **पुनः आविष्कार नहीं** करता। यह इंस्टॉलेशन, पद्धति, CI विज़ार्ड, एक्सटेंशन लेखन, PR ड्राफ्टिंग, और CI के बाद की वॉकथ्रू को अपस्ट्रीम स्किल के पांच सब-स्किल (मूल डिफ़ॉल्ट प्रवाह, `generate-extension`, `setup`, `open-pr`, `apply-review`) को सौंपता है। + +### सुरक्षा समीक्षा वृद्धि + +जब पहचाना जाता है, `create` / `execute` अनिवार्य सुरक्षा समीक्षा कार्य में एक स्थानीय समीक्षा चरण जोड़ते हैं। आउटपुट `analysis_results/SECURITY_REVIEW.md` में `## AI Diff Reviewer local review` के नीचे जोड़ा जाता है। + +- **सॉफ्ट-फेल (केवल आमंत्रण):** स्किल अनुपस्थित, एक्सटेंशन अनुपस्थित, या आमंत्रण त्रुटि → एक बार चेतावनी दें और जारी रखें; इसके लिए कभी कार्य को विफल न करें। +- **पूर्ण पास के बाद गेट:** `critical` निष्कर्ष सुधार या स्पष्ट स्वीकृति तक सुरक्षा समीक्षा पूर्णता को अवरुद्ध करते रहते हैं (मौजूदा SR अनुबंध)। `warning` / `info` दस्तावेज़ीकृत हैं लेकिन अवरोधक नहीं। +- **Flow A को CI सीक्रेट की आवश्यकता नहीं।** अनसेट `CURSOR_API_KEY` स्थानीय पास को दबाने में सक्षम नहीं होना चाहिए। + +### Flow B CI गेट (वैकल्पिक) + +पिन किया गया Action `DailybotHQ/ai-diff-reviewer@v2`, आमतौर पर लेबल-गेटेड (`ready`), ब्रांच सुरक्षा के लिए स्थिर नामित **AI review gate** जॉब और वैकल्पिक स्किप लेबल `skip-review-label: skip-ai-review`। साझा `prompt.md` + एक्सटेंशन पद्धति और गंभीरता को संरेखित करता है; Iteration-Aware Review के तहत CI राउंड 2+ छोटे हो सकते हैं जबकि स्थानीय पास पूर्ण रहता है। + +### वैकल्पिक `apply-review` साथी + +CI समीक्षा पोस्ट करने के बाद, डेवलपर `execute` के दौरान `apply-review` को आमंत्रित कर सकता है ताकि सहमति के साथ निष्कर्षों की एक-एक करके समीक्षा की जा सके (लागू करें / स्थगित करें / छोड़ें)। डिफ़ॉल्ट रूप से केवल पठन; कभी प्लान टास्क फ़ाइल नहीं (अनिवार्य अंतिम-कार्य क्रम को तोड़ेगी)। + +## व्यवहार + +- **प्रवाह पूछें; कभी अनुमान न करें।** अनुरोध के बिना वर्कफ़्लो इंस्टॉल करना Flow A पर बने रहने से बड़ा फुटप्रिंट है। +- **समन्वय करें, ओवरराइट न करें।** मौजूदा स्किल, एक्सटेंशन, या `pr-review.yml` संरक्षित रहते हैं; केवल अंतराल भरें। +- **प्रमाणीकरण स्थगित।** CI के लिए प्रोवाइडर सीक्रेट मेंटेनर द्वारा कॉन्फ़िगर किए जाते हैं; यह ऐड-ऑन कभी क्रेडेंशियल संग्रहीत नहीं करता। +- **प्रोवाइडर-तटस्थ।** अस्वीकार करने पर पूरी तरह AI-first रिपॉजिटरी बचती है। + +## नोट्स + +वैकल्पिक और कभी आवश्यक नहीं। अपस्ट्रीम स्किल: [DailybotHQ/ai-diff-reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)। स्पेक पेज: [Add-ons](/spec/addons)। diff --git a/src/content/kit/hi/dailybot.md b/src/content/kit/hi/dailybot.md index 8520190..161633b 100644 --- a/src/content/kit/hi/dailybot.md +++ b/src/content/kit/hi/dailybot.md @@ -124,7 +124,7 @@ Dailybot agent skill इंस्टॉल करने से DWP ऐडऑन ## ऑनबोर्डिंग प्रवाह -DWP `onboard` के दौरान **Phase 7b** में, कोर AI-first scaffolding के बाद, प्रवाह चार ऑप्ट-इन ऐडऑन प्रस्तावित करता है। यदि डेवलपर Dailybot स्वीकार करता है: +DWP `onboard` के दौरान **Phase 7b** में, कोर AI-first scaffolding के बाद, प्रवाह पाँच ऑप्ट-इन ऐडऑन प्रस्तावित करता है। यदि डेवलपर Dailybot स्वीकार करता है: 1. मौजूदा सेटअप पहचानें (स्किल, CLI, `.dailybot/profile.json`, हुक, रिपोर्ट चरण)। 2. Dailybot की सहमति प्रवाहों के माध्यम से स्किल/CLI इंस्टॉल प्रस्तावित करें। diff --git a/src/content/kit/id/ai-diff-reviewer.md b/src/content/kit/id/ai-diff-reviewer.md new file mode 100644 index 0000000..5893171 --- /dev/null +++ b/src/content/kit/id/ai-diff-reviewer.md @@ -0,0 +1,61 @@ +--- +title: AI Diff Reviewer +description: "Add-on DWP opsional: perkuat Tinjauan Keamanan dengan penerusan lokal AI Diff Reviewer, gerbang gabungan CI Flow B opsional (v2), file ekstensi bersama, dan pendamping apply-review." +kind: addon +lang: id +order: 5 +--- + +# Add-on AI Diff Reviewer + +Menghubungkan eksekusi Deep Work Plan ke **[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)** (daftar marketplace **"AI Diff Reviewer"**, versi saat ini **v2.0.0**) sehingga tugas akhir wajib **Tinjauan Keamanan** memperoleh tinjauan lokal terstruktur — putusan, tabel temuan, dan tingkat keparahan — dan, saat memilih Flow B, setiap pull request dapat dibatasi oleh tinjauan yang sama di CI. Add-on **opsional**; tidak pernah diperlukan untuk kesesuaian AI-first. + +Metodologi inti Deep Work Plan memiliki **nol** ketergantungan pada AI Diff Reviewer. Repositori tanpa add-on sepenuhnya sesuai. Tawarkan add-on ini hanya ketika pengembang atau tim menginginkan kualitas tinjauan terstruktur; jangan pernah menginstal otomatis untuk semua orang. Selalu tanyakan Flow A atau Flow B — jangan pernah mengasumsikan nilai default. + +## Kapan Menggunakannya + +| Sinyal | Tindakan | +|--------|--------| +| Tim menginginkan gerbang gabungan CI dengan temuan terstruktur | **Rekomendasikan Flow B** saat orientasi | +| Repositori pribadi atau eksperimental; tinjauan lokal sebelum push sudah cukup | **Tawarkan Flow A** | +| Tidak ada keinginan untuk permukaan tinjauan tambahan | **Lewati** — Tinjauan Keamanan dasar tetap berlaku | + +## Dua Alur Adopsi + +| Alur | Yang Anda Dapatkan | +|------|----------------| +| **A — hanya lokal** | Skill bawaan + `.review/extension.md` yang diperlukan (melalui `generate-extension`). Memperkuat Tinjauan Keamanan dengan penerusan lokal. Tanpa alur kerja GitHub Actions. | +| **B — permukaan ganda** | Flow A ditambah `setup` menulis `.github/workflows/pr-review.yml` (Action `@v2`), file ekstensi yang sama untuk lokal dan CI. Pendamping `apply-review` opsional setelah CI memposting temuan. | + +Deteksi untuk peningkatan Tinjauan Keamanan memerlukan **skill + file ekstensi** di salah satu dari: `.review/extension.md`, `.github/ai-diff-reviewer/extension.md`, atau `.github/ai-pr-reviewer/extension.md`. Skill saja tidak cukup. + +## Yang Dihubungkan Add-on Ini (sengaja dibatasi) + +Add-on DWP **tidak** menemukan ulang pengulas. Ini mendelegasikan instalasi, metodologi, wizard CI, penulisan ekstensi, pembuatan draf PR, dan walkthrough pasca-CI ke lima sub-skill skill upstream (alur default induk, `generate-extension`, `setup`, `open-pr`, `apply-review`). + +### Peningkatan Tinjauan Keamanan + +Saat terdeteksi, `create` / `execute` menambahkan langkah tinjauan lokal ke tugas Tinjauan Keamanan wajib. Output ditambahkan di bawah `## AI Diff Reviewer local review` di `analysis_results/SECURITY_REVIEW.md`. + +- **Kegagalan lunak (hanya pemanggilan):** skill tidak ada, ekstensi tidak ada, atau kesalahan pemanggilan → peringatkan sekali dan lanjutkan; jangan pernah gagalkan tugas karena hal ini. +- **Gerbang setelah penerusan selesai:** temuan `critical` masih memblokir penyelesaian Tinjauan Keamanan hingga diperbaiki atau diterima secara eksplisit (kontrak SR yang ada). `warning` / `info` didokumentasikan tetapi tidak memblokir. +- **Flow A tidak memerlukan secret CI.** `CURSOR_API_KEY` yang tidak disetel tidak boleh menekan penerusan lokal. + +### Gerbang CI Flow B (opsional) + +Action tetap `DailybotHQ/ai-diff-reviewer@v2`, biasanya dibatasi label (`ready`), dengan pekerjaan **AI review gate** bernama stabil untuk perlindungan cabang dan label lewati opsional `skip-review-label: skip-ai-review`. `prompt.md` bersama + ekstensi menyelaraskan metodologi dan tingkat keparahan; di bawah Tinjauan Sadar Iterasi, putaran CI 2+ mungkin lebih pendek sementara penerusan lokal tetap penuh. + +### Pendamping `apply-review` Opsional + +Setelah CI memposting tinjauan, pengembang dapat memanggil `apply-review` selama `execute` untuk menelusuri temuan satu per satu (terapkan / tunda / lewati) dengan persetujuan. Hanya baca secara default; tidak pernah sebagai file tugas rencana (akan merusak urutan tugas akhir wajib). + +## Perilaku + +- **Tanyakan alurnya; jangan pernah menebak.** Menginstal alur kerja tanpa diminta memiliki jejak yang lebih besar daripada tetap di Flow A. +- **Rekonsiliasi, jangan menimpa.** Skill, ekstensi, atau `pr-review.yml` yang ada dipertahankan; isi hanya celah. +- **Autentikasi ditunda.** Secret penyedia untuk CI dikonfigurasi oleh pemelihara; add-on ini tidak pernah menyimpan kredensial. +- **Netral terhadap vendor.** Menolak meninggalkan repositori yang sepenuhnya AI-first. + +## Catatan + +Opsional dan tidak pernah diperlukan. Skill upstream: [DailybotHQ/ai-diff-reviewer](https://github.com/DailybotHQ/ai-diff-reviewer). Halaman spesifikasi: [Add-ons](/spec/addons). diff --git a/src/content/kit/id/dailybot.md b/src/content/kit/id/dailybot.md index 72d7542..7dc7d8e 100644 --- a/src/content/kit/id/dailybot.md +++ b/src/content/kit/id/dailybot.md @@ -124,7 +124,7 @@ Referensi publik: [dailybot.com/skill.md](https://www.dailybot.com/skill.md). Su ## Alur onboarding -Selama DWP `onboard` **Fase 7b**, setelah scaffolding AI-first inti, alur menawarkan empat addon opt-in. Jika pengembang menerima Dailybot: +Selama DWP `onboard` **Fase 7b**, setelah scaffolding AI-first inti, alur menawarkan lima addon opt-in. Jika pengembang menerima Dailybot: 1. Deteksi setup yang ada (skill, CLI, `.dailybot/profile.json`, hook, langkah laporan). 2. Tawarkan instalasi skill/CLI melalui alur persetujuan Dailybot. diff --git a/src/content/kit/it/ai-diff-reviewer.md b/src/content/kit/it/ai-diff-reviewer.md new file mode 100644 index 0000000..e9f09e4 --- /dev/null +++ b/src/content/kit/it/ai-diff-reviewer.md @@ -0,0 +1,61 @@ +--- +title: AI Diff Reviewer +description: "Addon DWP opzionale: potenzia la Revisione di Sicurezza con un passaggio locale di AI Diff Reviewer, gate CI opzionale Flow B (v2), file di estensione condiviso e compagno apply-review." +kind: addon +lang: it +order: 5 +--- + +# Addon AI Diff Reviewer + +Collega l'esecuzione di Deep Work Plan all'**[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)** (voce nel marketplace **"AI Diff Reviewer"**, versione corrente **v2.0.0**) in modo che il task finale obbligatorio di **Revisione di Sicurezza** acquisisca una revisione locale strutturata — verdetto, tabella dei risultati e gravità — e, scegliendo Flow B, ogni pull request può essere bloccata dalla stessa revisione in CI. Un addon **opzionale**; mai richiesto per la conformità AI-first. + +La metodologia centrale di Deep Work Plan ha **zero** dipendenza da AI Diff Reviewer. Un repository senza addon è pienamente conforme. Offri questo addon solo quando lo sviluppatore o il team desidera qualità di revisione strutturata; non installare mai automaticamente per tutti. Chiedi sempre Flow A vs Flow B — non assumere mai un valore predefinito. + +## Quando usarlo + +| Segnale | Azione | +|--------|--------| +| Il team vuole un gate di merge CI con risultati strutturati | **Raccomandare Flow B** durante l'onboarding | +| Repository personale o sperimentale; la revisione locale pre-push è sufficiente | **Offrire Flow A** | +| Nessun interesse per una superficie di revisione aggiuntiva | **Saltare** — la Revisione di Sicurezza di base si applica comunque | + +## Due flussi di adozione + +| Flusso | Cosa ottieni | +|------|----------------| +| **A — solo locale** | Skill vendorizzata + `.review/extension.md` richiesto (tramite `generate-extension`). Potenzia la Revisione di Sicurezza con un passaggio locale. Nessun workflow GitHub Actions. | +| **B — doppia superficie** | Flow A più `setup` scrive `.github/workflows/pr-review.yml` (Action `@v2`), stesso file di estensione per locale e CI. Compagno opzionale `apply-review` dopo che CI pubblica i risultati. | + +Il rilevamento per il potenziamento della Revisione di Sicurezza richiede **skill + un file di estensione** in uno di: `.review/extension.md`, `.github/ai-diff-reviewer/extension.md` o `.github/ai-pr-reviewer/extension.md`. La skill da sola non è sufficiente. + +## Cosa collega questo addon (limitato per design) + +L'addon DWP **non** reinventa il reviewer. Delega installazione, metodologia, l'assistente CI, la creazione di estensioni, la bozza delle PR e il walkthrough post-CI alle cinque sub-skill della skill upstream (flusso padre predefinito, `generate-extension`, `setup`, `open-pr`, `apply-review`). + +### Potenziamento della Revisione di Sicurezza + +Quando rilevato, `create` / `execute` aggiungono un passaggio di revisione locale al task obbligatorio di Revisione di Sicurezza. L'output viene aggiunto sotto `## AI Diff Reviewer local review` in `analysis_results/SECURITY_REVIEW.md`. + +- **Soft-fail (solo invocazione):** skill mancante, estensione mancante o errore di invocazione → avvisare una volta e continuare; non far mai fallire il task per questo. +- **Gate dopo un passaggio completato:** i risultati `critical` bloccano ancora il completamento della Revisione di Sicurezza fino alla correzione o accettazione esplicita (contratto SR esistente). `warning` / `info` sono documentati ma non bloccanti. +- **Flow A non necessita di secret CI.** Un `CURSOR_API_KEY` non impostato non deve sopprimere il passaggio locale. + +### Gate CI Flow B (opzionale) + +Action fissata `DailybotHQ/ai-diff-reviewer@v2`, tipicamente bloccata da etichetta (`ready`), con un job dal nome stabile **AI review gate** per la protezione dei branch e etichetta di bypass opzionale `skip-review-label: skip-ai-review`. `prompt.md` condiviso + estensione allineano metodologia e gravità; sotto la Revisione consapevole delle iterazioni, i round CI 2+ possono essere più brevi mentre il passaggio locale rimane completo. + +### Compagno `apply-review` opzionale + +Dopo che CI pubblica una revisione, lo sviluppatore può invocare `apply-review` durante `execute` per esaminare i risultati uno per uno (applicare / rimandare / saltare) con consenso. Solo lettura per impostazione predefinita; mai un file di task del piano (romperebbe l'ordine obbligatorio dei task finali). + +## Comportamento + +- **Chiedere il flusso; non indovinare mai.** Installare un workflow non richiesto ha un impatto maggiore rispetto a rimanere su Flow A. +- **Riconciliare, non sovrascrivere.** Skill, estensione o `pr-review.yml` esistenti sono preservati; colmare solo le lacune. +- **Auth differita.** I secret del provider per CI sono configurati dal maintainer; questo addon non archivia mai credenziali. +- **Neutro rispetto al provider.** Rifiutare lascia un repository completamente AI-first. + +## Note + +Opzionale e mai richiesto. Skill upstream: [DailybotHQ/ai-diff-reviewer](https://github.com/DailybotHQ/ai-diff-reviewer). Pagina spec: [Add-ons](/spec/addons). diff --git a/src/content/kit/it/dailybot.md b/src/content/kit/it/dailybot.md index 668de7f..0e50006 100644 --- a/src/content/kit/it/dailybot.md +++ b/src/content/kit/it/dailybot.md @@ -124,7 +124,7 @@ Riferimento pubblico: [dailybot.com/skill.md](https://www.dailybot.com/skill.md) ## Flusso di onboarding -Durante `onboard` di DWP **Fase 7b**, dopo lo scaffolding AI-first di base, il flusso offre quattro addon opt-in. Se lo sviluppatore accetta Dailybot: +Durante `onboard` di DWP **Fase 7b**, dopo lo scaffolding AI-first di base, il flusso offre cinque addon opt-in. Se lo sviluppatore accetta Dailybot: 1. Rileva setup esistente (skill, CLI, `.dailybot/profile.json`, hook, passo report). 2. Offre installazione skill/CLI tramite i flussi di consenso di Dailybot. diff --git a/src/content/kit/ja/ai-diff-reviewer.md b/src/content/kit/ja/ai-diff-reviewer.md new file mode 100644 index 0000000..e2175a3 --- /dev/null +++ b/src/content/kit/ja/ai-diff-reviewer.md @@ -0,0 +1,61 @@ +--- +title: AI Diff Reviewer +description: "オプションの DWP アドオン:ローカル AI Diff Reviewer パスでセキュリティレビューを強化、オプションの Flow B CI マージゲート(v2)、共有拡張ファイル、apply-review コンパニオン。" +kind: addon +lang: ja +order: 5 +--- + +# AI Diff Reviewer アドオン + +Deep Work Plan の実行を **[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)**(マーケットプレイス掲載名 **"AI Diff Reviewer"**、現在のバージョン **v2.0.0**)に接続し、必須の最終タスク **セキュリティレビュー** に構造化されたローカルレビュー — 判定、検出結果テーブル、深刻度 — を追加します。Flow B を選択した場合、すべてのプルリクエストを CI の同じレビューでゲートできます。**オプション**のアドオンであり、AI-first 適合性には決して必要ありません。 + +Deep Work Plan のコア方法論は AI Diff Reviewer への依存が**ゼロ**です。アドオンが存在しないリポジトリでも完全に適合します。このアドオンは、開発者またはチームが構造化されたレビュー品質を求める場合にのみ提供してください。全員に自動インストールしないでください。常に Flow A か Flow B かを確認してください — デフォルトは設定しません。 + +## 使用するタイミング + +| シグナル | アクション | +|--------|--------| +| チームが構造化された検出結果を持つ CI PR マージゲートを望んでいる | オンボーディング時に **Flow B を推奨** | +| 個人または実験的なリポジトリ;ローカルのプッシュ前レビューで十分 | **Flow A を提供** | +| 追加のレビュー面に対する需要がない | **スキップ** — ベースラインのセキュリティレビューは引き続き適用 | + +## 2 つの採用フロー + +| フロー | 得られるもの | +|------|----------------| +| **A — ローカルのみ** | ベンダー管理のスキル + 必須の `.review/extension.md`(`generate-extension` 経由)。ローカルパスでセキュリティレビューを強化。GitHub Actions ワークフローなし。 | +| **B — デュアルサーフェス** | Flow A に加え、`setup` が `.github/workflows/pr-review.yml`(Action `@v2`)を作成。ローカルと CI で同じ拡張ファイルを使用。CI が検出結果を投稿した後、オプションで `apply-review` コンパニオンを使用可能。 | + +セキュリティレビュー強化の検出には、次のいずれかの場所に**スキル + 拡張ファイル**が必要です:`.review/extension.md`、`.github/ai-diff-reviewer/extension.md`、または `.github/ai-pr-reviewer/extension.md`。スキルだけでは不十分です。 + +## このアドオンが接続する内容(意図的に限定) + +DWP アドオンはレビュアーを**再発明しません**。インストール、方法論、CI ウィザード、拡張オーサリング、PR 草案作成、CI 後のウォークスルーを、上流スキルの 5 つのサブスキル(親デフォルトフロー、`generate-extension`、`setup`、`open-pr`、`apply-review`)に委任します。 + +### セキュリティレビューの強化 + +検出された場合、`create` / `execute` は必須のセキュリティレビュータスクにローカルレビューステップを追加します。出力は `analysis_results/SECURITY_REVIEW.md` の `## AI Diff Reviewer local review` の下に追記されます。 + +- **ソフト失敗(呼び出しのみ):** スキルの欠如、拡張の欠如、または呼び出しエラー → 一度警告して続行;このミスでタスクを失敗させません。 +- **完了したパスの後のゲート:** `critical` の検出結果は修正または明示的に承認されるまでセキュリティレビューの完了をブロックし続けます(既存の SR 契約)。`warning` / `info` は記録されますがブロックしません。 +- **Flow A に CI シークレットは不要。** 未設定の `CURSOR_API_KEY` はローカルパスを抑制してはなりません。 + +### Flow B CI ゲート(オプション) + +固定 Action `DailybotHQ/ai-diff-reviewer@v2`、通常ラベルゲート(`ready`)、ブランチ保護用の安定した名前の **AI review gate** ジョブ、オプションのスキップラベル `skip-review-label: skip-ai-review`。共有の `prompt.md` + 拡張で方法論と深刻度を整合;反復認識レビューでは、CI の 2 回目以降のラウンドが短くなる場合がありますが、ローカルパスは完全に保たれます。 + +### オプションの `apply-review` コンパニオン + +CI がレビューを投稿した後、開発者は `execute` 中に `apply-review` を呼び出して、検出結果を 1 つずつ(適用 / 延期 / スキップ)同意のもとで確認できます。デフォルトで読み取り専用;プランタスクファイルとしては使用しない(必須の最終タスク順序を壊す)。 + +## 動作 + +- **フローを確認;決して推測しない。** 未要求のワークフローをインストールすることは、Flow A にとどまるよりも大きなフットプリントになります。 +- **調整する、上書きしない。** 既存のスキル、拡張、または `pr-review.yml` は保持;ギャップのみ埋める。 +- **認証は延期。** CI のプロバイダーシークレットはメンテナーが設定;このアドオンは認証情報を保存しません。 +- **ベンダー中立。** 辞退しても完全な AI-first リポジトリが残ります。 + +## 注意事項 + +オプションであり、必須ではありません。上流スキル:[DailybotHQ/ai-diff-reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)。スペックページ:[Add-ons](/spec/addons)。 diff --git a/src/content/kit/ja/dailybot.md b/src/content/kit/ja/dailybot.md index 541a7c3..3424d35 100644 --- a/src/content/kit/ja/dailybot.md +++ b/src/content/kit/ja/dailybot.md @@ -124,7 +124,7 @@ Dailybot エージェントスキルのインストールは、DWP アドオン ## オンボーディングフロー -DWP `onboard` **フェーズ 7b** で、コア AI-first スキャフォールディングの後、4 つのオプトインアドオンを提供。開発者が Dailybot を受け入れた場合: +DWP `onboard` **フェーズ 7b** で、コア AI-first スキャフォールディングの後、5 つのオプトインアドオンを提供。開発者が Dailybot を受け入れた場合: 1. 既存セットアップを検出(スキル、CLI、`.dailybot/profile.json`、フック、レポートステップ)。 2. Dailybot の同意フロー経由でスキル/CLI インストールを提供。 diff --git a/src/content/kit/ko/ai-diff-reviewer.md b/src/content/kit/ko/ai-diff-reviewer.md new file mode 100644 index 0000000..c1a17cd --- /dev/null +++ b/src/content/kit/ko/ai-diff-reviewer.md @@ -0,0 +1,61 @@ +--- +title: AI Diff Reviewer +description: "선택적 DWP 애드온: 로컬 AI Diff Reviewer 패스로 보안 검토 강화, 선택적 Flow B CI 병합 게이트(v2), 공유 확장 파일, apply-review 컴패니언." +kind: addon +lang: ko +order: 5 +--- + +# AI Diff Reviewer 애드온 + +Deep Work Plan 실행을 **[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)**(마켓플레이스 목록 **"AI Diff Reviewer"**, 현재 버전 **v2.0.0**)에 연결하여 필수 최종 작업인 **보안 검토**에 구조화된 로컬 검토 — 판정, 결과 표, 심각도 — 를 추가합니다. Flow B를 선택하면 모든 풀 리퀘스트를 CI에서 동일한 검토로 게이트할 수 있습니다. **선택적** 애드온으로 AI-first 적합성에는 결코 필요하지 않습니다. + +Deep Work Plan의 핵심 방법론은 AI Diff Reviewer에 대한 의존성이 **제로**입니다. 애드온이 없는 저장소도 완전히 적합합니다. 개발자나 팀이 구조화된 검토 품질을 원할 때만 이 애드온을 제공하세요. 모든 사람에게 자동으로 설치하지 마세요. 항상 Flow A와 Flow B 중 무엇을 원하는지 확인하세요 — 기본값을 가정하지 마세요. + +## 사용 시기 + +| 신호 | 조치 | +|--------|--------| +| 팀이 구조화된 결과가 있는 CI PR 병합 게이트를 원함 | 온보딩 시 **Flow B 권장** | +| 개인 또는 실험적 저장소; 로컬 사전 푸시 검토로 충분 | **Flow A 제공** | +| 추가 검토 면에 대한 의향이 없음 | **건너뜀** — 기본 보안 검토는 계속 적용 | + +## 두 가지 채택 플로우 + +| 플로우 | 제공 내용 | +|------|----------------| +| **A — 로컬 전용** | 벤더 관리 스킬 + 필수 `.review/extension.md`(`generate-extension` 경유). 로컬 패스로 보안 검토 강화. GitHub Actions 워크플로우 없음. | +| **B — 이중 서피스** | Flow A에 추가로 `setup`이 `.github/workflows/pr-review.yml`(Action `@v2`)을 작성. 로컬 및 CI에 동일한 확장 파일 사용. CI가 결과를 게시한 후 선택적 `apply-review` 컴패니언 사용 가능. | + +보안 검토 강화 감지에는 다음 중 하나에 **스킬 + 확장 파일**이 필요합니다: `.review/extension.md`, `.github/ai-diff-reviewer/extension.md`, 또는 `.github/ai-pr-reviewer/extension.md`. 스킬만으로는 충분하지 않습니다. + +## 이 애드온이 연결하는 내용(의도적으로 제한) + +DWP 애드온은 리뷰어를 **재발명하지 않습니다**. 설치, 방법론, CI 마법사, 확장 작성, PR 초안 작성, CI 후 워크스루를 업스트림 스킬의 5개 서브 스킬(부모 기본 플로우, `generate-extension`, `setup`, `open-pr`, `apply-review`)에 위임합니다. + +### 보안 검토 강화 + +감지되면 `create` / `execute`가 필수 보안 검토 작업에 로컬 검토 단계를 추가합니다. 출력은 `analysis_results/SECURITY_REVIEW.md`의 `## AI Diff Reviewer local review` 아래에 추가됩니다. + +- **소프트 실패(호출만):** 스킬 없음, 확장 없음, 또는 호출 오류 → 한 번 경고하고 계속; 이로 인해 작업을 실패시키지 않음. +- **완료된 패스 후 게이트:** `critical` 결과는 수정되거나 명시적으로 수락될 때까지 보안 검토 완료를 계속 차단합니다(기존 SR 계약). `warning` / `info`는 문서화되지만 차단하지 않습니다. +- **Flow A는 CI 시크릿이 필요 없습니다.** 설정되지 않은 `CURSOR_API_KEY`가 로컬 패스를 억제해서는 안 됩니다. + +### Flow B CI 게이트(선택적) + +고정된 Action `DailybotHQ/ai-diff-reviewer@v2`, 일반적으로 레이블 게이트(`ready`), 브랜치 보호를 위한 안정적으로 명명된 **AI review gate** 작업, 선택적 건너뜀 레이블 `skip-review-label: skip-ai-review`. 공유 `prompt.md` + 확장으로 방법론 및 심각도 정렬; 반복 인식 검토에서 CI 2+ 라운드가 더 짧을 수 있고 로컬 패스는 완전하게 유지됩니다. + +### 선택적 `apply-review` 컴패니언 + +CI가 검토를 게시한 후 개발자는 `execute` 중에 `apply-review`를 호출하여 결과를 하나씩(적용 / 연기 / 건너뜀)동의하에 검토할 수 있습니다. 기본적으로 읽기 전용; 플랜 작업 파일이 아님(필수 최종 작업 순서를 깨트림). + +## 동작 + +- **플로우를 확인; 절대 추측하지 않음.** 요청 없이 워크플로우를 설치하는 것은 Flow A에 머무는 것보다 더 큰 영향을 줍니다. +- **조정하고, 덮어쓰지 않음.** 기존 스킬, 확장, 또는 `pr-review.yml`은 보존; 빈틈만 채움. +- **인증 연기.** CI의 프로바이더 시크릿은 메인테이너가 구성; 이 애드온은 자격 증명을 저장하지 않음. +- **벤더 중립.** 거절해도 완전한 AI-first 저장소가 남습니다. + +## 참고 + +선택적이며 결코 필요하지 않습니다. 업스트림 스킬: [DailybotHQ/ai-diff-reviewer](https://github.com/DailybotHQ/ai-diff-reviewer). 스펙 페이지: [Add-ons](/spec/addons). diff --git a/src/content/kit/ko/dailybot.md b/src/content/kit/ko/dailybot.md index 04d668b..0e69d64 100644 --- a/src/content/kit/ko/dailybot.md +++ b/src/content/kit/ko/dailybot.md @@ -124,7 +124,7 @@ Dailybot 에이전트 스킬 설치는 DWP 애드온이 연결하는 것 이상 ## 온보딩 흐름 -DWP `onboard` **7b 단계**에서 핵심 AI-first 스캐폴딩 후 네 가지 옵트인 애드온을 제안. 개발자가 Dailybot을 수락하면: +DWP `onboard` **7b 단계**에서 핵심 AI-first 스캐폴딩 후 다섯 가지 옵트인 애드온을 제안. 개발자가 Dailybot을 수락하면: 1. 기존 설정 감지(스킬, CLI, `.dailybot/profile.json`, 훅, 보고 단계). 2. Dailybot 동의 흐름을 통해 스킬/CLI 설치 제안. diff --git a/src/content/kit/pl/ai-diff-reviewer.md b/src/content/kit/pl/ai-diff-reviewer.md new file mode 100644 index 0000000..09cd2dc --- /dev/null +++ b/src/content/kit/pl/ai-diff-reviewer.md @@ -0,0 +1,61 @@ +--- +title: AI Diff Reviewer +description: "Opcjonalny dodatek DWP: rozszerza Przegląd Bezpieczeństwa o lokalny przebieg AI Diff Reviewer, opcjonalną bramkę scalania CI Flow B (v2), współdzielony plik rozszerzenia i towarzysza apply-review." +kind: addon +lang: pl +order: 5 +--- + +# Dodatek AI Diff Reviewer + +Łączy wykonanie Deep Work Plan z **[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)** (wpis na marketplace **"AI Diff Reviewer"**, aktualna wersja **v2.0.0**), dzięki czemu obowiązkowe końcowe zadanie **Przeglądu Bezpieczeństwa** uzyskuje strukturalny lokalny przegląd — werdykt, tabelę wyników i poziom ważności — a przy wyborze Flow B każde pull request może być zablokowane przez ten sam przegląd w CI. Dodatek **opcjonalny**; nigdy niewymagany do zgodności AI-first. + +Podstawowa metodologia Deep Work Plan ma **zero** zależności od AI Diff Reviewer. Repozytorium bez dodatków jest w pełni zgodne. Oferuj ten dodatek tylko wtedy, gdy deweloper lub zespół chce strukturalnej jakości przeglądu; nigdy nie instaluj automatycznie dla wszystkich. Zawsze pytaj o Flow A lub Flow B — nigdy nie zakładaj wartości domyślnej. + +## Kiedy używać + +| Sygnał | Działanie | +|--------|--------| +| Zespół chce bramki scalania CI z ustrukturyzowanymi wynikami | **Zalecaj Flow B** podczas onboardingu | +| Repozytorium osobiste lub eksperymentalne; lokalny przegląd przed push wystarczy | **Oferuj Flow A** | +| Brak potrzeby dodatkowej powierzchni przeglądu | **Pomiń** — podstawowy Przegląd Bezpieczeństwa nadal obowiązuje | + +## Dwa przepływy adopcji + +| Przepływ | Co otrzymujesz | +|------|----------------| +| **A — tylko lokalnie** | Vendorowana skill + wymagany `.review/extension.md` (przez `generate-extension`). Rozszerza Przegląd Bezpieczeństwa o lokalny przebieg. Bez przepływu GitHub Actions. | +| **B — podwójna powierzchnia** | Flow A plus `setup` zapisuje `.github/workflows/pr-review.yml` (Action `@v2`), ten sam plik rozszerzenia dla lokalnego i CI. Opcjonalny towarzysz `apply-review` po opublikowaniu wyników przez CI. | + +Wykrywanie do rozszerzenia Przeglądu Bezpieczeństwa wymaga **skill + pliku rozszerzenia** w jednym z: `.review/extension.md`, `.github/ai-diff-reviewer/extension.md` lub `.github/ai-pr-reviewer/extension.md`. Sama skill nie wystarczy. + +## Co ten dodatek łączy (celowo ograniczone) + +Dodatek DWP **nie** wynajduje recenzenta na nowo. Deleguje instalację, metodologię, kreator CI, tworzenie rozszerzeń, szkicowanie PR i przegląd po CI do pięciu sub-skills skill upstream (domyślny przepływ nadrzędny, `generate-extension`, `setup`, `open-pr`, `apply-review`). + +### Rozszerzenie Przeglądu Bezpieczeństwa + +Po wykryciu `create` / `execute` dodają krok lokalnego przeglądu do obowiązkowego zadania Przeglądu Bezpieczeństwa. Wynik jest dołączany pod `## AI Diff Reviewer local review` w `analysis_results/SECURITY_REVIEW.md`. + +- **Miękka porażka (tylko wywołanie):** brakująca skill, brakujące rozszerzenie lub błąd wywołania → ostrzeż raz i kontynuuj; nigdy nie powoduj porażki zadania z tego powodu. +- **Bramka po ukończonym przebiegu:** wyniki `critical` nadal blokują ukończenie Przeglądu Bezpieczeństwa do czasu naprawienia lub wyraźnej akceptacji (istniejąca umowa SR). `warning` / `info` są dokumentowane, ale nieblokujące. +- **Flow A nie potrzebuje sekretu CI.** Nieustawiony `CURSOR_API_KEY` nie może tłumić lokalnego przebiegu. + +### Bramka CI Flow B (opcjonalna) + +Przypięta Action `DailybotHQ/ai-diff-reviewer@v2`, zazwyczaj bramkowana etykietą (`ready`), ze stabilnie nazwanym zadaniem **AI review gate** do ochrony gałęzi i opcjonalną etykietą pomijania `skip-review-label: skip-ai-review`. Wspólny `prompt.md` + rozszerzenie wyrównuje metodologię i ważność; w ramach Przeglądu Świadomego Iteracji rundy CI 2+ mogą być krótsze, podczas gdy lokalny przebieg pozostaje pełny. + +### Opcjonalny towarzysz `apply-review` + +Po opublikowaniu przeglądu przez CI deweloper może wywołać `apply-review` podczas `execute`, aby przejść przez wyniki jeden po drugim (zastosuj / odrocz / pomiń) za zgodą. Domyślnie tylko do odczytu; nigdy nie jest plikiem zadania planu (naruszyłoby to obowiązkową kolejność zadań końcowych). + +## Zachowanie + +- **Pytaj o przepływ; nigdy nie zgaduj.** Instalowanie przepływu bez prośby ma większy ślad niż pozostanie przy Flow A. +- **Uzgadniaj, nie nadpisuj.** Istniejąca skill, rozszerzenie lub `pr-review.yml` są zachowywane; wypełniaj tylko luki. +- **Uwierzytelnienie odroczone.** Sekrety dostawcy dla CI są konfigurowane przez opiekuna; ten dodatek nigdy nie przechowuje poświadczeń. +- **Neutralny wobec dostawcy.** Odmowa pozostawia w pełni AI-first repozytorium. + +## Uwagi + +Opcjonalny i nigdy niewymagany. Skill upstream: [DailybotHQ/ai-diff-reviewer](https://github.com/DailybotHQ/ai-diff-reviewer). Strona specyfikacji: [Add-ons](/spec/addons). diff --git a/src/content/kit/pl/dailybot.md b/src/content/kit/pl/dailybot.md index ff4d8da..32825f4 100644 --- a/src/content/kit/pl/dailybot.md +++ b/src/content/kit/pl/dailybot.md @@ -124,7 +124,7 @@ Referencja publiczna: [dailybot.com/skill.md](https://www.dailybot.com/skill.md) ## Przepływ onboardingu -Podczas DWP `onboard` w **Phase 7b**, po podstawowym scaffoldingu AI-first, przepływ proponuje cztery opcjonalne addony. Jeśli programista zaakceptuje Dailybot: +Podczas DWP `onboard` w **Phase 7b**, po podstawowym scaffoldingu AI-first, przepływ proponuje pięć opcjonalnych addonów. Jeśli programista zaakceptuje Dailybot: 1. Wykryj istniejącą konfigurację (skill, CLI, `.dailybot/profile.json`, hooki, krok raportu). 2. Zaproponuj instalację skilla/CLI przez przepływy zgody Dailybot. diff --git a/src/content/kit/pt/ai-diff-reviewer.md b/src/content/kit/pt/ai-diff-reviewer.md new file mode 100644 index 0000000..38ca618 --- /dev/null +++ b/src/content/kit/pt/ai-diff-reviewer.md @@ -0,0 +1,61 @@ +--- +title: AI Diff Reviewer +description: "Addon DWP opcional: aumenta a Revisão de Segurança com uma passagem local do AI Diff Reviewer, portão de CI opcional do Fluxo B (v2), ficheiro de extensão partilhado e companheiro apply-review." +kind: addon +lang: pt +order: 5 +--- + +# Addon de AI Diff Reviewer + +Conecta a execução do Deep Work Plan ao **[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)** (listagem no marketplace **"AI Diff Reviewer"**, versão atual **v2.0.0**) para que a tarefa final obrigatória de **Revisão de Segurança** obtenha uma revisão local estruturada — veredicto, tabela de resultados e severidade — e, ao escolher o Fluxo B, cada pull request pode ser bloqueado pela mesma revisão em CI. Um addon **opcional**; nunca obrigatório para conformidade AI-first. + +A metodologia central do Deep Work Plan tem **zero** dependência do AI Diff Reviewer. Um repositório sem addons está totalmente conforme. Ofereça este addon apenas quando o programador ou equipa pretende qualidade de revisão estruturada; nunca instale automaticamente para todos. Pergunte sempre Fluxo A vs Fluxo B — nunca assuma um padrão. + +## Quando usar + +| Sinal | Ação | +|--------|--------| +| A equipa quer um portão de fusão de CI com resultados estruturados | **Recomendar Fluxo B** durante a integração | +| Repositório pessoal ou experimental; a revisão local pré-push é suficiente | **Oferecer Fluxo A** | +| Sem interesse numa superfície de revisão adicional | **Ignorar** — a Revisão de Segurança de base continua a aplicar-se | + +## Dois fluxos de adoção + +| Fluxo | O que obtém | +|------|----------------| +| **A — apenas local** | Skill vendorizada + `.review/extension.md` obrigatório (via `generate-extension`). Aumenta a Revisão de Segurança com uma passagem local. Sem fluxo de GitHub Actions. | +| **B — dupla superfície** | Fluxo A mais `setup` escreve `.github/workflows/pr-review.yml` (Action `@v2`), mesmo ficheiro de extensão para local e CI. Companheiro opcional `apply-review` após CI publicar resultados. | + +A deteção para a ampliação da Revisão de Segurança requer **skill + um ficheiro de extensão** em um de: `.review/extension.md`, `.github/ai-diff-reviewer/extension.md` ou `.github/ai-pr-reviewer/extension.md`. A skill sozinha não é suficiente. + +## O que este addon liga (limitado por design) + +O addon DWP **não** reinventa o revisor. Delega instalação, metodologia, o assistente de CI, autoria de extensões, redação de PRs e percurso pós-CI às cinco sub-skills da skill upstream (fluxo pai predefinido, `generate-extension`, `setup`, `open-pr`, `apply-review`). + +### Ampliação da Revisão de Segurança + +Quando detetado, `create` / `execute` adicionam um passo de revisão local à tarefa obrigatória de Revisão de Segurança. A saída é adicionada sob `## AI Diff Reviewer local review` em `analysis_results/SECURITY_REVIEW.md`. + +- **Falha suave (apenas invocação):** skill em falta, extensão em falta ou erro de invocação → avisar uma vez e continuar; nunca reprovar a tarefa por isso. +- **Portão após uma passagem completa:** resultados `critical` continuam a bloquear a conclusão da Revisão de Segurança até serem corrigidos ou explicitamente aceites (contrato SR existente). `warning` / `info` são documentados mas não bloqueantes. +- **O Fluxo A não precisa de segredo de CI.** Um `CURSOR_API_KEY` não configurado não deve suprimir a passagem local. + +### Portão de CI do Fluxo B (opcional) + +Action fixada `DailybotHQ/ai-diff-reviewer@v2`, tipicamente bloqueada por etiqueta (`ready`), com um trabalho de nome estável **AI review gate** para proteção de ramos e etiqueta de omissão opcional `skip-review-label: skip-ai-review`. `prompt.md` partilhado + extensão alinham metodologia e severidade; sob Revisão com Consciência de Iteração, rondas de CI 2+ podem ser mais curtas enquanto a passagem local permanece completa. + +### Companheiro `apply-review` opcional + +Após CI publicar uma revisão, o programador pode invocar `apply-review` durante `execute` para percorrer os resultados um a um (aplicar / adiar / ignorar) com consentimento. Apenas leitura por padrão; nunca um ficheiro de tarefa do plano (quebraria a ordem obrigatória de tarefas finais). + +## Comportamento + +- **Perguntar o fluxo; nunca assumir.** Instalar um fluxo sem pedido é uma pegada maior do que permanecer no Fluxo A. +- **Reconciliar, não sobrescrever.** Skill, extensão ou `pr-review.yml` existentes são preservados; preencher apenas lacunas. +- **Auth adiada.** Os segredos do fornecedor para CI são configurados pelo mantenedor; este addon nunca armazena credenciais. +- **Neutro em relação ao fornecedor.** Recusar deixa um repositório totalmente AI-first. + +## Notas + +Opcional e nunca obrigatório. Skill upstream: [DailybotHQ/ai-diff-reviewer](https://github.com/DailybotHQ/ai-diff-reviewer). Página de spec: [Add-ons](/spec/addons). diff --git a/src/content/kit/pt/dailybot.md b/src/content/kit/pt/dailybot.md index 8111615..b63fd2c 100644 --- a/src/content/kit/pt/dailybot.md +++ b/src/content/kit/pt/dailybot.md @@ -124,7 +124,7 @@ Referência pública: [dailybot.com/skill.md](https://www.dailybot.com/skill.md) ## Fluxo de integração -Durante a **Fase 7b** do `onboard` DWP, após o scaffolding AI-first central, o fluxo oferece quatro addons opcionais. Se o programador aceitar Dailybot: +Durante a **Fase 7b** do `onboard` DWP, após o scaffolding AI-first central, o fluxo oferece cinco addons opcionais. Se o programador aceitar Dailybot: 1. Detetar configuração existente (skill, CLI, `.dailybot/profile.json`, hooks, passo de relatório). 2. Oferecer instalação de skill/CLI através dos fluxos de consentimento do Dailybot. diff --git a/src/content/kit/ru/ai-diff-reviewer.md b/src/content/kit/ru/ai-diff-reviewer.md new file mode 100644 index 0000000..a95a792 --- /dev/null +++ b/src/content/kit/ru/ai-diff-reviewer.md @@ -0,0 +1,61 @@ +--- +title: AI Diff Reviewer +description: "Дополнение DWP по выбору: расширяет проверку безопасности локальным проходом AI Diff Reviewer, опциональным CI-шлюзом Flow B (v2), общим файлом расширения и компаньоном apply-review." +kind: addon +lang: ru +order: 5 +--- + +# Дополнение AI Diff Reviewer + +Подключает выполнение Deep Work Plan к **[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)** (публикация в маркетплейсе — **«AI Diff Reviewer»**, текущая версия **v2.0.0**), чтобы обязательная финальная задача **Проверки безопасности** получила структурированную локальную проверку — вердикт, таблицу находок и уровень серьёзности — а при выборе Flow B каждый pull request мог закрываться той же проверкой в CI. Дополнение по **выбору**; никогда не требуется для соответствия AI-first. + +Основная методология Deep Work Plan имеет **нулевую** зависимость от AI Diff Reviewer. Репозиторий без дополнений полностью соответствует требованиям. Предлагайте это дополнение только тогда, когда разработчик или команда хочет структурированного качества проверки; никогда не устанавливайте автоматически для всех. Всегда уточняйте Flow A или Flow B — никогда не используйте значение по умолчанию. + +## Когда использовать + +| Сигнал | Действие | +|--------|--------| +| Команда хочет CI-шлюз для слияния PR со структурированными находками | **Рекомендовать Flow B** при onboarding | +| Личный или экспериментальный репозиторий; локальная проверка перед push достаточна | **Предложить Flow A** | +| Нет потребности в дополнительной поверхности проверки | **Пропустить** — базовая Проверка безопасности по-прежнему действует | + +## Два потока принятия + +| Поток | Что вы получаете | +|------|----------------| +| **A — только локально** | Встроенный skill + обязательный `.review/extension.md` (через `generate-extension`). Расширяет Проверку безопасности локальным проходом. Без рабочего процесса GitHub Actions. | +| **B — двойная поверхность** | Flow A плюс `setup` записывает `.github/workflows/pr-review.yml` (Action `@v2`), тот же файл расширения для локальной и CI-проверки. Опциональный компаньон `apply-review` после того, как CI публикует находки. | + +Для обнаружения расширения Проверки безопасности требуется **skill + файл расширения** в одном из мест: `.review/extension.md`, `.github/ai-diff-reviewer/extension.md` или `.github/ai-pr-reviewer/extension.md`. Одного skill недостаточно. + +## Что подключает это дополнение (намеренно ограничено) + +Дополнение DWP **не** изобретает проверяльщика заново. Оно делегирует установку, методологию, мастер CI, создание расширений, составление PR и обход результатов после CI пяти подскиллам вышестоящего skill (родительский поток по умолчанию, `generate-extension`, `setup`, `open-pr`, `apply-review`). + +### Расширение Проверки безопасности + +При обнаружении `create` / `execute` добавляют шаг локальной проверки к обязательной задаче Проверки безопасности. Вывод добавляется под `## AI Diff Reviewer local review` в `analysis_results/SECURITY_REVIEW.md`. + +- **Мягкий сбой (только вызов):** отсутствующий skill, отсутствующее расширение или ошибка вызова → предупредить один раз и продолжить; никогда не проваливать задачу из-за этого. +- **Шлюз после завершённого прохода:** находки `critical` по-прежнему блокируют завершение Проверки безопасности до исправления или явного принятия (существующий SR-контракт). `warning` / `info` документируются, но не блокируют. +- **Flow A не требует CI-секрета.** Незаданный `CURSOR_API_KEY` не должен подавлять локальный проход. + +### CI-шлюз Flow B (опционально) + +Закреплённый Action `DailybotHQ/ai-diff-reviewer@v2`, обычно блокированный меткой (`ready`), со стабильно именованным заданием **AI review gate** для защиты ветки и опциональной меткой пропуска `skip-review-label: skip-ai-review`. Общие `prompt.md` + расширение согласовывают методологию и уровень серьёзности; при итерационно-осознанной проверке раунды CI 2+ могут быть короче, тогда как локальный проход остаётся полным. + +### Опциональный компаньон `apply-review` + +После того как CI публикует проверку, разработчик может вызвать `apply-review` во время `execute`, чтобы пройти по находкам по одной (применить / отложить / пропустить) с согласия. Только чтение по умолчанию; никогда не является файлом задачи плана (нарушит обязательный порядок финальных задач). + +## Поведение + +- **Уточнять поток; никогда не угадывать.** Установка рабочего процесса без запроса создаёт большую нагрузку, чем остаться на Flow A. +- **Согласовывать, не затирать.** Существующий skill, расширение или `pr-review.yml` сохраняются; заполнять только пробелы. +- **Аутентификация отложена.** Секреты провайдера для CI настраивает сопровождающий; это дополнение никогда не хранит учётные данные. +- **Нейтральность к провайдеру.** Отказ оставляет полностью AI-first репозиторий. + +## Примечания + +По выбору и никогда не обязательно. Вышестоящий skill: [DailybotHQ/ai-diff-reviewer](https://github.com/DailybotHQ/ai-diff-reviewer). Страница спецификации: [Add-ons](/spec/addons). diff --git a/src/content/kit/ru/dailybot.md b/src/content/kit/ru/dailybot.md index e897b1d..e52cb61 100644 --- a/src/content/kit/ru/dailybot.md +++ b/src/content/kit/ru/dailybot.md @@ -124,7 +124,7 @@ order: 2 ## Поток онбординга -Во время DWP `onboard` **фаза 7b**, после базового AI-first каркаса, поток предлагает четыре опциональных аддона. Если разработчик принимает Dailybot: +Во время DWP `onboard` **фаза 7b**, после базового AI-first каркаса, поток предлагает пять опциональных аддонов. Если разработчик принимает Dailybot: 1. Обнаружить существующую настройку (навык, CLI, `.dailybot/profile.json`, хуки, шаг отчёта). 2. Предложить установку навыка/CLI через потоки согласия Dailybot. diff --git a/src/content/kit/th/ai-diff-reviewer.md b/src/content/kit/th/ai-diff-reviewer.md new file mode 100644 index 0000000..12647df --- /dev/null +++ b/src/content/kit/th/ai-diff-reviewer.md @@ -0,0 +1,61 @@ +--- +title: AI Diff Reviewer +description: "ส่วนเสริม DWP แบบเลือกใช้: เสริมการตรวจสอบความปลอดภัยด้วยการรัน AI Diff Reviewer ในเครื่อง, เกท CI Flow B แบบเลือกใช้ (v2), ไฟล์ส่วนขยายที่ใช้ร่วมกัน และผู้ช่วย apply-review" +kind: addon +lang: th +order: 5 +--- + +# ส่วนเสริม AI Diff Reviewer + +เชื่อมต่อการทำงานของ Deep Work Plan กับ **[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)** (รายการใน marketplace ชื่อ **"AI Diff Reviewer"** เวอร์ชันปัจจุบัน **v2.0.0**) เพื่อให้งานสุดท้ายที่บังคับอย่าง **การตรวจสอบความปลอดภัย** ได้รับการตรวจสอบในเครื่องแบบมีโครงสร้าง ได้แก่ คำตัดสิน ตารางผลการค้นพบ และระดับความรุนแรง และเมื่อเลือก Flow B คำขอดึง (pull request) ทุกรายการสามารถถูกควบคุมด้วยการตรวจสอบเดียวกันใน CI ได้ เป็นส่วนเสริม**แบบเลือกใช้** ไม่จำเป็นต้องใช้เพื่อให้เป็นไปตามมาตรฐาน AI-first + +ระเบียบวิธีหลักของ Deep Work Plan มีการพึ่งพา AI Diff Reviewer **เป็นศูนย์** ที่เก็บโค้ดที่ไม่มีส่วนเสริมยังคงสอดคล้องโดยสมบูรณ์ เสนอส่วนเสริมนี้เฉพาะเมื่อนักพัฒนาหรือทีมต้องการคุณภาพการตรวจสอบแบบมีโครงสร้างเท่านั้น อย่าติดตั้งให้ทุกคนโดยอัตโนมัติ ถามเสมอว่าต้องการ Flow A หรือ Flow B อย่าสันนิษฐานค่าเริ่มต้น + +## เมื่อใดควรใช้ + +| สัญญาณ | การดำเนินการ | +|--------|--------| +| ทีมต้องการเกทการรวม CI พร้อมผลการค้นพบแบบมีโครงสร้าง | **แนะนำ Flow B** ระหว่างการเริ่มต้นใช้งาน | +| ที่เก็บโค้ดส่วนตัวหรือทดลอง การตรวจสอบในเครื่องก่อนพุชเพียงพอ | **เสนอ Flow A** | +| ไม่ต้องการพื้นผิวการตรวจสอบเพิ่มเติม | **ข้าม** — การตรวจสอบความปลอดภัยพื้นฐานยังคงใช้งานได้ | + +## สองขั้นตอนการนำไปใช้ + +| ขั้นตอน | สิ่งที่คุณได้รับ | +|------|----------------| +| **A — เฉพาะในเครื่อง** | Skill ที่ฝังมาพร้อม + `.review/extension.md` ที่จำเป็น (ผ่าน `generate-extension`) เสริมการตรวจสอบความปลอดภัยด้วยการรันในเครื่อง ไม่มีเวิร์กโฟลว์ GitHub Actions | +| **B — สองพื้นผิว** | Flow A บวกกับ `setup` ที่เขียน `.github/workflows/pr-review.yml` (Action `@v2`) ไฟล์ส่วนขยายเดียวกันสำหรับในเครื่องและ CI ผู้ช่วย `apply-review` แบบเลือกใช้หลังจาก CI โพสต์ผลการค้นพบ | + +การตรวจจับสำหรับการเสริมการตรวจสอบความปลอดภัยต้องการ **skill + ไฟล์ส่วนขยาย** ที่หนึ่งในนี้: `.review/extension.md`, `.github/ai-diff-reviewer/extension.md` หรือ `.github/ai-pr-reviewer/extension.md` Skill เพียงอย่างเดียวไม่เพียงพอ + +## ส่วนเสริมนี้เชื่อมต่ออะไร (จำกัดตามการออกแบบ) + +ส่วนเสริม DWP **ไม่** สร้างผู้ตรวจสอบขึ้นใหม่ แต่มอบหมายการติดตั้ง ระเบียบวิธี ตัวช่วย CI การสร้างส่วนขยาย การร่าง PR และการทบทวนหลัง CI ให้กับ sub-skill ห้ารายการของ skill ต้นทาง (โฟลว์หลักเริ่มต้น `generate-extension` `setup` `open-pr` `apply-review`) + +### การเสริมการตรวจสอบความปลอดภัย + +เมื่อตรวจพบแล้ว `create` / `execute` จะเพิ่มขั้นตอนการตรวจสอบในเครื่องให้กับงานการตรวจสอบความปลอดภัยที่บังคับ ผลลัพธ์จะถูกเพิ่มภายใต้ `## AI Diff Reviewer local review` ใน `analysis_results/SECURITY_REVIEW.md` + +- **ความล้มเหลวแบบนุ่มนวล (เฉพาะการเรียก):** skill หายไป ส่วนขยายหายไป หรือข้อผิดพลาดในการเรียก → เตือนหนึ่งครั้งและดำเนินต่อ อย่าทำให้งานล้มเหลวเพราะเหตุนี้ +- **เกทหลังจากผ่านการตรวจสอบแล้ว:** ผลการค้นพบ `critical` ยังคงบล็อกการสิ้นสุดการตรวจสอบความปลอดภัยจนกว่าจะแก้ไขหรือยอมรับอย่างชัดเจน (สัญญา SR ที่มีอยู่) `warning` / `info` ถูกบันทึกแต่ไม่บล็อก +- **Flow A ไม่ต้องการ CI secret** `CURSOR_API_KEY` ที่ไม่ได้ตั้งค่าต้องไม่ระงับการรันในเครื่อง + +### เกท CI Flow B (แบบเลือกใช้) + +Action ที่ตรึงไว้ `DailybotHQ/ai-diff-reviewer@v2` โดยทั่วไปถูกควบคุมด้วยป้ายกำกับ (`ready`) พร้อมงาน **AI review gate** ที่ตั้งชื่ออย่างมั่นคงสำหรับการปกป้อง branch และป้ายกำกับข้ามแบบเลือกใช้ `skip-review-label: skip-ai-review` `prompt.md` ที่ใช้ร่วมกัน + ส่วนขยายจัดแนวระเบียบวิธีและระดับความรุนแรง ภายใต้การตรวจสอบแบบรับรู้การวนซ้ำ รอบ CI ที่ 2 ขึ้นไปอาจสั้นลงในขณะที่การรันในเครื่องยังคงสมบูรณ์ + +### ผู้ช่วย `apply-review` แบบเลือกใช้ + +หลังจาก CI โพสต์การตรวจสอบ นักพัฒนาสามารถเรียก `apply-review` ระหว่าง `execute` เพื่อทบทวนผลการค้นพบทีละรายการ (นำไปใช้ / เลื่อน / ข้าม) ด้วยความยินยอม อ่านอย่างเดียวตามค่าเริ่มต้น ไม่เคยเป็นไฟล์งานของแผน (จะทำให้ลำดับงานสุดท้ายที่บังคับเสียหาย) + +## พฤติกรรม + +- **ถามเกี่ยวกับโฟลว์ อย่าเดาเอาเอง** การติดตั้งเวิร์กโฟลว์โดยไม่ได้ขอมีผลกระทบมากกว่าการอยู่ที่ Flow A +- **ประนีประนอม อย่าเขียนทับ** Skill ส่วนขยาย หรือ `pr-review.yml` ที่มีอยู่จะถูกเก็บรักษาไว้ เติมเต็มเฉพาะช่องว่าง +- **การตรวจสอบสิทธิ์ถูกเลื่อนออกไป** ผู้รักษาจะกำหนดค่า secret ของผู้ให้บริการสำหรับ CI ส่วนเสริมนี้ไม่เก็บข้อมูลประจำตัว +- **เป็นกลางต่อผู้ให้บริการ** การปฏิเสธทิ้งที่เก็บโค้ดที่เป็น AI-first อย่างสมบูรณ์ + +## หมายเหตุ + +แบบเลือกใช้และไม่จำเป็นต้องใช้ Skill ต้นทาง: [DailybotHQ/ai-diff-reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) หน้า spec: [Add-ons](/spec/addons) diff --git a/src/content/kit/th/dailybot.md b/src/content/kit/th/dailybot.md index b48c78d..ede4d08 100644 --- a/src/content/kit/th/dailybot.md +++ b/src/content/kit/th/dailybot.md @@ -124,7 +124,7 @@ Addon นี้ **ไม่** ถาม email OTP หรือ API keys แล ## ขั้นตอน onboarding -ระหว่าง DWP `onboard` ใน **Phase 7b** หลัง scaffolding AI-first หลัก ขั้นตอนเสนอสี่ addon แบบ opt-in หากนักพัฒนายอมรับ Dailybot: +ระหว่าง DWP `onboard` ใน **Phase 7b** หลัง scaffolding AI-first หลัก ขั้นตอนเสนอห้า addon แบบ opt-in หากนักพัฒนายอมรับ Dailybot: 1. ตรวจการตั้งค่าที่มี (skill, CLI, `.dailybot/profile.json`, hook, ขั้นตอนรายงาน) 2. เสนอติดตั้ง skill/CLI ผ่านขั้นตอนความยินยอมของ Dailybot diff --git a/src/content/kit/tr/ai-diff-reviewer.md b/src/content/kit/tr/ai-diff-reviewer.md new file mode 100644 index 0000000..6866997 --- /dev/null +++ b/src/content/kit/tr/ai-diff-reviewer.md @@ -0,0 +1,61 @@ +--- +title: AI Diff Reviewer +description: "İsteğe bağlı DWP eklentisi: Güvenlik İncelemesini yerel bir AI Diff Reviewer geçişiyle güçlendirir, isteğe bağlı Flow B CI birleştirme kapısı (v2), paylaşılan uzantı dosyası ve apply-review yardımcısı." +kind: addon +lang: tr +order: 5 +--- + +# AI Diff Reviewer Eklentisi + +Deep Work Plan yürütmesini **[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)**'a (market listesi **"AI Diff Reviewer"**, mevcut sürüm **v2.0.0**) bağlayarak zorunlu son görev olan **Güvenlik İncelemesinin** yapılandırılmış bir yerel inceleme — karar, bulgu tablosu ve önem derecesi — kazanmasını sağlar ve Flow B seçildiğinde her çekme isteği CI\'da aynı incelemeyle kapı altına alınabilir. **İsteğe bağlı** bir eklenti; AI-first uygunluğu için hiçbir zaman gerekli değildir. + +Deep Work Plan\'ın temel metodolojisinin AI Diff Reviewer\'a **sıfır** bağımlılığı vardır. Sıfır eklentili bir depo tam uyumludur. Bu eklentiyi yalnızca geliştirici veya ekip yapılandırılmış inceleme kalitesi istediğinde önerin; hiçbir zaman herkes için otomatik yüklemeyin. Her zaman Flow A mı yoksa Flow B mi olduğunu sorun — hiçbir zaman varsayılan seçmeyin. + +## Ne zaman kullanılır + +| Sinyal | Eylem | +|--------|--------| +| Ekip yapılandırılmış bulgularla CI PR birleştirme kapısı istiyor | Katılım sırasında **Flow B\'yi önerin** | +| Kişisel veya deneysel depo; yerel itme öncesi inceleme yeterli | **Flow A\'yı önerin** | +| Ek bir inceleme yüzeyi için iştah yok | **Atlayın** — temel Güvenlik İncelemesi hâlâ geçerli | + +## İki Benimseme Akışı + +| Akış | Elde ettikleriniz | +|------|----------------| +| **A — yalnızca yerel** | Satıcılı skill + gerekli `.review/extension.md` (`generate-extension` aracılığıyla). Güvenlik İncelemesini yerel geçişle güçlendirir. GitHub Actions iş akışı yok. | +| **B — çift yüzey** | Flow A artı `setup`, `.github/workflows/pr-review.yml` (Action `@v2`) yazar; yerel ve CI için aynı uzantı dosyası. CI bulgularını yayınladıktan sonra isteğe bağlı `apply-review` yardımcısı. | + +Güvenlik İncelemesi güçlendirmesinin algılanması için şu konumlardan birinde **skill + uzantı dosyası** gerekir: `.review/extension.md`, `.github/ai-diff-reviewer/extension.md` veya `.github/ai-pr-reviewer/extension.md`. Skill tek başına yeterli değildir. + +## Bu eklentinin bağladıkları (tasarım gereği dar kapsamlı) + +DWP eklentisi inceleyiciyi **yeniden icat etmez**. Kurulum, metodoloji, CI sihirbazı, uzantı yazarlığı, PR taslak oluşturma ve CI sonrası incelemeyi yukarı akış skill\'in beş alt becerisine (üst varsayılan akış, `generate-extension`, `setup`, `open-pr`, `apply-review`) devreder. + +### Güvenlik İncelemesi Güçlendirmesi + +Algılandığında `create` / `execute`, zorunlu Güvenlik İncelemesi görevine yerel bir inceleme adımı ekler. Çıktı, `analysis_results/SECURITY_REVIEW.md` içindeki `## AI Diff Reviewer local review` altına eklenir. + +- **Yumuşak başarısızlık (yalnızca çağrı):** eksik skill, eksik uzantı veya çağrı hatası → bir kez uyar ve devam et; bu hata nedeniyle görevi hiçbir zaman başarısız sayma. +- **Tamamlanmış geçişten sonra kapı:** `critical` bulgular düzeltilinceye veya açıkça kabul edilinceye kadar Güvenlik İncelemesinin tamamlanmasını engellemeye devam eder (mevcut SR sözleşmesi). `warning` / `info` belgelenir ancak engellemez. +- **Flow A\'nın CI sırrına ihtiyacı yoktur.** Ayarlanmamış bir `CURSOR_API_KEY` yerel geçişi bastırmamalıdır. + +### Flow B CI Kapısı (isteğe bağlı) + +Sabitlenmiş Action `DailybotHQ/ai-diff-reviewer@v2`, genellikle etiket kapılı (`ready`), dal koruması için kararlı adlandırılmış **AI review gate** işi ve isteğe bağlı atlama etiketi `skip-review-label: skip-ai-review`. Paylaşılan `prompt.md` + uzantı metodoloji ve önem derecesini hizalar; Yineleme Farkındalıklı İnceleme altında CI 2.+ turlar daha kısa olabilirken yerel geçiş tam kalır. + +### İsteğe Bağlı `apply-review` Yardımcısı + +CI bir inceleme yayınladıktan sonra geliştirici, `execute` sırasında `apply-review`\'ı çağırarak bulguları tek tek (uygula / ertele / atla) onaylı biçimde inceleyebilir. Varsayılan olarak salt okunur; hiçbir zaman plan görev dosyası olmaz (zorunlu son görev sırasını bozar). + +## Davranış + +- **Akışı sorun; hiçbir zaman tahmin etmeyin.** İstenmeyen bir iş akışı yüklemek, Flow A\'da kalmaktan daha büyük bir ayak izine sahiptir. +- **Uzlaştırın, üzerine yazmayın.** Mevcut skill, uzantı veya `pr-review.yml` korunur; yalnızca boşlukları doldurun. +- **Kimlik doğrulama ertelendi.** CI için sağlayıcı sırlarını bakıcı yapılandırır; bu eklenti hiçbir zaman kimlik bilgisi saklamaz. +- **Sağlayıcıdan bağımsız.** Reddetmek tam AI-first bir depo bırakır. + +## Notlar + +İsteğe bağlı ve hiçbir zaman zorunlu değildir. Yukarı akış skill: [DailybotHQ/ai-diff-reviewer](https://github.com/DailybotHQ/ai-diff-reviewer). Spec sayfası: [Add-ons](/spec/addons). diff --git a/src/content/kit/tr/dailybot.md b/src/content/kit/tr/dailybot.md index 3462e85..8afb744 100644 --- a/src/content/kit/tr/dailybot.md +++ b/src/content/kit/tr/dailybot.md @@ -124,7 +124,7 @@ Halka açık referans: [dailybot.com/skill.md](https://www.dailybot.com/skill.md ## Onboarding akışı -DWP `onboard` sırasında **Faz 7b**'de, temel AI-first iskeletinden sonra akış dört opt-in eklenti sunar. Geliştirici Dailybot'u kabul ederse: +DWP `onboard` sırasında **Faz 7b**'de, temel AI-first iskeletinden sonra akış beş opt-in eklenti sunar. Geliştirici Dailybot'u kabul ederse: 1. Mevcut kurulumu tespit et (skill, CLI, `.dailybot/profile.json`, hook'lar, rapor adımı). 2. Dailybot onay akışlarıyla skill/CLI kurulumu sun. diff --git a/src/content/kit/uk/ai-diff-reviewer.md b/src/content/kit/uk/ai-diff-reviewer.md new file mode 100644 index 0000000..3fa65a3 --- /dev/null +++ b/src/content/kit/uk/ai-diff-reviewer.md @@ -0,0 +1,61 @@ +--- +title: AI Diff Reviewer +description: "Необов'язковий додаток DWP: розширює Огляд безпеки локальним проходом AI Diff Reviewer, необов'язковим CI-шлюзом Flow B (v2), спільним файлом розширення та супутником apply-review." +kind: addon +lang: uk +order: 5 +--- + +# Додаток AI Diff Reviewer + +Підключає виконання Deep Work Plan до **[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)** (опублікований у маркетплейсі як **«AI Diff Reviewer»**, поточна версія **v2.0.0**), щоб обов'язкове фінальне завдання **Огляду безпеки** отримало структурований локальний огляд — вердикт, таблицю знахідок і рівень серйозності — а при виборі Flow B кожен pull request може бути заблокований тим самим оглядом у CI. Необов'язковий **додаток**; ніколи не потрібен для відповідності AI-first. + +Основна методологія Deep Work Plan має **нульову** залежність від AI Diff Reviewer. Репозиторій без додатків повністю відповідає вимогам. Пропонуйте цей додаток лише тоді, коли розробник або команда прагне структурованої якості огляду; ніколи не встановлюйте автоматично для всіх. Завжди запитуйте Flow A чи Flow B — ніколи не передбачайте значення за замовчуванням. + +## Коли використовувати + +| Сигнал | Дія | +|--------|--------| +| Команда хоче CI-шлюз для злиття PR зі структурованими знахідками | **Рекомендувати Flow B** під час онбординг | +| Особистий або експериментальний репозиторій; локального огляду перед push достатньо | **Запропонувати Flow A** | +| Немає потреби в додатковій поверхні огляду | **Пропустити** — базовий Огляд безпеки діє | + +## Два потоки прийняття + +| Потік | Що ви отримуєте | +|------|----------------| +| **A — лише локально** | Вбудований skill + обов'язковий `.review/extension.md` (через `generate-extension`). Розширює Огляд безпеки локальним проходом. Без робочого процесу GitHub Actions. | +| **B — подвійна поверхня** | Flow A плюс `setup` записує `.github/workflows/pr-review.yml` (Action `@v2`), той самий файл розширення для локального та CI. Необов'язковий супутник `apply-review` після того, як CI публікує знахідки. | + +Виявлення для розширення Огляду безпеки потребує **skill + файл розширення** в одному з: `.review/extension.md`, `.github/ai-diff-reviewer/extension.md` або `.github/ai-pr-reviewer/extension.md`. Одного skill недостатньо. + +## Що підключає цей додаток (навмисно обмежено) + +Додаток DWP **не** перевинаходить рецензента. Він делегує встановлення, методологію, майстер CI, написання розширень, складання PR і перегляд після CI п'ятьом підскілам вихідного skill (батьківський типовий потік, `generate-extension`, `setup`, `open-pr`, `apply-review`). + +### Розширення Огляду безпеки + +При виявленні `create` / `execute` додають крок локального огляду до обов'язкового завдання Огляду безпеки. Вивід додається під `## AI Diff Reviewer local review` у `analysis_results/SECURITY_REVIEW.md`. + +- **М'який збій (лише виклик):** відсутній skill, відсутнє розширення або помилка виклику → попередити один раз і продовжити; ніколи не провалювати завдання через це. +- **Шлюз після завершеного проходу:** знахідки `critical` продовжують блокувати завершення Огляду безпеки до виправлення або явного прийняття (існуючий SR-контракт). `warning` / `info` документуються, але не блокують. +- **Flow A не потребує CI-секрету.** Незаданий `CURSOR_API_KEY` не має пригнічувати локальний прохід. + +### CI-шлюз Flow B (необов'язково) + +Закріплений Action `DailybotHQ/ai-diff-reviewer@v2`, зазвичай заблокований міткою (`ready`), зі стабільно названим завданням **AI review gate** для захисту гілки та необов'язковою міткою пропуску `skip-review-label: skip-ai-review`. Спільний `prompt.md` + розширення вирівнює методологію та серйозність; при ітераційно-усвідомленому огляді раунди CI 2+ можуть бути коротшими, тоді як локальний прохід залишається повним. + +### Необов'язковий супутник `apply-review` + +Після того, як CI публікує огляд, розробник може викликати `apply-review` під час `execute`, щоб переглянути знахідки по одній (застосувати / відкласти / пропустити) зі згоди. За замовчуванням лише читання; ніколи не є файлом завдання плану (порушить обов'язковий порядок фінальних завдань). + +## Поведінка + +- **Запитуйте про потік; ніколи не вгадуйте.** Встановлення незапитаного робочого процесу має більший слід, ніж залишатися на Flow A. +- **Узгоджуйте, не перезаписуйте.** Існуючий skill, розширення або `pr-review.yml` зберігаються; заповнюйте лише прогалини. +- **Автентифікація відкладена.** Секрети провайдера для CI налаштовує супроводжувач; цей додаток ніколи не зберігає облікові дані. +- **Нейтральний щодо провайдера.** Відмова залишає повністю AI-first репозиторій. + +## Примітки + +Необов'язковий і ніколи не потрібний. Вихідний skill: [DailybotHQ/ai-diff-reviewer](https://github.com/DailybotHQ/ai-diff-reviewer). Сторінка специфікації: [Add-ons](/spec/addons). diff --git a/src/content/kit/uk/dailybot.md b/src/content/kit/uk/dailybot.md index 2e9d49e..61e1daa 100644 --- a/src/content/kit/uk/dailybot.md +++ b/src/content/kit/uk/dailybot.md @@ -124,7 +124,7 @@ Payload походять із шару стану плану (`state.json`), я ## Потік онбордингу -Під час DWP `onboard` у **Phase 7b**, після основного AI-first scaffolding, потік пропонує чотири опційні аддони. Якщо розробник приймає Dailybot: +Під час DWP `onboard` у **Phase 7b**, після основного AI-first scaffolding, потік пропонує п'ять опційних аддонів. Якщо розробник приймає Dailybot: 1. Виявити наявне налаштування (скіл, CLI, `.dailybot/profile.json`, хуки, крок звіту). 2. Запропонувати встановлення скілу/CLI через потоки згоди Dailybot. diff --git a/src/content/kit/vi/ai-diff-reviewer.md b/src/content/kit/vi/ai-diff-reviewer.md new file mode 100644 index 0000000..63dd05f --- /dev/null +++ b/src/content/kit/vi/ai-diff-reviewer.md @@ -0,0 +1,61 @@ +--- +title: AI Diff Reviewer +description: "Tiện ích bổ sung DWP tùy chọn: tăng cường Đánh giá Bảo mật bằng lượt kiểm tra cục bộ AI Diff Reviewer, cổng hợp nhất CI Flow B tùy chọn (v2), tệp mở rộng dùng chung và trợ lý apply-review." +kind: addon +lang: vi +order: 5 +--- + +# Tiện ích bổ sung AI Diff Reviewer + +Kết nối quá trình thực thi Deep Work Plan với **[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)** (được liệt kê trên marketplace là **"AI Diff Reviewer"**, phiên bản hiện tại **v2.0.0**) để nhiệm vụ cuối bắt buộc **Đánh giá Bảo mật** có thêm một đánh giá cục bộ có cấu trúc — phán quyết, bảng phát hiện và mức độ nghiêm trọng — và khi chọn Flow B, mọi pull request đều có thể được kiểm soát bởi cùng một đánh giá trên CI. Đây là tiện ích bổ sung **tùy chọn**; không bao giờ bắt buộc để đạt chuẩn AI-first. + +Phương pháp luận cốt lõi của Deep Work Plan có **không** phụ thuộc vào AI Diff Reviewer. Kho lưu trữ không có tiện ích bổ sung vẫn hoàn toàn tuân thủ. Chỉ cung cấp tiện ích bổ sung này khi nhà phát triển hoặc nhóm muốn chất lượng đánh giá có cấu trúc; không bao giờ cài đặt tự động cho tất cả mọi người. Luôn hỏi Flow A hay Flow B — không bao giờ đặt mặc định. + +## Khi nào sử dụng + +| Tín hiệu | Hành động | +|--------|--------| +| Nhóm muốn cổng hợp nhất CI với các phát hiện có cấu trúc | **Đề xuất Flow B** trong quá trình giới thiệu | +| Kho lưu trữ cá nhân hoặc thử nghiệm; đánh giá cục bộ trước khi đẩy là đủ | **Cung cấp Flow A** | +| Không muốn thêm bề mặt đánh giá | **Bỏ qua** — Đánh giá Bảo mật cơ sở vẫn áp dụng | + +## Hai luồng áp dụng + +| Luồng | Bạn nhận được gì | +|------|----------------| +| **A — chỉ cục bộ** | Skill tích hợp sẵn + `.review/extension.md` bắt buộc (qua `generate-extension`). Tăng cường Đánh giá Bảo mật bằng lượt kiểm tra cục bộ. Không có quy trình GitHub Actions. | +| **B — hai bề mặt** | Flow A cộng thêm `setup` ghi `.github/workflows/pr-review.yml` (Action `@v2`), cùng tệp mở rộng cho cục bộ và CI. Trợ lý `apply-review` tùy chọn sau khi CI đăng phát hiện. | + +Việc phát hiện để tăng cường Đánh giá Bảo mật yêu cầu **skill + tệp mở rộng** tại một trong các vị trí: `.review/extension.md`, `.github/ai-diff-reviewer/extension.md` hoặc `.github/ai-pr-reviewer/extension.md`. Skill đơn lẻ là chưa đủ. + +## Tiện ích bổ sung này kết nối gì (giới hạn theo thiết kế) + +Tiện ích bổ sung DWP **không** tái tạo trình đánh giá. Nó ủy quyền cài đặt, phương pháp luận, trình hướng dẫn CI, soạn thảo mở rộng, tạo bản nháp PR và hướng dẫn sau CI cho năm kỹ năng con của skill thượng nguồn (luồng mặc định gốc, `generate-extension`, `setup`, `open-pr`, `apply-review`). + +### Tăng cường Đánh giá Bảo mật + +Khi được phát hiện, `create` / `execute` thêm bước đánh giá cục bộ vào nhiệm vụ Đánh giá Bảo mật bắt buộc. Đầu ra được thêm vào bên dưới `## AI Diff Reviewer local review` trong `analysis_results/SECURITY_REVIEW.md`. + +- **Thất bại nhẹ (chỉ gọi):** thiếu skill, thiếu mở rộng hoặc lỗi gọi → cảnh báo một lần và tiếp tục; không bao giờ làm thất bại nhiệm vụ vì điều này. +- **Cổng sau khi lượt kiểm tra hoàn tất:** các phát hiện `critical` vẫn chặn việc hoàn thành Đánh giá Bảo mật cho đến khi được sửa hoặc chấp nhận rõ ràng (hợp đồng SR hiện có). `warning` / `info` được ghi lại nhưng không chặn. +- **Flow A không cần secret CI.** `CURSOR_API_KEY` chưa được đặt không được ức chế lượt kiểm tra cục bộ. + +### Cổng CI Flow B (tùy chọn) + +Action được ghim `DailybotHQ/ai-diff-reviewer@v2`, thường bị kiểm soát bởi nhãn (`ready`), với công việc **AI review gate** có tên ổn định để bảo vệ nhánh và nhãn bỏ qua tùy chọn `skip-review-label: skip-ai-review`. `prompt.md` dùng chung + mở rộng căn chỉnh phương pháp luận và mức độ nghiêm trọng; trong Đánh giá Nhận thức Lặp lại, các vòng CI thứ 2 trở đi có thể ngắn hơn trong khi lượt kiểm tra cục bộ vẫn đầy đủ. + +### Trợ lý `apply-review` tùy chọn + +Sau khi CI đăng đánh giá, nhà phát triển có thể gọi `apply-review` trong `execute` để xem xét từng phát hiện (áp dụng / trì hoãn / bỏ qua) với sự đồng ý. Chỉ đọc theo mặc định; không bao giờ là tệp nhiệm vụ kế hoạch (sẽ phá vỡ thứ tự nhiệm vụ cuối bắt buộc). + +## Hành vi + +- **Hỏi luồng; không bao giờ đoán.** Cài đặt quy trình không được yêu cầu có dấu ấn lớn hơn so với ở lại Flow A. +- **Hòa giải, không ghi đè.** Skill, mở rộng hoặc `pr-review.yml` hiện có được bảo toàn; chỉ lấp đầy khoảng trống. +- **Xác thực được trì hoãn.** Secret của nhà cung cấp cho CI được cấu hình bởi người bảo trì; tiện ích bổ sung này không bao giờ lưu thông tin đăng nhập. +- **Trung lập với nhà cung cấp.** Từ chối vẫn để lại kho lưu trữ hoàn toàn AI-first. + +## Ghi chú + +Tùy chọn và không bao giờ bắt buộc. Skill thượng nguồn: [DailybotHQ/ai-diff-reviewer](https://github.com/DailybotHQ/ai-diff-reviewer). Trang spec: [Add-ons](/spec/addons). diff --git a/src/content/kit/vi/dailybot.md b/src/content/kit/vi/dailybot.md index 0f8a2e4..01c4e37 100644 --- a/src/content/kit/vi/dailybot.md +++ b/src/content/kit/vi/dailybot.md @@ -124,7 +124,7 @@ Tham chiếu công khai: [dailybot.com/skill.md](https://www.dailybot.com/skill. ## Luồng onboarding -Trong DWP `onboard` **Giai đoạn 7b**, sau scaffolding AI-first cốt lõi, luồng đề xuất bốn addon opt-in. Nếu nhà phát triển chấp nhận Dailybot: +Trong DWP `onboard` **Giai đoạn 7b**, sau scaffolding AI-first cốt lõi, luồng đề xuất năm addon opt-in. Nếu nhà phát triển chấp nhận Dailybot: 1. Phát hiện thiết lập hiện có (skill, CLI, `.dailybot/profile.json`, hook, bước báo cáo). 2. Đề xuất cài skill/CLI qua luồng đồng ý của Dailybot. diff --git a/src/content/kit/zh/ai-diff-reviewer.md b/src/content/kit/zh/ai-diff-reviewer.md new file mode 100644 index 0000000..d5788dc --- /dev/null +++ b/src/content/kit/zh/ai-diff-reviewer.md @@ -0,0 +1,61 @@ +--- +title: AI Diff Reviewer +description: "可选 DWP 附加组件:通过本地 AI Diff Reviewer 通道增强安全审查,可选 Flow B CI 合并门控(v2),共享扩展文件及 apply-review 伴随工具。" +kind: addon +lang: zh +order: 5 +--- + +# AI Diff Reviewer 附加组件 + +将 Deep Work Plan 的执行连接到 **[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)**(marketplace 上的 **"AI Diff Reviewer"**,当前版本 **v2.0.0**),使强制性最终任务**安全审查**获得结构化的本地审查——裁决、结果表和严重程度——并且在选择 Flow B 时,每个 pull request 都可以在 CI 中受到同样审查的门控。这是一个**可选**附加组件,从不要求用于 AI-first 符合性。 + +Deep Work Plan 的核心方法论对 AI Diff Reviewer 有**零**依赖。零附加组件的仓库完全符合规范。仅当开发者或团队希望获得结构化的审查质量时才提供此附加组件;绝不为所有人自动安装。始终询问 Flow A 还是 Flow B——绝不假设默认值。 + +## 何时使用 + +| 信号 | 操作 | +|--------|--------| +| 团队希望在 CI 中有结构化结果的 PR 合并门控 | 在接入时**推荐 Flow B** | +| 个人或实验性仓库;本地预推送审查已足够 | **提供 Flow A** | +| 不希望增加额外的审查层面 | **跳过** — 基础安全审查仍然适用 | + +## 两种采用流程 + +| 流程 | 获得内容 | +|------|----------------| +| **A — 仅限本地** | 内嵌 skill + 必需的 `.review/extension.md`(通过 `generate-extension`)。使用本地通道增强安全审查。无 GitHub Actions 工作流。 | +| **B — 双层面** | Flow A 加上 `setup` 写入 `.github/workflows/pr-review.yml`(Action `@v2`),本地和 CI 使用相同的扩展文件。CI 发布结果后可选 `apply-review` 伴随工具。 | + +安全审查增强的检测需要**skill + 扩展文件**,位于以下之一:`.review/extension.md`、`.github/ai-diff-reviewer/extension.md` 或 `.github/ai-pr-reviewer/extension.md`。仅 skill 本身是不够的。 + +## 此附加组件连接的内容(有意限制范围) + +DWP 附加组件**不**重新发明审查器。它将安装、方法论、CI 向导、扩展创作、PR 草稿及 CI 后遍历委托给上游 skill 的五个子技能(父级默认流、`generate-extension`、`setup`、`open-pr`、`apply-review`)。 + +### 安全审查增强 + +检测到时,`create` / `execute` 会向强制性安全审查任务添加本地审查步骤。输出追加在 `analysis_results/SECURITY_REVIEW.md` 的 `## AI Diff Reviewer local review` 下。 + +- **软失败(仅调用):** skill 缺失、扩展缺失或调用错误 → 警告一次并继续;绝不因此使任务失败。 +- **完整通道后的门控:** `critical` 结果仍然阻止安全审查完成,直到修复或明确接受(现有 SR 合同)。`warning` / `info` 已记录但不阻塞。 +- **Flow A 不需要 CI 密钥。** 未设置的 `CURSOR_API_KEY` 不得抑制本地通道。 + +### Flow B CI 门控(可选) + +固定 Action `DailybotHQ/ai-diff-reviewer@v2`,通常由标签门控(`ready`),带有用于分支保护的稳定命名 **AI review gate** 作业,以及可选跳过标签 `skip-review-label: skip-ai-review`。共享的 `prompt.md` + 扩展对齐方法论和严重程度;在迭代感知审查下,CI 第 2+ 轮可能更短,而本地通道保持完整。 + +### 可选 `apply-review` 伴随工具 + +CI 发布审查后,开发者可以在 `execute` 期间调用 `apply-review` 逐项遍历结果(应用 / 延迟 / 跳过),需获得同意。默认只读;绝不作为计划任务文件(会破坏强制性最终任务顺序)。 + +## 行为 + +- **询问流程;绝不猜测。** 未经请求安装工作流的代价大于保持在 Flow A。 +- **调和,不覆盖。** 现有 skill、扩展或 `pr-review.yml` 均被保留;仅填补空缺。 +- **认证延后。** CI 的提供商密钥由维护者配置;此附加组件绝不存储凭据。 +- **供应商中立。** 拒绝后仍留有完全 AI-first 的仓库。 + +## 注意事项 + +可选且从不要求。上游 skill:[DailybotHQ/ai-diff-reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)。规格页面:[Add-ons](/spec/addons)。 diff --git a/src/content/kit/zh/dailybot.md b/src/content/kit/zh/dailybot.md index 56f37f8..ff6639e 100644 --- a/src/content/kit/zh/dailybot.md +++ b/src/content/kit/zh/dailybot.md @@ -124,7 +124,7 @@ DWP Dailybot 附加组件**不会**重新发明 Dailybot。它将计划执行连 ## 接入流程 -在 DWP `onboard` **第 7b 阶段**,核心 AI-first 脚手架完成后,流程提供四个可选附加组件。若开发者接受 Dailybot: +在 DWP `onboard` **第 7b 阶段**,核心 AI-first 脚手架完成后,流程提供五个可选附加组件。若开发者接受 Dailybot: 1. 检测现有设置(技能、CLI、`.dailybot/profile.json`、钩子、报告步骤)。 2. 通过 Dailybot 的同意流程提供技能/CLI 安装。 diff --git a/src/content/pages/de/init.md b/src/content/pages/de/init.md index 8058188..94bb821 100644 --- a/src/content/pages/de/init.md +++ b/src/content/pages/de/init.md @@ -129,8 +129,8 @@ Methodik angleichen), statt es zu überschreiben — und bestätigen Sie mit dem ## 4. Die Opt-in-Addons anbieten -Nach dem Baseline-Onboarding zählen Sie die vier Addons auf (devcontainer, Dailybot, dependency-upgrade, -design-system) und bieten Sie jedes als explizites Opt-in an. Ein Repository ist +Nach dem Baseline-Onboarding zählen Sie die fünf Addons auf (devcontainer, Dailybot, dependency-upgrade, +design-system, AI Diff Reviewer) und bieten Sie jedes als explizites Opt-in an. Ein Repository ist mit **null** Addons vollständig konform — installieren Sie sie niemals automatisch. - **Devcontainer-Unterstützung** — ein reproduzierbarer, isolierter Dev-Container mit persistenter AI-CLI-Authentifizierung. @@ -141,6 +141,8 @@ mit **null** Addons vollständig konform — installieren Sie sie niemals automa (nicht angeboten für reine Bibliotheken, Headless-Dienste oder reine Infrastruktur-Repos). Drei Profile werden in einer Datei gestapelt: visual-ui (standardmäßig aktiviert bei Erkennung), cli-output und conversational — die letzten beiden werden immer gefragt, niemals automatisch angewendet. +- **AI Diff Reviewer** — erweitert die obligatorische Sicherheitsprüfung um eine strukturierte lokale Überprüfung + über [AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) **v2** (Skill + erforderliches `.review/extension.md`). Immer **Flow A** (nur lokal) vs. **Flow B** (dualer CI-Gate mit `pr-review.yml`) fragen; niemals Standard setzen. Soft-Fail nur bei fehlenden Skill/Erweiterungs/Aufruffehlern; `critical`-Ergebnisse eines abgeschlossenen lokalen Durchlaufs blockieren weiterhin die Fertigstellung der Sicherheitsprüfung. Die zentrale Methodik hat keine AI Diff Reviewer-Abhängigkeit. ## 5. Das Kit weiterentwickeln (author-Sub-Skill) diff --git a/src/content/pages/de/kit.md b/src/content/pages/de/kit.md index 1b880ae..3749454 100644 --- a/src/content/pages/de/kit.md +++ b/src/content/pages/de/kit.md @@ -52,6 +52,7 @@ Optionale Fähigkeiten, die der onboard-Ablauf einem Repository hinzufügen kann - **Dailybot** — Best-Effort-Berichterstattung über Fortschritte und Meilensteine für Teams, die Dailybot nutzen. - **Dependency-Upgrade** — paketmanager-agnostische, chargenweise, validierte, rücknehmbare Upgrades. - **Design system** — eine interface-bezogene `DESIGN.md` (unter `docs/DESIGN.md`, von `AGENTS.md` referenziert), die aus der echten Designquelle des Repos abgeleitet wird, mit Profilen für visuelle UI, gestylte CLI-Ausgabe und konversationales Messaging, damit Agenten markenkonforme Interface-Ausgaben erzeugen; das visuelle Profil ist standardmäßig aktiv, wenn ein Designsystem erkannt wird, die CLI- und konversationalen Profile werden bei Erkennung empfohlen und stets erfragt. +- **AI Diff Reviewer** — ergänzt den Security Review um eine strukturierte lokale Überprüfung ([AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) v2 + erforderliche `.review/extension.md`); das optionale Flow B fügt ein CI-PR-Merge-Gate hinzu, das dieselbe Extension teilt. Immer Flow A vs Flow B fragen; niemals automatisch installieren. ### Beispiele diff --git a/src/content/pages/de/quickstart.md b/src/content/pages/de/quickstart.md index f45492f..95b0d0c 100644 --- a/src/content/pages/de/quickstart.md +++ b/src/content/pages/de/quickstart.md @@ -42,8 +42,8 @@ Es erzeugt `AGENTS.md`, eine `docs/`-Wissensbasis, Dokumentation je Modul und ei ### 3. Das Kit weiterentwickeln und Addons annehmen Nutzen Sie `/skill-create` und `/agent-create` (die author-Sub-Skill), um stack-passende Skills, -Agenten und Befehle aufzubauen. Das Onboarding bietet außerdem vier Opt-in-Addons — devcontainer, Dailybot, -dependency-upgrade und design-system —, die Sie nur annehmen, wenn sie passen. Ein Repository ist mit null Addons vollständig konform. +Agenten und Befehle aufzubauen. Das Onboarding bietet außerdem fünf Opt-in-Addons — devcontainer, Dailybot, +dependency-upgrade, design-system und AI Diff Reviewer —, die Sie nur annehmen, wenn sie passen. Ein Repository ist mit null Addons vollständig konform. ### 4. Planen und ausführen diff --git a/src/content/pages/en/init.md b/src/content/pages/en/init.md index 8da7b9f..58d5d40 100644 --- a/src/content/pages/en/init.md +++ b/src/content/pages/en/init.md @@ -142,9 +142,9 @@ methodology) instead of overwriting — and confirm with the user before replaci ## 4. Offer the opt-in addons -After the baseline onboarding, enumerate the four addons (devcontainer, Dailybot, dependency-upgrade, -design-system) and offer each as an explicit opt-in. A repository is fully conformant with **zero** -addons — never auto-install them. +After the baseline onboarding, enumerate the five addons (devcontainer, Dailybot, dependency-upgrade, +design-system, AI Diff Reviewer) and offer each as an explicit opt-in. A repository is fully +conformant with **zero** addons — never auto-install them. - **Devcontainer support** — a reproducible, isolated dev container with persistent AI-CLI auth. - **Dailybot integration** — four lifecycle events (kickoff, significant task, blocked, completion) as best-effort progress reports for teams already using Dailybot, with optional autonomous hook enforcement (`dailybot-cli >= 3.7.0`). Installing the paired Dailybot agent skill (3.10.3) also exposes chat, check-ins, forms authoring, ask AI, per-repo API keys, and more — the addon wires only reporting into DWP execution. The core methodology has zero Dailybot dependency. @@ -154,6 +154,12 @@ addons — never auto-install them. (not offered for pure libraries, headless services, or infra-only repos). Three profiles stack in one file: visual-ui (default-on when detected), cli-output, and conversational — the latter two are always asked, never auto-applied. +- **AI Diff Reviewer** — augments the mandatory Security Review with a structured local review via + [AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) **v2** (skill + required + `.review/extension.md`). Always ask **Flow A** (local-only) vs **Flow B** (dual-surface CI gate + with `pr-review.yml`); never default. Soft-fail only on missing skill/extension/invocation errors; + `critical` findings from a completed local pass still block Security Review completion. The core + methodology has zero AI Diff Reviewer dependency. ## 5. Evolve the kit (author sub-skill) diff --git a/src/content/pages/en/kit.md b/src/content/pages/en/kit.md index 7f012bd..22d4abe 100644 --- a/src/content/pages/en/kit.md +++ b/src/content/pages/en/kit.md @@ -1,7 +1,7 @@ --- title: "The Deep Work Plan Kit" description: "The skill and its eight sub-skills, commands, agent adapters, onboarding presets, opt-in add-ons, and examples that make Deep Work Plan runnable anywhere." -lastUpdated: 2026-05-31 +lastUpdated: 2026-07-16 --- ## The Deep Work Plan Kit @@ -52,6 +52,7 @@ Optional capabilities the onboard flow can layer onto a repo — never part of t - **Dailybot** — plan-lifecycle reporting (kickoff, significant task, blocked, completion) for teams using Dailybot, plus access to the full Dailybot agent skill (3.10.3: chat, check-ins, forms, ask AI, per-repo API keys, and more). - **Dependency upgrade** — package-manager-agnostic, batched, validated, revertible upgrades. - **Design system** — an interface-scoped `DESIGN.md` (at `docs/DESIGN.md`, referenced from `AGENTS.md`) reasoned from the repo's real design source, with profiles for visual UI, styled CLI output, and conversational messaging, so agents generate on-brand interface output; the visual profile is default-on when a design system is detected, the CLI and conversational profiles are recommended when detected and always asked about. +- **AI Diff Reviewer** — augments Security Review with a structured local review ([AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) v2 + required `.review/extension.md`); optional Flow B adds a CI PR merge gate sharing the same extension. Always ask Flow A vs Flow B; never auto-install. ### Examples diff --git a/src/content/pages/en/quickstart.md b/src/content/pages/en/quickstart.md index b82044c..611cb2c 100644 --- a/src/content/pages/en/quickstart.md +++ b/src/content/pages/en/quickstart.md @@ -42,8 +42,8 @@ It generates `AGENTS.md`, a `docs/` knowledge base, per-module docs, and a cross ### 3. Evolve the kit and accept addons Use `/skill-create` and `/agent-create` (the author sub-skill) to grow stack-appropriate skills, -agents, and commands. Onboarding also offers four opt-in addons — devcontainer, Dailybot, -dependency-upgrade, and design-system — that you accept only when they fit. A repo is fully conformant with zero addons. +agents, and commands. Onboarding also offers five opt-in addons — devcontainer, Dailybot, +dependency-upgrade, design-system, and AI Diff Reviewer — that you accept only when they fit. A repo is fully conformant with zero addons. ### 4. Plan and execute diff --git a/src/content/pages/es/init.md b/src/content/pages/es/init.md index e7b0560..a489fd4 100644 --- a/src/content/pages/es/init.md +++ b/src/content/pages/es/init.md @@ -143,9 +143,9 @@ metodología) en vez de sobrescribir — y confirma con el usuario antes de reem ## 4. Ofrece los addons opcionales -Tras la incorporación base, enumera los cuatro addons (devcontainer, Dailybot, dependency-upgrade, -design-system) y ofrece cada uno como una opción explícita. Un repositorio es totalmente conforme con -**cero** addons — nunca los instales automáticamente. +Tras la incorporación base, enumera los cinco addons (devcontainer, Dailybot, dependency-upgrade, +design-system, AI Diff Reviewer) y ofrece cada uno como una opción explícita. Un repositorio es +totalmente conforme con **cero** addons — nunca los instales automáticamente. - **Soporte de devcontainer** — un contenedor de desarrollo reproducible y aislado con autenticación de CLI de IA persistente. @@ -156,6 +156,8 @@ design-system) y ofrece cada uno como una opción explícita. Un repositorio es (no se ofrece para bibliotecas puras, servicios headless o repos solo de infra). Tres perfiles se apilan en un archivo: visual-ui (activado por defecto al detectarse), cli-output y conversacional — estos dos últimos siempre se preguntan, nunca se aplican automáticamente. +- **AI Diff Reviewer** — amplía la Revisión de Seguridad obligatoria con una revisión local estructurada + mediante [AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) **v2** (skill + `.review/extension.md` requerido). Pregunta siempre **Flujo A** (solo local) vs **Flujo B** (compuerta CI de doble superficie con `pr-review.yml`); nunca elijas por defecto. Fallo suave solo para errores de skill/extensión/invocación ausentes; los hallazgos `critical` de un pase local completado siguen bloqueando la finalización de la Revisión de Seguridad. La metodología central tiene cero dependencia de AI Diff Reviewer. ## 5. Haz evolucionar el kit (sub-skill author) diff --git a/src/content/pages/es/kit.md b/src/content/pages/es/kit.md index 2acc7a1..0ec53a7 100644 --- a/src/content/pages/es/kit.md +++ b/src/content/pages/es/kit.md @@ -57,6 +57,7 @@ AI-first: - **Dailybot** — reportes de avance e hitos de mejor esfuerzo para equipos que usan Dailybot. - **Actualización de dependencias** — actualizaciones agnósticas del gestor de paquetes, por lotes, validadas y reversibles. - **Sistema de diseño** — un `DESIGN.md` con alcance de interfaz (en `docs/DESIGN.md`, referenciado desde `AGENTS.md`) razonado a partir de la fuente de diseño real del repo, con perfiles para UI visual, salida de CLI con estilo y mensajería conversacional, para que los agentes generen salida de interfaz fiel a la marca; el perfil visual está activado por defecto cuando se detecta un sistema de diseño, y los perfiles de CLI y conversacional se recomiendan cuando se detectan y siempre se preguntan. +- **AI Diff Reviewer** — amplía la Revisión de Seguridad con una revisión local estructurada ([AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) v2 + `.review/extension.md` requerido); el Flujo B opcional añade una compuerta de fusión de PR en CI que comparte la misma extensión. Siempre preguntar Flujo A vs Flujo B; nunca instalar automáticamente. ### Ejemplos diff --git a/src/content/pages/es/quickstart.md b/src/content/pages/es/quickstart.md index 3308497..804f544 100644 --- a/src/content/pages/es/quickstart.md +++ b/src/content/pages/es/quickstart.md @@ -43,8 +43,8 @@ tu repositorio. ### 3. Evoluciona el kit y acepta addons Usa `/skill-create` y `/agent-create` (la sub-skill author) para hacer crecer skills, agentes y -comandos adaptados a tu stack. La incorporación también ofrece cuatro addons opcionales — devcontainer, -Dailybot, dependency-upgrade y design-system — que aceptas solo cuando encajan. Un repo es plenamente conforme con +comandos adaptados a tu stack. La incorporación también ofrece cinco addons opcionales — devcontainer, +Dailybot, dependency-upgrade, design-system y AI Diff Reviewer — que aceptas solo cuando encajan. Un repo es plenamente conforme con cero addons. ### 4. Planifica y ejecuta diff --git a/src/content/pages/fr/init.md b/src/content/pages/fr/init.md index 0549276..6c3d2f3 100644 --- a/src/content/pages/fr/init.md +++ b/src/content/pages/fr/init.md @@ -142,8 +142,8 @@ méthodologie) au lieu d’écraser — et confirmez avec l’utilisateur avant ## 4. Proposer les addons facultatifs -Après l’onboarding de base, énumérez les quatre addons (devcontainer, Dailybot, dependency-upgrade, -design-system) et proposez chacun comme un choix explicite. Un dépôt est +Après l’onboarding de base, énumérez les cinq addons (devcontainer, Dailybot, dependency-upgrade, +design-system, AI Diff Reviewer) et proposez chacun comme un choix explicite. Un dépôt est pleinement conforme avec **zéro** addon — ne les installez jamais automatiquement. - **Prise en charge du devcontainer** — un conteneur de développement reproductible et isolé avec une auth de CLI IA persistante. @@ -155,6 +155,8 @@ pleinement conforme avec **zéro** addon — ne les installez jamais automatique exclusivement infra). Trois profils s’empilent dans un seul fichier : visual-ui (activé par défaut lorsque détecté), cli-output et conversational — ces deux derniers sont toujours demandés, jamais appliqués automatiquement. +- **AI Diff Reviewer** — renforce la Revue de sécurité obligatoire avec une revue locale structurée + via [AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) **v2** (skill + `.review/extension.md` requis). Demandez toujours **Flow A** (local uniquement) vs **Flow B** (portail CI double surface avec `pr-review.yml`) ; ne jamais supposer. Échec doux uniquement pour les erreurs de skill/extension/invocation manquantes ; les résultats `critical` d'un passage local terminé bloquent toujours la finalisation de la Revue de sécurité. La méthodologie de base a zéro dépendance envers AI Diff Reviewer. ## 5. Faire évoluer le kit (sous-skill author) diff --git a/src/content/pages/fr/kit.md b/src/content/pages/fr/kit.md index ed61e69..98ab606 100644 --- a/src/content/pages/fr/kit.md +++ b/src/content/pages/fr/kit.md @@ -52,6 +52,7 @@ Des capacités optionnelles que le flux onboard peut superposer à un dépôt - **Dailybot** — un rapport de progression et de jalons au mieux pour les équipes utilisant Dailybot. - **Dependency upgrade** — des mises à jour indépendantes du gestionnaire de paquets, par lots, validées et réversibles. - **Système de conception** — un `DESIGN.md` à périmètre d'interface (à `docs/DESIGN.md`, référencé depuis `AGENTS.md`) raisonné à partir de la véritable source de conception du dépôt, avec des profils pour l'UI visuelle, la sortie CLI stylée et la messagerie conversationnelle, afin que les agents génèrent une sortie d'interface fidèle à la marque ; le profil visuel est activé par défaut lorsqu'un système de conception est détecté, et les profils CLI et conversationnel sont recommandés lorsqu'ils sont détectés et toujours soumis à une question. +- **AI Diff Reviewer** — renforce la Revue de sécurité avec une revue locale structurée ([AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) v2 + `.review/extension.md` requis) ; le Flow B optionnel ajoute un point de contrôle de fusion de PR en CI partageant la même extension. Toujours demander Flow A vs Flow B ; jamais auto-installer. ### Exemples diff --git a/src/content/pages/fr/quickstart.md b/src/content/pages/fr/quickstart.md index 4efe35b..a084f99 100644 --- a/src/content/pages/fr/quickstart.md +++ b/src/content/pages/fr/quickstart.md @@ -42,8 +42,8 @@ ignoré par git pour les plans et les ébauches. Rien n’est issu d’un modèl ### 3. Faire évoluer le kit et accepter des addons Utilisez `/skill-create` et `/agent-create` (le sous-skill author) pour faire grandir des skills, agents et -commandes adaptés à votre stack. L’onboarding propose aussi quatre addons facultatifs — devcontainer, Dailybot, -dependency-upgrade et design-system — que vous acceptez seulement lorsqu’ils conviennent. Un dépôt est pleinement conforme avec zéro addon. +commandes adaptés à votre stack. L’onboarding propose aussi cinq addons facultatifs — devcontainer, Dailybot, +dependency-upgrade, design-system et AI Diff Reviewer — que vous acceptez seulement lorsqu’ils conviennent. Un dépôt est pleinement conforme avec zéro addon. ### 4. Planifier et exécuter diff --git a/src/content/pages/hi/init.md b/src/content/pages/hi/init.md index 7cfe98f..253c1ff 100644 --- a/src/content/pages/hi/init.md +++ b/src/content/pages/hi/init.md @@ -137,7 +137,7 @@ onboard सब-स्किल (`/deepworkplan-onboard`) आमंत्रि ## 4. ऑप्ट-इन ऐडऑन प्रस्तुत करें -आधाररेखा ऑनबोर्डिंग के बाद, चार ऐडऑन (devcontainer, Dailybot, dependency-upgrade, design-system) गिनाएँ +आधाररेखा ऑनबोर्डिंग के बाद, पाँच ऐडऑन (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer) गिनाएँ और हर एक को एक स्पष्ट ऑप्ट-इन के रूप में प्रस्तुत करें। एक रिपॉज़िटरी **शून्य** ऐडऑन के साथ पूर्णतः अनुरूप होती है — इन्हें कभी स्वतः-स्थापित न करें। @@ -149,6 +149,7 @@ onboard सब-स्किल (`/deepworkplan-onboard`) आमंत्रि (शुद्ध लाइब्रेरी, हेडलेस सेवाओं, या केवल-इन्फ़्रा रिपॉज़िटरी के लिए प्रस्तुत नहीं)। तीन प्रोफ़ाइल एक फ़ाइल में स्तरित होती हैं: visual-ui (पता लगाने पर डिफ़ॉल्ट-ऑन), cli-output और संवादात्मक — अंतिम दो सदैव पूछे जाते हैं, कभी स्वतः-लागू नहीं। +- **AI Diff Reviewer** — अनिवार्य सुरक्षा समीक्षा को [AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) **v2** (skill + आवश्यक `.review/extension.md`) के माध्यम से संरचित स्थानीय समीक्षा से मज़बूत करता है। हमेशा **Flow A** (केवल स्थानीय) बनाम **Flow B** (दोहरी-सतह CI गेट, `pr-review.yml`) पूछें; कभी डिफ़ॉल्ट न मानें। केवल गुम skill/एक्सटेंशन/इनवोकेशन त्रुटियों के लिए सॉफ्ट-फेल; पूर्ण स्थानीय पास के `critical` निष्कर्ष अब भी सुरक्षा समीक्षा पूर्णता को ब्लॉक करते हैं। मूल पद्धति की AI Diff Reviewer पर शून्य निर्भरता है। ## 5. किट विकसित करें (author सब-स्किल) diff --git a/src/content/pages/hi/kit.md b/src/content/pages/hi/kit.md index bca0f1b..56c0b09 100644 --- a/src/content/pages/hi/kit.md +++ b/src/content/pages/hi/kit.md @@ -49,6 +49,7 @@ Claude Code, Cursor, OpenAI Codex, GitHub Copilot, Google Gemini, OpenCode, Wind - **Dailybot** — Dailybot का उपयोग करने वाली टीमों के लिए सर्वोत्तम-प्रयास प्रगति और मील-पत्थर रिपोर्टिंग। - **Dependency upgrade** — पैकेज-मैनेजर-निरपेक्ष, बैच-आधारित, सत्यापित, वापस लेने योग्य अपग्रेड। - **Design system** — रिपॉज़िटरी के वास्तविक डिज़ाइन स्रोत से तर्क की गई एक इंटरफ़ेस-दायरे वाली `DESIGN.md` (`docs/DESIGN.md` पर, `AGENTS.md` से संदर्भित), विज़ुअल UI, शैलीबद्ध CLI आउटपुट और संवादात्मक संदेशों के लिए प्रोफ़ाइलों के साथ, ताकि एजेंट ऑन-ब्रांड इंटरफ़ेस आउटपुट बनाएँ; एक डिज़ाइन सिस्टम का पता चलने पर विज़ुअल प्रोफ़ाइल डिफ़ॉल्ट-ऑन है, CLI और संवादात्मक प्रोफ़ाइल पता चलने पर अनुशंसित हैं और हमेशा पूछे जाते हैं। +- **AI Diff Reviewer** — Security Review को संरचित स्थानीय समीक्षा ([AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) v2 + आवश्यक `.review/extension.md`) से मज़बूत करता है; वैकल्पिक Flow B उसी extension को साझा करने वाला CI PR मर्ज गेट जोड़ता है। हमेशा Flow A vs Flow B पूछें; कभी स्वतः-इंस्टॉल न करें। ### उदाहरण diff --git a/src/content/pages/hi/quickstart.md b/src/content/pages/hi/quickstart.md index e248d90..6ba7579 100644 --- a/src/content/pages/hi/quickstart.md +++ b/src/content/pages/hi/quickstart.md @@ -36,7 +36,7 @@ onboard सब-स्किल चलाएँ और एजेंट को अ ### 3. किट विकसित करें और ऐडऑन स्वीकार करें -स्टैक-उपयुक्त स्किल्स, एजेंट्स और कमांड्स विकसित करने के लिए `/skill-create` और `/agent-create` (author सब-स्किल) का उपयोग करें। ऑनबोर्डिंग चार ऑप्ट-इन ऐडऑन भी प्रदान करती है — devcontainer, Dailybot, dependency-upgrade, और design-system — जिन्हें आप तभी स्वीकार करते हैं जब वे उपयुक्त हों। एक रिपॉज़िटरी शून्य ऐडऑन के साथ पूर्णतः अनुरूप होती है। +स्टैक-उपयुक्त स्किल्स, एजेंट्स और कमांड्स विकसित करने के लिए `/skill-create` और `/agent-create` (author सब-स्किल) का उपयोग करें। ऑनबोर्डिंग पाँच ऑप्ट-इन ऐडऑन भी प्रदान करती है — devcontainer, Dailybot, dependency-upgrade, design-system और AI Diff Reviewer — जिन्हें आप तभी स्वीकार करते हैं जब वे उपयुक्त हों। एक रिपॉज़िटरी शून्य ऐडऑन के साथ पूर्णतः अनुरूप होती है। ### 4. योजना बनाएँ और निष्पादित करें diff --git a/src/content/pages/id/init.md b/src/content/pages/id/init.md index 57043c8..502fc66 100644 --- a/src/content/pages/id/init.md +++ b/src/content/pages/id/init.md @@ -141,8 +141,8 @@ metodologi) alih-alih menimpa — dan konfirmasikan dengan pengguna sebelum meng ## 4. Tawarkan addon opt-in -Setelah onboarding dasar, sebutkan keempat addon (devcontainer, Dailybot, dependency-upgrade, -design-system) dan tawarkan masing-masing sebagai opt-in eksplisit. Sebuah repositori sepenuhnya +Setelah onboarding dasar, sebutkan kelima addon (devcontainer, Dailybot, dependency-upgrade, +design-system, AI Diff Reviewer) dan tawarkan masing-masing sebagai opt-in eksplisit. Sebuah repositori sepenuhnya konforman dengan **nol** addon — jangan pernah memasangnya secara otomatis. - **Dukungan devcontainer** — kontainer pengembangan yang terisolasi dan dapat direproduksi dengan autentikasi AI-CLI yang persisten. @@ -154,6 +154,8 @@ konforman dengan **nol** addon — jangan pernah memasangnya secara otomatis. infrastruktur). Tiga profil ditumpuk dalam satu berkas: visual-ui (aktif secara default saat terdeteksi), cli-output, dan conversational — dua yang terakhir selalu ditanyakan, tidak pernah diterapkan secara otomatis. +- **AI Diff Reviewer** — meningkatkan Tinjauan Keamanan wajib dengan tinjauan lokal terstruktur + melalui [AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) **v2** (skill + `.review/extension.md` wajib). Selalu tanyakan **Flow A** (hanya lokal) vs **Flow B** (gerbang CI ganda dengan `pr-review.yml`); jangan pernah mengasumsikan nilai default. Kegagalan lunak hanya untuk kesalahan skill/ekstensi/pemanggilan yang hilang; hasil `critical` dari penerusan lokal yang selesai masih memblokir penyelesaian Tinjauan Keamanan. Metodologi inti memiliki nol ketergantungan pada AI Diff Reviewer. ## 5. Kembangkan kit (sub-skill author) diff --git a/src/content/pages/id/kit.md b/src/content/pages/id/kit.md index bcfc639..8abd929 100644 --- a/src/content/pages/id/kit.md +++ b/src/content/pages/id/kit.md @@ -53,6 +53,7 @@ Kemampuan opsional yang dapat ditambahkan alur onboard ke sebuah repo — tidak - **Dailybot** — pelaporan kemajuan dan milestone secara best-effort untuk tim yang memakai Dailybot. - **Dependency upgrade** — peningkatan yang agnostik terhadap package manager, terkelompok, tervalidasi, dan dapat dikembalikan. - **Sistem desain** — sebuah `DESIGN.md` bercakupan antarmuka (di `docs/DESIGN.md`, dirujuk dari `AGENTS.md`) yang dinalar dari sumber desain nyata repo, dengan profil untuk UI visual, output CLI yang bergaya, dan perpesanan percakapan, sehingga agent menghasilkan keluaran antarmuka yang sesuai brand; profil visual aktif secara default ketika sebuah sistem desain terdeteksi, profil CLI dan percakapan direkomendasikan ketika terdeteksi dan selalu ditanyakan. +- **AI Diff Reviewer** — meningkatkan Security Review dengan tinjauan lokal terstruktur ([AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) v2 + `.review/extension.md` wajib); Flow B opsional menambahkan gerbang merge PR CI yang berbagi ekstensi yang sama. Selalu tanyakan Flow A vs Flow B; jangan pernah instal otomatis. ### Contoh diff --git a/src/content/pages/id/quickstart.md b/src/content/pages/id/quickstart.md index 622af81..6c750a8 100644 --- a/src/content/pages/id/quickstart.md +++ b/src/content/pages/id/quickstart.md @@ -42,8 +42,8 @@ yang di-gitignore untuk rencana dan draf. Tidak ada yang ditemplatkan; semuanya ### 3. Kembangkan kit dan terima addon Gunakan `/skill-create` dan `/agent-create` (sub-skill author) untuk menumbuhkan skill, agent, dan command -yang sesuai stack. Onboarding juga menawarkan empat addon opt-in — devcontainer, Dailybot, -dependency-upgrade, dan design-system — yang Anda terima hanya ketika cocok. Sebuah repo sepenuhnya konforman dengan nol addon. +yang sesuai stack. Onboarding juga menawarkan lima addon opt-in — devcontainer, Dailybot, +dependency-upgrade, design-system, dan AI Diff Reviewer — yang Anda terima hanya ketika cocok. Sebuah repo sepenuhnya konforman dengan nol addon. ### 4. Rencanakan dan eksekusi diff --git a/src/content/pages/it/init.md b/src/content/pages/it/init.md index 3113b90..bad8fe3 100644 --- a/src/content/pages/it/init.md +++ b/src/content/pages/it/init.md @@ -141,8 +141,8 @@ metodologia) anziché sovrascriverlo — e conferma con l’utente prima di sost ## 4. Proponi gli addon opt-in -Dopo l'onboarding di base, elenca i quattro addon (devcontainer, Dailybot, dependency-upgrade, -design-system) e proponi ciascuno come opt-in esplicito. Un repository è pienamente conforme con +Dopo l'onboarding di base, elenca i cinque addon (devcontainer, Dailybot, dependency-upgrade, +design-system, AI Diff Reviewer) e proponi ciascuno come opt-in esplicito. Un repository è pienamente conforme con **zero** addon — non installarli mai automaticamente. - **Supporto devcontainer** — un dev container riproducibile e isolato con autenticazione AI-CLI persistente. @@ -153,6 +153,8 @@ design-system) e proponi ciascuno come opt-in esplicito. Un repository è pienam rilevata (non offerto per librerie pure, servizi headless o repository solo infra). Tre profili si sovrappongono in un unico file: visual-ui (attivo per default quando rilevato), cli-output e conversational — gli ultimi due vengono sempre chiesti, mai applicati automaticamente. +- **AI Diff Reviewer** — potenzia la Revisione di Sicurezza obbligatoria con una revisione locale strutturata + via [AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) **v2** (skill + `.review/extension.md` obbligatorio). Chiedi sempre **Flow A** (solo locale) vs **Flow B** (gate CI a doppia superficie con `pr-review.yml`); non assumere mai un valore predefinito. Soft-fail solo per errori di skill/estensione/invocazione mancanti; i risultati `critical` di un passaggio locale completato bloccano ancora il completamento della Revisione di Sicurezza. La metodologia di base ha zero dipendenze da AI Diff Reviewer. ## 5. Fai evolvere il kit (sub-skill author) diff --git a/src/content/pages/it/kit.md b/src/content/pages/it/kit.md index 7e1a572..e30ea66 100644 --- a/src/content/pages/it/kit.md +++ b/src/content/pages/it/kit.md @@ -52,6 +52,7 @@ Capacità opzionali che il flusso di onboard può aggiungere a un repo — mai p - **Dailybot** — report best-effort di progressi e milestone per i team che usano Dailybot. - **Dependency upgrade** — aggiornamenti indipendenti dal package manager, a lotti, validati e annullabili. - **Design system** — un `DESIGN.md` con ambito di interfaccia (in `docs/DESIGN.md`, referenziato da `AGENTS.md`) ragionato dalla fonte di design reale del repo, con profili per UI visuale, output CLI stilizzato e messaggistica conversazionale, così che gli agenti generino output di interfaccia on-brand; il profilo visuale è attivo di default quando un design system viene rilevato, mentre i profili CLI e conversazionale sono raccomandati quando rilevati e sempre proposti con una domanda. +- **AI Diff Reviewer** — potenzia il Security Review con una revisione locale strutturata ([AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) v2 + `.review/extension.md` obbligatorio); il Flow B opzionale aggiunge un gate di merge PR in CI che condivide la stessa estensione. Chiedere sempre Flow A vs Flow B; non installare mai automaticamente. ### Esempi diff --git a/src/content/pages/it/quickstart.md b/src/content/pages/it/quickstart.md index feda7b1..54840f9 100644 --- a/src/content/pages/it/quickstart.md +++ b/src/content/pages/it/quickstart.md @@ -42,8 +42,8 @@ per piani e bozze. Nulla è basato su template; tutto è adattato al Suo reposit ### 3. Faccia evolvere il kit e accetti gli addon Usi `/skill-create` e `/agent-create` (la sub-skill author) per far crescere skill, agenti e comandi -adatti allo stack. L’onboarding offre anche quattro addon opt-in — devcontainer, Dailybot, -dependency-upgrade e design-system — che accetta solo quando sono pertinenti. Un repo è pienamente conforme con zero addon. +adatti allo stack. L’onboarding offre anche cinque addon opt-in — devcontainer, Dailybot, +dependency-upgrade, design-system e AI Diff Reviewer — che accetta solo quando sono pertinenti. Un repo è pienamente conforme con zero addon. ### 4. Pianifichi ed esegua diff --git a/src/content/pages/ja/init.md b/src/content/pages/ja/init.md index 4ffe9ef..3d509f1 100644 --- a/src/content/pages/ja/init.md +++ b/src/content/pages/ja/init.md @@ -86,12 +86,13 @@ onboard サブスキル(`/deepworkplan-onboard`)を呼び出します。実 ## 4. オプトイン式のアドオンを提案する -ベースラインのオンボーディング後、四つのアドオン(devcontainer、Dailybot、dependency-upgrade、design-system)を列挙し、それぞれを明示的なオプトインとして提案します。リポジトリは**ゼロ**のアドオンで完全に適合します。決して自動でインストールしないでください。 +ベースラインのオンボーディング後、五つのアドオン(devcontainer、Dailybot、dependency-upgrade、design-system、AI Diff Reviewer)を列挙し、それぞれを明示的なオプトインとして提案します。リポジトリは**ゼロ**のアドオンで完全に適合します。決して自動でインストールしないでください。 - **Devcontainer サポート** — 永続的な AI CLI 認証を備えた、再現可能で隔離された開発コンテナ。 - **Dailybot 連携** — 四つのライフサイクルイベント(キックオフ、重要なタスク、ブロック、完了)を、すでに Dailybot を使っているチームのための最善努力での進捗報告として、任意で自律的なフック強制層(`dailybot-cli >= 3.7.0`)付きで提供します。ペアの Dailybot エージェントスキル(3.10.3)をインストールすると、チャット、チェックイン、フォーム作成、AI への質問、リポジトリごとの API キーなども利用可能になります。このアドオンは DWP 実行へのレポーティングの接続のみを行います。中核となる方法論は Dailybot への依存がゼロです。 - **Dependency upgrade** — パッケージマネージャー非依存で、バッチ化され、検証され、取り消し可能な更新。受け入れられると、`/lib-upgrade` コマンドをインストールします。 - **Design system** — 検出されたインターフェイス面を持つリポジトリのみを対象とした、オプトインの `docs/DESIGN.md`(純粋なライブラリ、ヘッドレスサービス、インフラ専用リポジトリには提案されません)。三つのプロファイルが一つのファイルに重ねられます:visual-ui(検出時にデフォルトでオン)、cli-output、conversational — 後者二つは常に尋ねられ、自動適用されることはありません。 +- **AI Diff Reviewer** — 必須のセキュリティレビューを、[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) **v2**(skill + 必須の `.review/extension.md`)による構造化されたローカルレビューで強化します。常に **Flow A**(ローカルのみ)か **Flow B**(`pr-review.yml` を使ったデュアルサーフェス CI ゲート)かを尋ねてください。デフォルトを想定してはいけません。スキル・拡張機能・呼び出しの欠落エラーに対してのみソフト失敗します。完了したローカルパスの `critical` 結果は引き続きセキュリティレビューの完了をブロックします。中核方法論は AI Diff Reviewer への依存がゼロです。 ## 5. キットを進化させる(author サブスキル) diff --git a/src/content/pages/ja/kit.md b/src/content/pages/ja/kit.md index 98abcc1..c8c6d36 100644 --- a/src/content/pages/ja/kit.md +++ b/src/content/pages/ja/kit.md @@ -49,6 +49,7 @@ onboard フローがリポジトリに重ねられる任意の機能です。AI- - **Dailybot** — Dailybot を使うチームのための、最善努力での進捗とマイルストーンの報告。 - **Dependency upgrade** — パッケージマネージャー非依存で、バッチ化され、検証され、取り消し可能な更新。 - **Design system** — インターフェイスに限定された `DESIGN.md`(`docs/DESIGN.md` に置かれ、`AGENTS.md` から参照される)で、リポジトリの実際のデザインソースから推論され、ビジュアル UI、スタイルづけされた CLI 出力、会話のメッセージングのプロファイルを備え、エージェントがオンブランドのインターフェイス出力を生成できるようにします。デザインシステムが検出されたときはビジュアルのプロファイルがデフォルトでオンであり、CLI と会話のプロファイルは検出されたとき推奨され、必ず尋ねられます。 +- **AI Diff Reviewer** — 構造化されたローカルレビュー([AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) v2 + 必須の `.review/extension.md`)でセキュリティレビューを強化します。オプションの Flow B は同じ extension を共有する CI PR マージゲートを追加します。常に Flow A か Flow B かを尋ねてください。絶対に自動インストールしないでください。 ### 事例 diff --git a/src/content/pages/ja/quickstart.md b/src/content/pages/ja/quickstart.md index b7dea94..4be9edf 100644 --- a/src/content/pages/ja/quickstart.md +++ b/src/content/pages/ja/quickstart.md @@ -36,7 +36,7 @@ onboard サブスキルを実行し、エージェントに実際のリポジト ### 3. キットを進化させ、アドオンを受け入れる -`/skill-create` と `/agent-create`(author サブスキル)を使って、スタックに合ったスキル、エージェント、コマンドを育てます。オンボーディングは四つのオプトイン式アドオン(devcontainer、Dailybot、dependency-upgrade、design-system)も提案します。適合する場合にのみ受け入れてください。リポジトリはアドオンがゼロでも完全に適合します。 +`/skill-create` と `/agent-create`(author サブスキル)を使って、スタックに合ったスキル、エージェント、コマンドを育てます。オンボーディングは五つのオプトイン式アドオン(devcontainer、Dailybot、dependency-upgrade、design-system、AI Diff Reviewer)も提案します。適合する場合にのみ受け入れてください。リポジトリはアドオンがゼロでも完全に適合します。 ### 4. 計画して実行する diff --git a/src/content/pages/ko/init.md b/src/content/pages/ko/init.md index 7fb0677..cdc9f42 100644 --- a/src/content/pages/ko/init.md +++ b/src/content/pages/ko/init.md @@ -134,7 +134,7 @@ onboard 하위 스킬(`/deepworkplan-onboard`)을 호출하세요. 실제 리포 ## 4. 선택형 애드온을 제안하세요 -기준선 온보딩 이후, 네 가지 애드온(devcontainer, Dailybot, dependency-upgrade, design-system)을 +기준선 온보딩 이후, 다섯 가지 애드온(devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer)을 열거하고 각각을 명시적 선택형으로 제안하세요. 리포지토리는 애드온이 **하나도** 없어도 완전히 적합합니다 — 결코 자동 설치하지 마세요. @@ -146,6 +146,7 @@ onboard 하위 스킬(`/deepworkplan-onboard`)을 호출하세요. 실제 리포 (순수 라이브러리, 헤드리스 서비스, 인프라 전용 리포지토리에는 제공하지 않음). 세 가지 프로필이 하나의 파일에 쌓입니다: visual-ui(감지되면 기본 활성화), cli-output, conversational — 후자 두 개는 항상 질문하며 자동 적용하지 않습니다. +- **AI Diff Reviewer** — 필수 보안 검토를 [AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) **v2** (skill + 필수 `.review/extension.md`)를 통한 구조화된 로컬 검토로 강화합니다. 항상 **Flow A** (로컬 전용) vs **Flow B** (이중 서피스 CI 게이트, `pr-review.yml`)를 질문하세요; 절대 기본값을 가정하지 마세요. 누락된 skill/확장/호출 오류에 대해서만 소프트 실패; 완료된 로컬 패스의 `critical` 결과는 여전히 보안 검토 완료를 차단합니다. 핵심 방법론은 AI Diff Reviewer에 대한 제로 의존성을 가집니다. ## 5. 키트를 발전시키세요 (author 하위 스킬) diff --git a/src/content/pages/ko/kit.md b/src/content/pages/ko/kit.md index d643831..98d9ba1 100644 --- a/src/content/pages/ko/kit.md +++ b/src/content/pages/ko/kit.md @@ -52,6 +52,7 @@ onboard 흐름이 리포지토리에 얹을 수 있는 선택 기능 — AI-firs - **Dailybot** — Dailybot을 사용하는 팀을 위한 최선 노력 기반의 진행 및 마일스톤 보고. - **Dependency upgrade** — 패키지 관리자 비종속, 배치 단위, 검증되고 되돌릴 수 있는 업그레이드. - **Design system** — 리포지토리의 실제 디자인 소스에서 추론된 인터페이스 범위의 `DESIGN.md`(`docs/DESIGN.md`에 위치하며 `AGENTS.md`에서 참조됨)로, 비주얼 UI, 스타일이 입혀진 CLI 출력, 대화형 메시징을 위한 프로필을 갖추어 에이전트가 브랜드에 맞는 인터페이스 출력을 생성합니다. 디자인 시스템이 감지되면 비주얼 프로필은 기본 활성이고, CLI와 대화형 프로필은 감지 시 권장되며 언제나 먼저 물어봅니다. +- **AI Diff Reviewer** — 구조화된 로컬 검토([AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) v2 + 필수 `.review/extension.md`)로 Security Review를 강화합니다. 선택적인 Flow B는 동일한 extension을 공유하는 CI PR 병합 게이트를 추가합니다. 항상 Flow A 대 Flow B를 질문하세요. 절대 자동 설치하지 마세요. ### 예시 diff --git a/src/content/pages/ko/quickstart.md b/src/content/pages/ko/quickstart.md index c1ce121..35cd327 100644 --- a/src/content/pages/ko/quickstart.md +++ b/src/content/pages/ko/quickstart.md @@ -42,8 +42,8 @@ gitignore된 `.dwp/`를 구성합니다. 어떤 것도 템플릿이 아니라 ### 3. 키트 발전과 애드온 채택 `/skill-create`와 `/agent-create`(author 하위 스킬)로 스택에 맞는 스킬, -에이전트, 명령을 키우세요. 온보딩은 또한 네 가지 선택형 애드온 — devcontainer, Dailybot, -dependency-upgrade, design-system — 을 제안하며, 맞을 때만 채택하면 됩니다. 리포지토리는 애드온이 하나도 없어도 완전히 적합합니다. +에이전트, 명령을 키우세요. 온보딩은 또한 다섯 가지 선택형 애드온 — devcontainer, Dailybot, +dependency-upgrade, design-system, AI Diff Reviewer — 을 제안하며, 맞을 때만 채택하면 됩니다. 리포지토리는 애드온이 하나도 없어도 완전히 적합합니다. ### 4. 계획하고 실행 diff --git a/src/content/pages/pl/init.md b/src/content/pages/pl/init.md index 1433e32..9152b7b 100644 --- a/src/content/pages/pl/init.md +++ b/src/content/pages/pl/init.md @@ -137,7 +137,7 @@ metodyki), zamiast nadpisywać — i potwierdź z użytkownikiem przed zastąpie ## 4. Zaproponuj opcjonalne dodatki -Po onboardingu bazowym wymień cztery dodatki (devcontainer, Dailybot, dependency-upgrade, design-system) i zaproponuj każdy jako wyraźną opcję do wyboru. Repozytorium jest +Po onboardingu bazowym wymień pięć dodatków (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer) i zaproponuj każdy jako wyraźną opcję do wyboru. Repozytorium jest w pełni zgodne przy **zerowej** liczbie dodatków — nigdy nie instaluj ich automatycznie. - **Wsparcie devcontainera** — odtwarzalny, izolowany kontener deweloperski z trwałym uwierzytelnianiem AI-CLI. @@ -148,6 +148,7 @@ w pełni zgodne przy **zerowej** liczbie dodatków — nigdy nie instaluj ich au (nie jest oferowany dla czystych bibliotek, usług headless ani repozytoriów wyłącznie infrastrukturalnych). Trzy profile nakładają się w jednym pliku: visual-ui (domyślnie włączony po wykryciu), cli-output i konwersacyjny — dwa ostatnie zawsze są pytane, nigdy auto-stosowane. +- **AI Diff Reviewer** — wzmacnia obowiązkowy Security Review o ustrukturyzowany przegląd lokalny przez [AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) **v2** (skill + wymagany `.review/extension.md`). Zawsze pytaj o **Flow A** (tylko lokalnie) vs **Flow B** (podwójna brama CI z `pr-review.yml`); nigdy nie zakładaj domyślnie. Soft-fail tylko dla brakujących błędów skill/rozszerzenia/wywołania; wyniki `critical` z zakończonego lokalnego przejścia nadal blokują ukończenie Security Review. Podstawowa metodyka nie ma żadnej zależności od AI Diff Reviewer. ## 5. Rozwijaj kit (sub-skill author) diff --git a/src/content/pages/pl/kit.md b/src/content/pages/pl/kit.md index 51b06b7..ca478bc 100644 --- a/src/content/pages/pl/kit.md +++ b/src/content/pages/pl/kit.md @@ -52,6 +52,7 @@ Opcjonalne możliwości, które przepływ onboardingu może nałożyć na repozy - **Dailybot** — raportowanie postępu i kamieni milowych dla zespołów korzystających z Dailybot. - **Dependency upgrade** — aktualizacje niezależne od menedżera pakietów: partiami, zwalidowane i odwracalne. - **System projektowy** — plik `DESIGN.md` o zakresie interfejsowym (w `docs/DESIGN.md`, przywoływany z `AGENTS.md`) wywiedziony z rzeczywistego źródła projektowego repozytorium, z profilami dla wizualnego UI, stylizowanego wyjścia CLI i komunikacji konwersacyjnej, dzięki czemu agenci generują wyjście interfejsu zgodne z marką; profil wizualny jest domyślnie włączony, gdy wykryto system projektowy, a profile CLI i konwersacyjny są zalecane po wykryciu i zawsze poprzedzone pytaniem. +- **AI Diff Reviewer** — wzmacnia Security Review o ustrukturyzowany lokalny przegląd ([AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) v2 + wymagany `.review/extension.md`); opcjonalny Flow B dodaje bramę merge PR w CI współdzielącą to samo rozszerzenie. Zawsze pytaj Flow A vs Flow B; nigdy nie instaluj automatycznie. ### Przykłady diff --git a/src/content/pages/pl/quickstart.md b/src/content/pages/pl/quickstart.md index 6d1c0a8..e94b758 100644 --- a/src/content/pages/pl/quickstart.md +++ b/src/content/pages/pl/quickstart.md @@ -42,8 +42,8 @@ na plany i szkice. Nic nie pochodzi z szablonu; wszystko jest dostosowane do two ### 3. Rozwijaj kit i akceptuj dodatki Użyj `/skill-create` i `/agent-create` (sub-skill author), aby rozwijać skille, agentów i komendy odpowiednie dla -twojego stosu. Onboarding oferuje też cztery opcjonalne dodatki — devcontainer, Dailybot, -dependency-upgrade i design-system — które akceptujesz tylko wtedy, gdy pasują. Repozytorium jest w pełni zgodne przy zerowej liczbie dodatków. +twojego stosu. Onboarding oferuje też pięć opcjonalnych dodatków — devcontainer, Dailybot, +dependency-upgrade, design-system i AI Diff Reviewer — które akceptujesz tylko wtedy, gdy pasują. Repozytorium jest w pełni zgodne przy zerowej liczbie dodatków. ### 4. Planuj i wykonuj diff --git a/src/content/pages/pt/init.md b/src/content/pages/pt/init.md index d8237a8..ba7ec13 100644 --- a/src/content/pages/pt/init.md +++ b/src/content/pages/pt/init.md @@ -139,8 +139,8 @@ metodologia) em vez de sobrescrever — e confirme com o usuário antes de subst ## 4. Ofereça os addons opcionais -Após o onboarding de base, enumere os quatro addons (devcontainer, Dailybot, dependency-upgrade, -design-system) e ofereça cada um como uma escolha explícita. Um repositório é +Após o onboarding de base, enumere os cinco addons (devcontainer, Dailybot, dependency-upgrade, +design-system, AI Diff Reviewer) e ofereça cada um como uma escolha explícita. Um repositório é totalmente conforme com **zero** addons — nunca os instale automaticamente. - **Suporte a devcontainer** — um dev container reproduzível e isolado com auth de CLI de IA persistente. @@ -151,6 +151,8 @@ totalmente conforme com **zero** addons — nunca os instale automaticamente. (não oferecido para bibliotecas puras, serviços headless ou repos exclusivamente de infra). Três perfis se empilham em um único arquivo: visual-ui (ativado por padrão quando detectado), cli-output e conversational — estes dois últimos são sempre perguntados, nunca aplicados automaticamente. +- **AI Diff Reviewer** — aumenta a Revisão de Segurança obrigatória com uma revisão local estruturada + via [AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) **v2** (skill + `.review/extension.md` obrigatório). Pergunte sempre **Fluxo A** (apenas local) vs **Fluxo B** (portão CI de dupla superfície com `pr-review.yml`); nunca assuma um padrão. Falha suave apenas para erros de skill/extensão/invocação ausentes; resultados `critical` de uma passagem local concluída ainda bloqueiam a conclusão da Revisão de Segurança. A metodologia central tem zero dependência do AI Diff Reviewer. ## 5. Evolua o kit (sub-skill author) diff --git a/src/content/pages/pt/kit.md b/src/content/pages/pt/kit.md index 47c44c4..0e83a7e 100644 --- a/src/content/pages/pt/kit.md +++ b/src/content/pages/pt/kit.md @@ -52,6 +52,7 @@ Capacidades opcionais que o fluxo de onboarding pode adicionar a um repositório - **Dailybot** — relatórios de progresso e marcos em modo best-effort para equipes que usam a Dailybot. - **Atualização de dependências** — atualizações independentes do gerenciador de pacotes, em lotes, validadas e reversíveis. - **Design system** — um `DESIGN.md` com escopo de interface (em `docs/DESIGN.md`, referenciado a partir do `AGENTS.md`) derivado da fonte real de design do repositório, com perfis para UI visual, saída de CLI estilizada e mensagens conversacionais, para que os agentes gerem saída de interface fiel à marca; o perfil visual é ativado por padrão quando um design system é detectado, e os perfis de CLI e conversacional são recomendados quando detectados e sempre perguntados. +- **AI Diff Reviewer** — amplia o Security Review com uma revisão local estruturada ([AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) v2 + `.review/extension.md` obrigatório); o Flow B opcional adiciona uma barreira de merge de PR em CI que compartilha a mesma extensão. Sempre perguntar Flow A vs Flow B; nunca instalar automaticamente. ### Exemplos diff --git a/src/content/pages/pt/quickstart.md b/src/content/pages/pt/quickstart.md index 4e5574d..2e60284 100644 --- a/src/content/pages/pt/quickstart.md +++ b/src/content/pages/pt/quickstart.md @@ -42,8 +42,8 @@ para planos e rascunhos. Nada é gerado por template; tudo é adaptado ao seu re ### 3. Evolua o kit e aceite addons Use `/skill-create` e `/agent-create` (a sub-skill author) para desenvolver skills, -agents e commands apropriados à sua stack. O onboarding também oferece quatro addons opcionais — devcontainer, Dailybot, -dependency-upgrade e design-system — que você aceita apenas quando fizerem sentido. Um repositório é totalmente conforme com zero addons. +agents e commands apropriados à sua stack. O onboarding também oferece cinco addons opcionais — devcontainer, Dailybot, +dependency-upgrade, design-system e AI Diff Reviewer — que você aceita apenas quando fizerem sentido. Um repositório é totalmente conforme com zero addons. ### 4. Planeje e execute diff --git a/src/content/pages/ru/init.md b/src/content/pages/ru/init.md index 26db0a3..004a065 100644 --- a/src/content/pages/ru/init.md +++ b/src/content/pages/ru/init.md @@ -140,8 +140,8 @@ git clone https://github.com/DailybotHQ/deepworkplan-skill.git && cd deepworkpla ## 4. Предложите опциональные дополнения -После базового онбординга перечислите четыре дополнения (devcontainer, Dailybot, dependency-upgrade, -design-system) и предложите каждое как явное согласие. Репозиторий полностью соответствует стандарту +После базового онбординга перечислите пять дополнений (devcontainer, Dailybot, dependency-upgrade, +design-system, AI Diff Reviewer) и предложите каждое как явное согласие. Репозиторий полностью соответствует стандарту и с **нулём** дополнений — никогда не устанавливайте их автоматически. - **Поддержка Devcontainer** — воспроизводимый, изолированный dev-контейнер с устойчивой аутентификацией AI-CLI. @@ -153,6 +153,7 @@ design-system) и предложите каждое как явное согла инфраструктурных репозиториев). Три профиля компонуются в одном файле: visual-ui (включён по умолчанию при обнаружении), cli-output и conversational — последние два всегда спрашиваются, никогда не применяются автоматически. +- **AI Diff Reviewer** — усиливает обязательный Security Review структурированным локальным обзором через [AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) **v2** (skill + обязательный `.review/extension.md`). Всегда спрашивайте **Flow A** (только локально) или **Flow B** (двухуровневый CI-гейт с `pr-review.yml`); никогда не предполагайте по умолчанию. Мягкий сбой только при ошибках отсутствующего skill/расширения/вызова; результаты `critical` завершённого локального прохода всё равно блокируют завершение Security Review. Базовая методология имеет нулевую зависимость от AI Diff Reviewer. ## 5. Развивайте набор (под-навык author) diff --git a/src/content/pages/ru/kit.md b/src/content/pages/ru/kit.md index 2e8a58b..d920b0a 100644 --- a/src/content/pages/ru/kit.md +++ b/src/content/pages/ru/kit.md @@ -52,6 +52,7 @@ npx skills add DailybotHQ/deepworkplan-skill - **Dailybot** — отчётность о прогрессе и вехах по принципу best-effort для команд, использующих Dailybot. - **Dependency upgrade** — независимые от менеджера пакетов, партийные, проверяемые, обратимые обновления. - **Design system** — ограниченный поверхностями интерфейса `DESIGN.md` (по пути `docs/DESIGN.md`, на который ссылается `AGENTS.md`), выведенный из реального источника дизайна репозитория, с профилями для визуального UI, стилизованного вывода CLI и диалогового обмена сообщениями, чтобы агенты генерировали фирменный интерфейсный вывод; визуальный профиль включён по умолчанию при обнаружении дизайн-системы, профили CLI и диалоговый рекомендуются при обнаружении, и о них всегда спрашивают. +- **AI Diff Reviewer** — усиливает Security Review структурированным локальным обзором ([AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) v2 + обязательный `.review/extension.md`); опциональный Flow B добавляет CI-гейт слияния PR, использующий ту же extension. Всегда спрашивайте Flow A или Flow B; никогда не устанавливайте автоматически. ### Примеры diff --git a/src/content/pages/ru/quickstart.md b/src/content/pages/ru/quickstart.md index 5b86d74..813b3b0 100644 --- a/src/content/pages/ru/quickstart.md +++ b/src/content/pages/ru/quickstart.md @@ -42,8 +42,8 @@ git clone https://github.com/DailybotHQ/deepworkplan-skill.git && cd deepworkpla ### 3. Развивайте набор и принимайте дополнения Используйте `/skill-create` и `/agent-create` (под-навык author), чтобы растить подходящие стеку навыки, -агентов и команды. Онбординг также предлагает четыре опциональных дополнения — devcontainer, Dailybot, -dependency-upgrade и design-system, — которые вы принимаете, только когда они уместны. Репозиторий полностью соответствует стандарту и с нулём дополнений. +агентов и команды. Онбординг также предлагает пять опциональных дополнений — devcontainer, Dailybot, +dependency-upgrade, design-system и AI Diff Reviewer, — которые вы принимаете, только когда они уместны. Репозиторий полностью соответствует стандарту и с нулём дополнений. ### 4. Планируйте и выполняйте diff --git a/src/content/pages/th/init.md b/src/content/pages/th/init.md index 49b9937..cf06a63 100644 --- a/src/content/pages/th/init.md +++ b/src/content/pages/th/init.md @@ -136,7 +136,7 @@ git clone https://github.com/DailybotHQ/deepworkplan-skill.git && cd deepworkpla ## 4. เสนอส่วนเสริมแบบเลือกเข้าร่วม -หลังจากการออนบอร์ดพื้นฐาน ให้แจกแจงส่วนเสริมสี่อย่าง (devcontainer, Dailybot, dependency-upgrade, design-system) และเสนอแต่ละอย่างเป็นการเลือกเข้าร่วมอย่างชัดแจ้ง repository +หลังจากการออนบอร์ดพื้นฐาน ให้แจกแจงส่วนเสริมห้าอย่าง (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer) และเสนอแต่ละอย่างเป็นการเลือกเข้าร่วมอย่างชัดแจ้ง repository สอดคล้องอย่างสมบูรณ์โดยมีส่วนเสริม **ศูนย์** อย่าง — อย่าติดตั้งมันอัตโนมัติ - **Devcontainer support** — dev container ที่ทำซ้ำได้และแยกตัว พร้อม auth ของ AI-CLI ที่คงอยู่ @@ -147,6 +147,7 @@ git clone https://github.com/DailybotHQ/deepworkplan-skill.git && cd deepworkpla (ไม่เสนอสำหรับไลบรารีบริสุทธิ์ บริการ headless หรือ repo ที่มีแต่โครงสร้างพื้นฐาน) สามโปรไฟล์ซ้อนกัน ในไฟล์เดียว ได้แก่ visual-ui (เปิดโดยค่าเริ่มต้นเมื่อตรวจพบ), cli-output และสนทนา — สองโปรไฟล์หลัง จะถูกถามเสมอ ไม่เคยถูกใช้โดยอัตโนมัติ +- **AI Diff Reviewer** — เสริม Security Review ที่บังคับด้วยการตรวจสอบในเครื่องแบบมีโครงสร้างผ่าน [AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) **v2** (skill + `.review/extension.md` ที่ต้องการ) ถามเสมอว่า **Flow A** (เฉพาะในเครื่อง) หรือ **Flow B** (CI gate สองพื้นผิวกับ `pr-review.yml`); อย่าสมมติค่าเริ่มต้น Soft-fail เฉพาะสำหรับข้อผิดพลาด skill/ส่วนขยาย/การเรียกใช้ที่ขาดหาย; ผลลัพธ์ `critical` จากการผ่านในเครื่องที่เสร็จสมบูรณ์ยังคงบล็อกการเสร็จสิ้น Security Review ระเบียบวิธีหลักไม่มีการพึ่งพิง AI Diff Reviewer ใด ๆ ## 5. พัฒนา kit (sub-skill ชื่อ author) diff --git a/src/content/pages/th/kit.md b/src/content/pages/th/kit.md index f72c552..a15b58d 100644 --- a/src/content/pages/th/kit.md +++ b/src/content/pages/th/kit.md @@ -52,6 +52,7 @@ skill ของ Deep Work Plan คือตัวกำหนดเส้นท - **Dailybot** — การรายงานความคืบหน้าและหมุดหมายแบบเต็มความสามารถสำหรับทีมที่ใช้ Dailybot - **Dependency upgrade** — การอัปเกรดที่เป็นกลางต่อตัวจัดการแพ็กเกจ ทำเป็นชุด ตรวจสอบแล้ว และย้อนกลับได้ - **Design system** — `DESIGN.md` ที่จำกัดขอบเขตเฉพาะอินเทอร์เฟซ (ที่ `docs/DESIGN.md` อ้างอิงจาก `AGENTS.md`) ซึ่งให้เหตุผลจากแหล่งดีไซน์จริงของ repo พร้อมโปรไฟล์สำหรับ UI เชิงภาพ เอาต์พุต CLI ที่จัดสไตล์ และการส่งข้อความเชิงสนทนา เพื่อให้เอเจนต์สร้างเอาต์พุตอินเทอร์เฟซที่ตรงแบรนด์ โปรไฟล์เชิงภาพเปิดใช้งานเป็นค่าเริ่มต้นเมื่อตรวจพบระบบดีไซน์ ส่วนโปรไฟล์ CLI และเชิงสนทนาถูกแนะนำเมื่อตรวจพบและถูกถามเสมอ +- **AI Diff Reviewer** — เสริม Security Review ด้วยการตรวจสอบในเครื่องแบบมีโครงสร้าง ([AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) v2 + `.review/extension.md` ที่ต้องการ); Flow B แบบเลือกได้เพิ่ม CI PR merge gate ที่ใช้ extension เดียวกัน ถามเสมอว่า Flow A หรือ Flow B; อย่าติดตั้งอัตโนมัติ ### ตัวอย่าง diff --git a/src/content/pages/th/quickstart.md b/src/content/pages/th/quickstart.md index aec70fe..db638de 100644 --- a/src/content/pages/th/quickstart.md +++ b/src/content/pages/th/quickstart.md @@ -42,8 +42,8 @@ git clone https://github.com/DailybotHQ/deepworkplan-skill.git && cd deepworkpla ### 3. พัฒนา kit และยอมรับส่วนเสริม ใช้ `/skill-create` และ `/agent-create` (sub-skill ชื่อ author) เพื่อปลูก skill, agent และคำสั่ง -ที่เหมาะกับเทคสแตก การออนบอร์ดยังเสนอส่วนเสริมแบบเลือกเข้าร่วมสี่อย่าง — devcontainer, Dailybot, -dependency-upgrade และ design-system — ที่คุณยอมรับเมื่อมันเหมาะสมเท่านั้น repo สอดคล้องอย่างสมบูรณ์โดยมีส่วนเสริมศูนย์อย่าง +ที่เหมาะกับเทคสแตก การออนบอร์ดยังเสนอส่วนเสริมแบบเลือกเข้าร่วมห้าอย่าง — devcontainer, Dailybot, +dependency-upgrade, design-system และ AI Diff Reviewer — ที่คุณยอมรับเมื่อมันเหมาะสมเท่านั้น repo สอดคล้องอย่างสมบูรณ์โดยมีส่วนเสริมศูนย์อย่าง ### 4. วางแผนและดำเนินการ diff --git a/src/content/pages/tr/init.md b/src/content/pages/tr/init.md index 91a5582..defcb1b 100644 --- a/src/content/pages/tr/init.md +++ b/src/content/pages/tr/init.md @@ -142,8 +142,8 @@ teyit edin. ## 4. Tercihe dayalı eklentileri sunun -Temel onboarding sonrasında, dört eklentiyi (devcontainer, Dailybot, dependency-upgrade, -design-system) sıralayın ve her birini açık bir tercih olarak sunun. Bir depo, **sıfır** eklentiyle +Temel onboarding sonrasında, beş eklentiyi (devcontainer, Dailybot, dependency-upgrade, +design-system, AI Diff Reviewer) sıralayın ve her birini açık bir tercih olarak sunun. Bir depo, **sıfır** eklentiyle tümüyle uyumludur — onları asla otomatik kurmayın. - **Devcontainer desteği** — kalıcı AI-CLI kimlik doğrulaması içeren, yeniden üretilebilir, yalıtılmış @@ -155,6 +155,7 @@ tümüyle uyumludur — onları asla otomatik kurmayın. (saf kütüphanelere, headless servislere veya yalnızca altyapı depolarına sunulmaz). Üç profil tek bir dosyada katmanlanır: visual-ui (saptandığında varsayılan olarak açık), cli-output ve conversational — son ikisi her zaman sorulur, asla otomatik uygulanmaz. +- **AI Diff Reviewer** — zorunlu Güvenlik İncelemesini [AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) **v2** (skill + gerekli `.review/extension.md`) aracılığıyla yapılandırılmış yerel bir incelemeyle güçlendirir. Her zaman **Flow A** (yalnızca yerel) veya **Flow B** (çift yüzeyli CI kapısı, `pr-review.yml`) sorun; hiçbir zaman varsayılan seçmeyin. Yalnızca eksik skill/uzantı/çağrı hataları için yumuşak başarısızlık; tamamlanmış bir yerel geçişten gelen `critical` sonuçlar hâlâ Güvenlik İncelemesinin tamamlanmasını bloke eder. Temel metodolojinin AI Diff Reviewer'a sıfır bağımlılığı vardır. ## 5. Kiti geliştirin (author alt skill’i) diff --git a/src/content/pages/tr/kit.md b/src/content/pages/tr/kit.md index 7fdbd30..3b731f5 100644 --- a/src/content/pages/tr/kit.md +++ b/src/content/pages/tr/kit.md @@ -50,6 +50,7 @@ Onboarding akışının bir depoya katmanlayabileceği isteğe bağlı yetenekle - **Dailybot** — Dailybot kullanan ekipler için en iyi çabayla ilerleme ve dönüm noktası raporlaması. - **Dependency upgrade** — paket yöneticisinden bağımsız, gruplanmış, doğrulanmış, geri alınabilir yükseltmeler. - **Design system** — deponun gerçek tasarım kaynağından akıl yürütülen, arayüz kapsamlı bir `DESIGN.md` (`docs/DESIGN.md` konumunda, `AGENTS.md`'den başvurulan); görsel UI, stilize CLI çıktısı ve konuşma tabanlı mesajlaşma için profillerle; böylece ajanlar markaya uygun arayüz çıktısı üretir; görsel profil bir tasarım sistemi saptandığında varsayılan açıktır, CLI ve konuşma profilleri saptandığında önerilir ve her zaman sorulur. +- **AI Diff Reviewer** — Security Review'ı yapılandırılmış bir yerel incelemeyle ([AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) v2 + gerekli `.review/extension.md`) güçlendirir; isteğe bağlı Flow B, aynı uzantıyı paylaşan bir CI PR birleştirme kapısı ekler. Her zaman Flow A mı yoksa Flow B mi sorun; asla otomatik yüklemeyin. ### Örnekler diff --git a/src/content/pages/tr/quickstart.md b/src/content/pages/tr/quickstart.md index 5c5412d..5315d54 100644 --- a/src/content/pages/tr/quickstart.md +++ b/src/content/pages/tr/quickstart.md @@ -36,7 +36,7 @@ Bir `AGENTS.md`, bir `docs/` bilgi tabanı, modül başına dokümanlar ve ajanl ### 3. Kiti geliştirin ve eklentileri kabul edin -Yığına uygun skill’ler, ajanlar ve komutlar büyütmek için `/skill-create` ve `/agent-create` (author alt skill’i) kullanın. Onboarding ayrıca dört tercihe dayalı eklenti sunar — devcontainer, Dailybot, dependency-upgrade ve design-system — bunları yalnızca uygun olduklarında kabul edersiniz. Bir depo, sıfır eklentiyle tümüyle uyumludur. +Yığına uygun skill’ler, ajanlar ve komutlar büyütmek için `/skill-create` ve `/agent-create` (author alt skill’i) kullanın. Onboarding ayrıca beş tercihe dayalı eklenti sunar — devcontainer, Dailybot, dependency-upgrade, design-system ve AI Diff Reviewer — bunları yalnızca uygun olduklarında kabul edersiniz. Bir depo, sıfır eklentiyle tümüyle uyumludur. ### 4. Planlayın ve yürütün diff --git a/src/content/pages/uk/init.md b/src/content/pages/uk/init.md index 0246804..8594b68 100644 --- a/src/content/pages/uk/init.md +++ b/src/content/pages/uk/init.md @@ -137,7 +137,7 @@ git clone https://github.com/DailybotHQ/deepworkplan-skill.git && cd deepworkpla ## 4. Запропонуйте add-on із явним прийняттям -Після базового онбордингу перелічіть чотири add-on (devcontainer, Dailybot, dependency-upgrade, design-system) +Після базового онбордингу перелічіть п'ять add-on (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer) і запропонуйте кожен як явне прийняття. Репозиторій повністю відповідний з **нульовою** кількістю add-on — ніколи не встановлюйте їх автоматично. @@ -149,6 +149,7 @@ git clone https://github.com/DailybotHQ/deepworkplan-skill.git && cd deepworkpla (не пропонується для чистих бібліотек, headless-сервісів або суто інфраструктурних репозиторіїв). Три профілі складаються в одному файлі: visual-ui (увімкнений за замовчуванням при виявленні), cli-output та розмовний — останні два завжди запитуються, ніколи не застосовуються автоматично. +- **AI Diff Reviewer** — посилює обов'язковий Security Review структурованим локальним переглядом через [AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) **v2** (skill + обов'язковий `.review/extension.md`). Завжди питайте **Flow A** (лише локально) або **Flow B** (двоповерховий CI-гейт із `pr-review.yml`); ніколи не припускайте за замовчуванням. М'який збій лише для помилок відсутнього skill/розширення/виклику; результати `critical` завершеного локального проходу все одно блокують завершення Security Review. Базова методологія не має жодної залежності від AI Diff Reviewer. ## 5. Розвивайте набір (суб-скіл author) diff --git a/src/content/pages/uk/kit.md b/src/content/pages/uk/kit.md index 5baee1b..e138895 100644 --- a/src/content/pages/uk/kit.md +++ b/src/content/pages/uk/kit.md @@ -52,6 +52,7 @@ npx skills add DailybotHQ/deepworkplan-skill - **Dailybot** — найкраще-можливе звітування про прогрес та віхи для команд, що використовують Dailybot. - **Dependency upgrade** — незалежні від менеджера пакетів, партіями, перевірені, відкочувані оновлення. - **Дизайн-система** — обмежений інтерфейсними поверхнями `DESIGN.md` (за шляхом `docs/DESIGN.md`, з посиланням з `AGENTS.md`), осмислений із реального джерела дизайну репозиторію, з профілями для візуального UI, стилізованого виводу CLI та розмовних повідомлень, щоб агенти генерували інтерфейсний вивід у стилі бренду; візуальний профіль типово ввімкнений, коли виявлено дизайн-систему, а профілі CLI та розмовний рекомендуються при виявленні, і про них завжди запитують. +- **AI Diff Reviewer** — посилює Security Review структурованим локальним переглядом ([AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) v2 + обов'язковий `.review/extension.md`); опціональний Flow B додає CI PR merge gate, що використовує той самий extension. Завжди питайте Flow A чи Flow B; ніколи не встановлюйте автоматично. ### Приклади diff --git a/src/content/pages/uk/quickstart.md b/src/content/pages/uk/quickstart.md index 9553da2..07fb362 100644 --- a/src/content/pages/uk/quickstart.md +++ b/src/content/pages/uk/quickstart.md @@ -42,8 +42,8 @@ git clone https://github.com/DailybotHQ/deepworkplan-skill.git && cd deepworkpla ### 3. Розвивайте набір та приймайте add-on Використовуйте `/skill-create` та `/agent-create` (суб-скіл author), щоб вирощувати доречні для стека скіли, -агенти та команди. Онбординг також пропонує чотири add-on із явним прийняттям — devcontainer, Dailybot, -dependency-upgrade та design-system, — які ви приймаєте лише тоді, коли вони пасують. Репозиторій повністю відповідний з нульовою кількістю add-on. +агенти та команди. Онбординг також пропонує п'ять add-on із явним прийняттям — devcontainer, Dailybot, +dependency-upgrade, design-system та AI Diff Reviewer, — які ви приймаєте лише тоді, коли вони пасують. Репозиторій повністю відповідний з нульовою кількістю add-on. ### 4. Плануйте та виконуйте diff --git a/src/content/pages/vi/init.md b/src/content/pages/vi/init.md index 7d9a39f..577dea6 100644 --- a/src/content/pages/vi/init.md +++ b/src/content/pages/vi/init.md @@ -140,7 +140,7 @@ phương pháp luận) thay vì ghi đè — và xác nhận với người dùn ## 4. Đề xuất các addon tự nguyện -Sau khi khởi tạo nền tảng, hãy liệt kê bốn addon (devcontainer, Dailybot, dependency-upgrade, design-system) và đề xuất mỗi cái như một lựa chọn tự nguyện rõ ràng. Một repository +Sau khi khởi tạo nền tảng, hãy liệt kê năm addon (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer) và đề xuất mỗi cái như một lựa chọn tự nguyện rõ ràng. Một repository hoàn toàn tuân thủ với **không** cần addon nào — đừng bao giờ tự động cài chúng. - **Hỗ trợ devcontainer** — một dev container tái lập được, cô lập, với xác thực AI-CLI bền vững. @@ -151,6 +151,8 @@ hoàn toàn tuân thủ với **không** cần addon nào — đừng bao giờ (không đề xuất cho thư viện thuần, dịch vụ headless hay repo chỉ hạ tầng). Ba profile xếp chồng trong một tệp: visual-ui (bật mặc định khi phát hiện), cli-output và hội thoại — hai profile sau luôn được hỏi, không bao giờ tự động áp dụng. +- **AI Diff Reviewer** — tăng cường Đánh giá Bảo mật bắt buộc với đánh giá cục bộ có cấu trúc + qua [AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) **v2** (skill + `.review/extension.md` bắt buộc). Luôn hỏi **Flow A** (chỉ cục bộ) vs **Flow B** (cổng CI hai bề mặt với `pr-review.yml`); không bao giờ mặc định. Thất bại nhẹ chỉ cho lỗi skill/tiện ích mở rộng/gọi bị thiếu; kết quả `critical` từ lượt kiểm tra cục bộ hoàn tất vẫn chặn việc hoàn thành Đánh giá Bảo mật. Phương pháp luận lõi không phụ thuộc vào AI Diff Reviewer. ## 5. Phát triển bộ kit (sub-skill author) diff --git a/src/content/pages/vi/kit.md b/src/content/pages/vi/kit.md index 3ef486f..7a9087c 100644 --- a/src/content/pages/vi/kit.md +++ b/src/content/pages/vi/kit.md @@ -52,6 +52,7 @@ Các năng lực tùy chọn mà luồng onboard có thể bổ sung vào một - **Dailybot** — báo cáo tiến độ và cột mốc theo nỗ lực tối đa cho các đội đang dùng Dailybot. - **Dependency upgrade** — nâng cấp phụ thuộc độc lập với trình quản lý gói, theo lô, được kiểm chứng, hoàn nguyên được. - **Design system** — một `DESIGN.md` giới hạn ở bề mặt giao diện (tại `docs/DESIGN.md`, được tham chiếu từ `AGENTS.md`) được suy luận từ nguồn thiết kế thực của repo, với các profile cho UI trực quan, đầu ra CLI có phong cách và nhắn tin hội thoại, để agent sinh ra đầu ra giao diện đúng thương hiệu; profile trực quan bật mặc định khi một hệ thống thiết kế được phát hiện, các profile CLI và hội thoại được khuyến nghị khi được phát hiện và luôn được hỏi. +- **AI Diff Reviewer** — tăng cường Security Review với đánh giá cục bộ có cấu trúc ([AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) v2 + `.review/extension.md` bắt buộc); Flow B tùy chọn thêm cổng merge PR CI dùng chung extension. Luôn hỏi Flow A vs Flow B; không bao giờ tự động cài đặt. ### Ví dụ diff --git a/src/content/pages/vi/quickstart.md b/src/content/pages/vi/quickstart.md index d89eca2..09a341d 100644 --- a/src/content/pages/vi/quickstart.md +++ b/src/content/pages/vi/quickstart.md @@ -42,8 +42,8 @@ cho các kế hoạch và bản nháp. Không gì là mẫu cứng; mọi thứ ### 3. Phát triển bộ kit và chấp nhận addon Dùng `/skill-create` và `/agent-create` (sub-skill author) để nuôi lớn các skill, agent và command phù hợp với stack. -Quá trình khởi tạo cũng đề xuất bốn addon tự nguyện — devcontainer, Dailybot, -dependency-upgrade, và design-system — mà bạn chỉ chấp nhận khi chúng phù hợp. Một repo hoàn toàn tuân thủ với không cần addon nào. +Quá trình khởi tạo cũng đề xuất năm addon tự nguyện — devcontainer, Dailybot, +dependency-upgrade, design-system và AI Diff Reviewer — mà bạn chỉ chấp nhận khi chúng phù hợp. Một repo hoàn toàn tuân thủ với không cần addon nào. ### 4. Lập kế hoạch và thực thi diff --git a/src/content/pages/zh/init.md b/src/content/pages/zh/init.md index d8bbabc..31eb319 100644 --- a/src/content/pages/zh/init.md +++ b/src/content/pages/zh/init.md @@ -124,7 +124,7 @@ git clone https://github.com/DailybotHQ/deepworkplan-skill.git && cd deepworkpla ## 4. 提供可选的附加组件 -在基线接入完成之后,列举这四个附加组件(devcontainer、Dailybot、dependency-upgrade、design-system),并把每一个作为一项明确的可选项来提供。一个仓库 +在基线接入完成之后,列举这五个附加组件(devcontainer、Dailybot、dependency-upgrade、design-system、AI Diff Reviewer),并把每一个作为一项明确的可选项来提供。一个仓库 在不带**任何**附加组件时即完全符合规范——绝不自动安装它们。 - **Devcontainer 支持** —— 一个可复现、隔离的开发容器,具备持久的 AI-CLI 认证。 @@ -134,6 +134,7 @@ git clone https://github.com/DailybotHQ/deepworkplan-skill.git && cd deepworkpla - **Design system** —— 可选的 `docs/DESIGN.md`,仅面向具备被检测到的界面表面的仓库 (不会向纯库、无头服务或纯基础设施仓库提供)。三个配置档堆叠在一个文件中:visual-ui (检测到时默认启用)、cli-output 与 conversational——后两者始终会被询问,绝不会被自动应用。 +- **AI Diff Reviewer** —— 通过 [AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) **v2**(skill + 必需的 `.review/extension.md`)以结构化的本地评审增强必选的安全审查。始终询问 **Flow A**(仅本地)还是 **Flow B**(具有 `pr-review.yml` 的双面 CI 门控);绝不默认假定。仅对缺失的 skill/扩展/调用错误执行软失败;已完成的本地通行 `critical` 发现仍会阻止安全审查完成。核心方法论对 AI Diff Reviewer 零依赖。 ## 5. 演化套件(author 子技能) diff --git a/src/content/pages/zh/kit.md b/src/content/pages/zh/kit.md index efdcad6..1ed62c6 100644 --- a/src/content/pages/zh/kit.md +++ b/src/content/pages/zh/kit.md @@ -52,6 +52,7 @@ onboard 流程可向仓库叠加的可选能力——绝非 AI-first 基线的 - **Dailybot** —— 面向使用 Dailybot 的团队的尽力而为式进展与里程碑报告。 - **Dependency upgrade** —— 包管理器无关、分批次、经验证、可回退的升级。 - **Design system** —— 一份限定于界面范围的 `DESIGN.md`(位于 `docs/DESIGN.md`,从 `AGENTS.md` 引用),从仓库真实的设计来源推理而来,并为可视化 UI、带样式的 CLI 输出与会话式消息提供配置档,使代理生成契合品牌的界面输出;当检测到一套设计系统时可视化配置档默认开启,CLI 与会话式配置档在检测到时被推荐且始终先询问。 +- **AI Diff Reviewer** —— 通过结构化的本地评审([AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer) v2 + 必需的 `.review/extension.md`)增强安全审查;可选的 Flow B 添加一个共享同一扩展的 CI PR 合并门控。始终询问 Flow A 还是 Flow B;绝不自动安装。 ### 示例 diff --git a/src/content/pages/zh/quickstart.md b/src/content/pages/zh/quickstart.md index 0de75f1..cfb3b4e 100644 --- a/src/content/pages/zh/quickstart.md +++ b/src/content/pages/zh/quickstart.md @@ -42,8 +42,8 @@ git clone https://github.com/DailybotHQ/deepworkplan-skill.git && cd deepworkpla ### 3. 演化套件并采纳附加组件 使用 `/skill-create` 与 `/agent-create`(author 子技能)来培育与技术栈相适配的技能、 -代理与命令。接入流程还会提供四个可选附加组件——devcontainer、Dailybot、 -dependency-upgrade 与 design-system——你只在它们契合时才采纳。一个仓库即便不带任何附加组件,也完全符合规范。 +代理与命令。接入流程还会提供五个可选附加组件——devcontainer、Dailybot、 +dependency-upgrade、design-system 与 AI Diff Reviewer——你只在它们契合时才采纳。一个仓库即便不带任何附加组件,也完全符合规范。 ### 4. 规划并执行 diff --git a/src/content/spec/de/addons.md b/src/content/spec/de/addons.md index d801c9f..6430a97 100644 --- a/src/content/spec/de/addons.md +++ b/src/content/spec/de/addons.md @@ -1,6 +1,6 @@ --- title: Add-ons -description: "Optionale DWP-Erweiterungen: die vier aktiven Addons (devcontainer, Dailybot, dependency-upgrade, design-system), der Addon-Vertrag und Kit-Konzepte." +description: "Optionale DWP-Erweiterungen: die fünf aktiven Addons (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), der Addon-Vertrag und Kit-Konzepte." order: 5 lang: de section: Addons @@ -23,9 +23,9 @@ Jedes aktive Addon liefert vier obligatorische Komponenten: Discovery: Der `onboard`-Ablauf enumeriert `skills/deepworkplan/addons/` und präsentiert jedes Addon als Opt-in-Schritt in **Phase 7b**, nach dem zentralen Scaffolding. -## Aktive Addons (vier) +## Aktive Addons (fünf) -Vier Addons sind heute aktiv. Jedes hat eine **Kit-Katalogseite** mit nutzerorientierten Details und eine **normative Spec** innerhalb der Deep Work Plan-Skill. +Fünf Addons sind heute aktiv. Jedes hat eine **Kit-Katalogseite** mit nutzerorientierten Details und eine **normative Spec** innerhalb der Deep Work Plan-Skill. ### Devcontainer (erstes Addon) @@ -65,6 +65,18 @@ Ein interface-oberflächenbezogenes `DESIGN.md`, das jeder Coding-Agent für kon - **Profilstärke:** visual-ui ist **standardmäßig an bei Erkennung**; cli-output und conversational werden **bei Erkennung empfohlen, immer gefragt, niemals automatisch angewendet** - **Wann angeboten:** nur wenn eine nutzerorientierte Interface-Oberfläche erkannt wird — nicht für reine Libraries, headless Services oder reine Infra-Repos +### AI Diff Reviewer (fünftes Addon) + +Eine optionale Verbindung zum **[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)** (Marketplace **"AI Diff Reviewer"**, aktuelle Version **v2.0.0**), die die obligatorische Sicherheitsprüfung um eine strukturierte lokale Überprüfung erweitert und optional Pull Requests in CI sperrt. + +- **Kit-Seite:** [AI Diff Reviewer](/kit/ai-diff-reviewer) — vollständige Fähigkeitsreferenz +- **Was das DWP-Addon verbindet:** lokale Erweiterung der Sicherheitsprüfung über den übergeordneten Standardflow des Upstream-Skills; erforderliches `.review/extension.md` (Skill allein unvollständig); Flow B installiert optional `pr-review.yml` (`DailybotHQ/ai-diff-reviewer@v2`) und bietet `apply-review` als entwickleraufrufbaren Begleiter — nie als Plan-Task +- **Flows:** **A — nur lokal** (Skill + Erweiterung) oder **B — doppelte Oberfläche** (Skill + Erweiterung + CI Action). Das Addon **MUSS fragen**, welcher Flow; niemals Standard annehmen +- **Soft-Fail vs. Gate:** fehlende Skill/Erweiterung/Aufruffehler blockieren niemals; `critical`-Ergebnisse eines **abgeschlossenen** lokalen Durchlaufs folgen dem Sicherheitsprüfungsvertrag weiterhin +- **Parität (Flow B):** gemeinsames `prompt.md` + Erweiterung richten Methodik/Schweregrad aus; CI-iterationsbewusste Überprüfung kann Runde 2+ verkürzen, während der lokale Durchlauf vollständig bleibt +- **Anbieterneutrale Schutzmaßnahme:** Kern-DWP hat **null** AI Diff Reviewer-Abhängigkeit; niemals für alle automatisch installieren +- **Wann angeboten:** Entwickler oder Team möchte strukturierte lokale Überprüfung und/oder CI-PR-Merge-Gate + ## Skills Skills sind wiederverwendbare Prozeduren, die namentlich aufgerufen werden. Eine Skill bündelt einen wiederholbaren Workflow (Tests ausführen, Lint beheben, Komponente erstellen). diff --git a/src/content/spec/en/addons.md b/src/content/spec/en/addons.md index a2b96f5..3298128 100644 --- a/src/content/spec/en/addons.md +++ b/src/content/spec/en/addons.md @@ -1,6 +1,6 @@ --- title: Add-ons -description: "Optional DWP extensions: the four shipping addons (devcontainer, Dailybot, dependency-upgrade, design-system), the addon contract, and kit concepts (skills, agents, presets, adapters, examples)." +description: "Optional DWP extensions: the five shipping addons (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), the addon contract, and kit concepts (skills, agents, presets, adapters, examples)." order: 5 lang: en section: Addons @@ -23,9 +23,9 @@ Every shipping addon ships four mandatory components: Discovery: the `onboard` flow enumerates `skills/deepworkplan/addons/` and presents each addon as an opt-in step in **Phase 7b**, after core scaffolding. -## Shipping addons (four) +## Shipping addons (five) -Four addons ship today. Each has a **kit catalog page** with user-facing detail and a **normative spec** inside the Deep Work Plan skill. +Five addons ship today. Each has a **kit catalog page** with user-facing detail and a **normative spec** inside the Deep Work Plan skill. ### Devcontainer (first addon) @@ -65,6 +65,18 @@ An interface-surface-scoped `DESIGN.md` any coding agent reads for consistent UI - **Profile strength:** visual-ui is **default-on when detected**; cli-output and conversational are **recommended when detected, always asked, never auto-applied** - **When offered:** only when a user-facing interface surface is detected — not for pure libraries, headless services, or infra-only repos +### AI Diff Reviewer (fifth addon) + +An opt-in connection to the **[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)** (marketplace **"AI Diff Reviewer"**, current **v2.0.0**) that augments the mandatory Security Review with a structured local review, and optionally gates pull requests in CI. + +- **Kit page:** [AI Diff Reviewer](/kit/ai-diff-reviewer) — full capability reference +- **What the DWP addon wires:** local Security Review augmentation via the upstream parent default flow; required `.review/extension.md` (skill alone is incomplete); Flow B optionally installs `pr-review.yml` (`DailybotHQ/ai-diff-reviewer@v2`) and surfaces `apply-review` as a developer-invoked companion — never a plan task +- **Flows:** **A — local-only** (skill + extension) or **B — dual-surface** (skill + extension + CI Action). The addon **MUST ask** which flow; never default +- **Soft-fail vs gate:** missing skill/extension/invocation errors never block; `critical` findings from a **completed** local pass still follow the Security Review contract +- **Parity (Flow B):** shared `prompt.md` + extension align methodology/severity; CI Iteration-Aware Review may shorten round 2+ while local stays a full pass +- **Vendor-neutral guardrail:** core DWP has **zero** AI Diff Reviewer dependency; never auto-install for everyone +- **When offered:** developer or team wants structured local review and/or a CI PR merge gate + ## Skills Skills are reusable procedures invoked by name. A skill packages a repeatable workflow (running tests, fixing lint, creating a component). diff --git a/src/content/spec/es/addons.md b/src/content/spec/es/addons.md index 85bb45e..6db50b3 100644 --- a/src/content/spec/es/addons.md +++ b/src/content/spec/es/addons.md @@ -1,6 +1,6 @@ --- title: Complementos -description: "Extensiones opcionales de DWP: los cuatro addons activos (devcontainer, Dailybot, dependency-upgrade, design-system), el contrato de addon y conceptos del kit." +description: "Extensiones opcionales de DWP: los cinco addons activos (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), el contrato de addon y conceptos del kit." order: 5 lang: es section: Addons @@ -23,9 +23,9 @@ Cada addon activo incluye cuatro componentes obligatorios: Descubrimiento: el flujo `onboard` enumera `skills/deepworkplan/addons/` y presenta cada addon como un paso opcional en la **Fase 7b**, tras el andamiaje central. -## Addons activos (cuatro) +## Addons activos (cinco) -Hoy hay cuatro addons activos. Cada uno tiene una **página del catálogo del kit** con detalle orientado al usuario y una **spec normativa** dentro de la skill de Deep Work Plan. +Hoy hay cinco addons activos. Cada uno tiene una **página del catálogo del kit** con detalle orientado al usuario y una **spec normativa** dentro de la skill de Deep Work Plan. ### Devcontainer (primer addon) @@ -65,6 +65,18 @@ Un `DESIGN.md` con alcance de superficie de interfaz que cualquier agente de cod - **Fuerza del perfil:** visual-ui está **activado por defecto cuando se detecta**; cli-output y conversational se **recomiendan cuando se detectan, siempre se preguntan, nunca se aplican automáticamente** - **Cuándo se ofrece:** solo cuando se detecta una superficie de interfaz orientada al usuario — no para bibliotecas puras, servicios sin interfaz o repos solo de infraestructura +### AI Diff Reviewer (quinto addon) + +Una conexión opcional al **[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)** (marketplace **«AI Diff Reviewer»**, versión actual **v2.0.0**) que amplía la Revisión de Seguridad obligatoria con una revisión local estructurada y, opcionalmente, bloquea los pull requests en CI. + +- **Página del kit:** [AI Diff Reviewer](/kit/ai-diff-reviewer) — referencia completa de capacidades +- **Qué conecta el addon de DWP:** ampliación local de la Revisión de Seguridad vía el flujo padre por defecto de la skill upstream; `.review/extension.md` requerido (la skill sola es incompleta); el Flujo B instala opcionalmente `pr-review.yml` (`DailybotHQ/ai-diff-reviewer@v2`) y expone `apply-review` como compañero invocable por el desarrollador — nunca como tarea del plan +- **Flujos:** **A — solo local** (skill + extensión) o **B — doble superficie** (skill + extensión + CI Action). El addon **DEBE preguntar** qué flujo elegir; nunca elegir por defecto +- **Fallo suave vs compuerta:** errores de skill/extensión/invocación ausentes nunca bloquean; los hallazgos `critical` de un pase local **completado** siguen el contrato de Revisión de Seguridad +- **Paridad (Flujo B):** el `prompt.md` compartido + extensión alinean metodología/severidad; la Revisión Consciente de Iteraciones de CI puede acortar la ronda 2+ mientras el pase local permanece completo +- **Salvaguarda neutral respecto al proveedor:** el DWP central tiene **cero** dependencia de AI Diff Reviewer; nunca instalar automáticamente para todos +- **Cuándo se ofrece:** el desarrollador o el equipo quiere revisión local estructurada y/o una compuerta de PR en CI + ## Habilidades Las habilidades son procedimientos reutilizables que se invocan por nombre. Una habilidad empaqueta un flujo de trabajo repetible (ejecutar pruebas, corregir el linter, crear un componente). diff --git a/src/content/spec/fr/addons.md b/src/content/spec/fr/addons.md index e40163d..0694d8c 100644 --- a/src/content/spec/fr/addons.md +++ b/src/content/spec/fr/addons.md @@ -1,6 +1,6 @@ --- title: Modules complémentaires -description: "Extensions DWP optionnelles : les quatre addons actifs (devcontainer, Dailybot, dependency-upgrade, design-system), le contrat d'addon et les concepts du kit." +description: "Extensions DWP optionnelles : les cinq addons actifs (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), le contrat d'addon et les concepts du kit." order: 5 lang: fr section: Addons @@ -23,7 +23,7 @@ Chaque addon actif fournit quatre composants obligatoires : Découverte : le flux `onboard` énumère `skills/deepworkplan/addons/` et présente chaque addon comme une étape opt-in dans la **Phase 7b**, après le scaffolding central. -## Addons actifs (quatre) +## Addons actifs (cinq) Quatre addons sont actifs aujourd'hui. Chacun a une **page du catalogue kit** avec des détails orientés utilisateur et une **spec normative** dans la skill Deep Work Plan. @@ -65,6 +65,18 @@ Un `DESIGN.md` à portée de surface d'interface que tout agent de codage lit po - **Force du profil :** visual-ui est **activé par défaut lorsqu'il est détecté** ; cli-output et conversational sont **recommandés lorsqu'ils sont détectés, toujours demandés, jamais appliqués automatiquement** - **Quand proposé :** uniquement lorsqu'une surface d'interface orientée utilisateur est détectée — pas pour les bibliothèques pures, services headless ou dépôts infra uniquement +### AI Diff Reviewer (cinquième addon) + +Une connexion optionnelle à l'**[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)** (marketplace **"AI Diff Reviewer"**, version actuelle **v2.0.0**) qui renforce la Revue de sécurité obligatoire avec une revue locale structurée et bloque optionnellement les pull requests en CI. + +- **Page kit :** [AI Diff Reviewer](/kit/ai-diff-reviewer) — référence complète des capacités +- **Ce que le DWP addon connecte :** renforcement local de la Revue de sécurité via le flux parent par défaut de la skill upstream ; `.review/extension.md` requis (la skill seule est incomplète) ; Flow B installe optionnellement `pr-review.yml` (`DailybotHQ/ai-diff-reviewer@v2`) et expose `apply-review` en tant que compagnon invocable par le développeur — jamais une tâche du plan +- **Flux :** **A — local uniquement** (skill + extension) ou **B — double surface** (skill + extension + CI Action). L'addon **DOIT demander** quel flux ; ne jamais supposer +- **Échec doux vs portail :** les erreurs de skill/extension/invocation manquantes ne bloquent jamais ; les résultats `critical` d'un passage local **terminé** suivent toujours le contrat de Revue de sécurité +- **Parité (Flow B) :** `prompt.md` partagé + extension aligne méthodologie/sévérité ; la Revue consciente des itérations CI peut raccourcir le round 2+ tandis que le passage local reste complet +- **Garde-fou neutre vis-à-vis du fournisseur :** le DWP central a **zéro** dépendance envers AI Diff Reviewer ; ne jamais installer automatiquement pour tous +- **Quand proposé :** développeur ou équipe souhaitant une revue locale structurée et/ou un portail de fusion de PR en CI + ## Skills Les skills sont des procédures réutilisables invoquées par nom. Une skill empaquette un flux de travail répétable (exécuter des tests, corriger le lint, créer un composant). diff --git a/src/content/spec/hi/addons.md b/src/content/spec/hi/addons.md index dd41c1d..822a7cc 100644 --- a/src/content/spec/hi/addons.md +++ b/src/content/spec/hi/addons.md @@ -1,6 +1,6 @@ --- title: ऐडऑन -description: "वैकल्पिक DWP विस्तार: चार shipping ऐडऑन (devcontainer, Dailybot, dependency-upgrade, design-system), ऐडऑन अनुबंध, और kit अवधारणाएँ (skills, agents, presets, adapters, examples)।" +description: "वैकल्पिक DWP विस्तार: पाँच shipping ऐडऑन (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), ऐडऑन अनुबंध, और kit अवधारणाएँ (skills, agents, presets, adapters, examples)।" order: 5 lang: hi section: Addons @@ -23,7 +23,7 @@ section: Addons खोज: `onboard` प्रवाह `skills/deepworkplan/addons/` को गिनता है और हर ऐडऑन को **Phase 7b** में ऑप्ट-इन चरण के रूप में प्रस्तुत करता है, कोर scaffolding के बाद। -## Shipping ऐडऑन (चार) +## Shipping ऐडऑन (पाँच) आज चार ऐडऑन ship होते हैं। हर एक का **kit catalog पृष्ठ** user-facing विवरण के साथ और Deep Work Plan स्किल के अंदर **normative spec** है। @@ -65,6 +65,18 @@ Package-manager-agnostic, बैच, सत्यापित, revertible depend - **Profile strength:** visual-ui **पता चलने पर default-on**; cli-output और conversational **पता चलने पर अनुशंसित, हमेशा पूछे जाते हैं, कभी auto-applied नहीं** - **कब प्रस्तावित:** केवल जब user-facing इंटरफ़ेस सतह पहचानी जाए — pure libraries, headless services, या infra-only रिपॉज़िटरी के लिए नहीं +### AI Diff Reviewer (पाँचवाँ ऐडऑन) + +**[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)** (marketplace **"AI Diff Reviewer"**, वर्तमान संस्करण **v2.0.0**) से एक वैकल्पिक संबंध जो अनिवार्य सुरक्षा समीक्षा को संरचित स्थानीय समीक्षा से बेहतर बनाता है और वैकल्पिक रूप से CI में pull requests को गेट करता है। + +- **Kit पृष्ठ:** [AI Diff Reviewer](/kit/ai-diff-reviewer) — पूर्ण क्षमता संदर्भ +- **DWP ऐडऑन जो जोड़ता है:** upstream skill के मूल डिफ़ॉल्ट प्रवाह के माध्यम से स्थानीय सुरक्षा समीक्षा वृद्धि; आवश्यक `.review/extension.md` (skill अकेले अपूर्ण है); Flow B वैकल्पिक रूप से `pr-review.yml` (`DailybotHQ/ai-diff-reviewer@v2`) इंस्टॉल करता है और `apply-review` को डेवलपर द्वारा इनवोक किए जाने वाले साथी के रूप में प्रस्तुत करता है — कभी प्लान टास्क के रूप में नहीं +- **प्रवाह:** **A — केवल स्थानीय** (skill + एक्सटेंशन) या **B — दोहरी सतह** (skill + एक्सटेंशन + CI Action)। ऐडऑन **अवश्य पूछना चाहिए** कौन सा प्रवाह; कभी डिफ़ॉल्ट न मानें +- **सॉफ्ट-फेल बनाम गेट:** अनुपस्थित skill/एक्सटेंशन/इनवोकेशन त्रुटियाँ कभी नहीं रोकतीं; एक **पूर्ण** स्थानीय पास से `critical` निष्कर्ष सुरक्षा समीक्षा अनुबंध का अनुसरण करते रहते हैं +- **समानता (Flow B):** साझा `prompt.md` + एक्सटेंशन पद्धति/गंभीरता संरेखित करते हैं; CI Iteration-Aware Review स्थानीय पास पूर्ण रहते हुए 2+ राउंड को छोटा कर सकता है +- **वेंडर-तटस्थ सुरक्षा:** कोर DWP की AI Diff Reviewer पर **शून्य** निर्भरता है; सभी के लिए कभी स्वचालित इंस्टॉल न करें +- **कब प्रस्तावित:** डेवलपर या टीम संरचित स्थानीय समीक्षा और/या CI PR मर्ज गेट चाहती है + ## Skills Skills नाम से invoke की जाने वाली पुनः-प्रयोज्य प्रक्रियाएँ हैं। एक skill दोहराने योग्य workflow पैकेज करती है (tests चलाना, lint ठीक करना, component बनाना)। diff --git a/src/content/spec/id/addons.md b/src/content/spec/id/addons.md index 5c869c8..a7d01b2 100644 --- a/src/content/spec/id/addons.md +++ b/src/content/spec/id/addons.md @@ -1,6 +1,6 @@ --- title: Add-on -description: "Ekstensi DWP opsional: empat addon yang dikirim (devcontainer, Dailybot, dependency-upgrade, design-system), kontrak addon, dan konsep kit (skill, agen, preset, adapter, contoh)." +description: "Ekstensi DWP opsional: lima addon yang dikirim (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), kontrak addon, dan konsep kit (skill, agen, preset, adapter, contoh)." order: 5 lang: id section: Addons @@ -23,7 +23,7 @@ Setiap addon yang dikirim menyediakan empat komponen wajib: Penemuan: alur `onboard` mengekstrak `skills/deepworkplan/addons/` dan menyajikan setiap addon sebagai langkah opt-in di **Fase 7b**, setelah scaffolding inti. -## Addon yang dikirim (empat) +## Addon yang dikirim (lima) Empat addon tersedia hari ini. Masing-masing memiliki **halaman katalog kit** dengan detail untuk pengguna dan **spec normatif** di dalam skill Deep Work Plan. @@ -65,6 +65,18 @@ Upgrade dependensi agnostik package manager, bertahap, tervalidasi, dan dapat di - **Kekuatan profil:** visual-ui **aktif default saat terdeteksi**; cli-output dan conversational **direkomendasikan saat terdeteksi, selalu ditanyakan, tidak pernah diterapkan otomatis** - **Kapan ditawarkan:** hanya ketika permukaan antarmuka pengguna terdeteksi — bukan untuk pustaka murni, layanan headless, atau repo hanya infrastruktur +### AI Diff Reviewer (addon kelima) + +Koneksi opsional ke **[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)** (marketplace **"AI Diff Reviewer"**, versi saat ini **v2.0.0**) yang meningkatkan Tinjauan Keamanan wajib dengan tinjauan lokal terstruktur dan secara opsional mengontrol pull request di CI. + +- **Halaman kit:** [AI Diff Reviewer](/kit/ai-diff-reviewer) — referensi kemampuan lengkap +- **Yang dihubungkan addon DWP:** peningkatan lokal Tinjauan Keamanan melalui alur default induk skill upstream; `.review/extension.md` wajib (skill saja tidak lengkap); Flow B secara opsional menginstal `pr-review.yml` (`DailybotHQ/ai-diff-reviewer@v2`) dan mengekspos `apply-review` sebagai pendamping yang dapat dipanggil pengembang — tidak pernah sebagai tugas rencana +- **Alur:** **A — hanya lokal** (skill + ekstensi) atau **B — permukaan ganda** (skill + ekstensi + CI Action). Addon **HARUS menanyakan** alur mana; tidak pernah mengasumsikan nilai default +- **Kegagalan lunak vs gerbang:** kesalahan skill/ekstensi/pemanggilan yang hilang tidak pernah memblokir; hasil `critical` dari penerusan lokal yang **selesai** masih mengikuti kontrak Tinjauan Keamanan +- **Paritas (Flow B):** `prompt.md` bersama + ekstensi menyelaraskan metodologi/tingkat keparahan; Tinjauan Sadar Iterasi CI dapat mempersingkat putaran 2+ sementara penerusan lokal tetap penuh +- **Pengamanan netral vendor:** DWP inti memiliki **nol** ketergantungan AI Diff Reviewer; tidak pernah menginstal otomatis untuk semua orang +- **Kapan ditawarkan:** pengembang atau tim menginginkan tinjauan lokal terstruktur dan/atau gerbang penggabungan PR CI + ## Skill Skill adalah prosedur yang dapat digunakan kembali yang dipanggil berdasarkan nama. Skill mengemas alur kerja yang dapat diulang (menjalankan tes, memperbaiki lint, membuat komponen). diff --git a/src/content/spec/it/addons.md b/src/content/spec/it/addons.md index e159ca3..6913b2d 100644 --- a/src/content/spec/it/addons.md +++ b/src/content/spec/it/addons.md @@ -1,6 +1,6 @@ --- title: Add-on -description: "Estensioni DWP opzionali: i quattro addon in produzione (devcontainer, Dailybot, dependency-upgrade, design-system), il contratto addon e i concetti del kit (skill, agenti, preset, adapter, esempi)." +description: "Estensioni DWP opzionali: i cinque addon in produzione (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), il contratto addon e i concetti del kit (skill, agenti, preset, adapter, esempi)." order: 5 lang: it section: Addons @@ -23,7 +23,7 @@ Ogni addon in produzione fornisce quattro componenti obbligatori: Scoperta: il flusso `onboard` enumera `skills/deepworkplan/addons/` e presenta ogni addon come passo opt-in nella **Fase 7b**, dopo lo scaffolding di base. -## Addon in produzione (quattro) +## Addon in produzione (cinque) Quattro addon sono disponibili oggi. Ognuno ha una **pagina del catalogo kit** con dettagli per l'utente e una **spec normativa** all'interno della skill Deep Work Plan. @@ -65,6 +65,18 @@ Un `DESIGN.md` con ambito di superficie di interfaccia che qualsiasi agente di c - **Forza del profilo:** visual-ui è **attivo di default se rilevato**; cli-output e conversational sono **consigliati se rilevati, sempre chiesti, mai applicati automaticamente** - **Quando offerto:** solo quando viene rilevata una superficie di interfaccia utente — non per librerie pure, servizi headless o repo solo infrastruttura +### AI Diff Reviewer (quinto addon) + +Una connessione opzionale all'**[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)** (marketplace **"AI Diff Reviewer"**, versione attuale **v2.0.0**) che potenzia la Revisione di Sicurezza obbligatoria con una revisione locale strutturata e blocca opzionalmente i pull request in CI. + +- **Pagina kit:** [AI Diff Reviewer](/kit/ai-diff-reviewer) — riferimento completo delle capacità +- **Cosa collega il DWP addon:** potenziamento locale della Revisione di Sicurezza tramite il flusso padre predefinito della skill upstream; `.review/extension.md` obbligatorio (la skill sola è incompleta); Flow B installa opzionalmente `pr-review.yml` (`DailybotHQ/ai-diff-reviewer@v2`) ed espone `apply-review` come compagno invocabile dallo sviluppatore — mai un task del piano +- **Flussi:** **A — solo locale** (skill + estensione) o **B — doppia superficie** (skill + estensione + CI Action). L'addon **DEVE chiedere** quale flusso; mai assumere un valore predefinito +- **Soft-fail vs gate:** errori di skill/estensione/invocazione mancante non bloccano mai; i risultati `critical` di un passaggio locale **completato** seguono ancora il contratto di Revisione di Sicurezza +- **Parità (Flow B):** `prompt.md` condiviso + estensione allineano metodologia/gravità; la Revisione CI consapevole delle iterazioni può abbreviare il round 2+ mentre il passaggio locale rimane completo +- **Salvaguarda neutrale rispetto al provider:** il DWP core ha **zero** dipendenza da AI Diff Reviewer; non installare mai automaticamente per tutti +- **Quando offerto:** sviluppatore o team vuole revisione locale strutturata e/o un gate di merge PR in CI + ## Skill Le skill sono procedure riutilizzabili invocate per nome. Una skill impacchetta un workflow ripetibile (eseguire test, correggere lint, creare un componente). diff --git a/src/content/spec/ja/addons.md b/src/content/spec/ja/addons.md index cf10848..9c9cc54 100644 --- a/src/content/spec/ja/addons.md +++ b/src/content/spec/ja/addons.md @@ -1,6 +1,6 @@ --- title: アドオン -description: "オプションの DWP 拡張:4 つの出荷済みアドオン(devcontainer、Dailybot、dependency-upgrade、design-system)、アドオン契約、およびキット概念(スキル、エージェント、プリセット、アダプター、例)。" +description: "オプションの DWP 拡張:5 つの出荷済みアドオン(devcontainer、Dailybot、dependency-upgrade、design-system、AI Diff Reviewer)、アドオン契約、およびキット概念(スキル、エージェント、プリセット、アダプター、例)。" order: 5 lang: ja section: Addons @@ -23,9 +23,9 @@ section: Addons 発見:`onboard` フローは `skills/deepworkplan/addons/` を列挙し、コアスキャフォールディング後の**フェーズ 7b**で各アドオンをオプトインステップとして提示。 -## 出荷済みアドオン(4 つ) +## 出荷済みアドオン(5 つ) -現在 4 つのアドオンが出荷されています。各々に**キットカタログページ**(ユーザー向け詳細)と Deep Work Plan スキル内の**規範スペック**があります。 +現在 5 つのアドオンが出荷されています。各々に**キットカタログページ**(ユーザー向け詳細)と Deep Work Plan スキル内の**規範スペック**があります。 ### Devcontainer(第 1 アドオン) @@ -65,6 +65,18 @@ section: Addons - **プロファイル強度:** visual-ui は検出時**デフォルトオン**;cli-output と conversational は検出時**推奨、常に確認、自動適用しない** - **提供タイミング:** ユーザー向けインターフェース表面が検出された場合のみ——純ライブラリ、ヘッドレスサービス、インフラのみのリポジトリには提供しない +### AI Diff Reviewer(第 5 アドオン) + +必須の Security Review を構造化されたローカルレビューで強化し、オプションで CI 内の pull request をゲートする **[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)**(marketplace **"AI Diff Reviewer"**、現在のバージョン **v2.0.0**)へのオプション接続。 + +- **キットページ:** [AI Diff Reviewer](/kit/ai-diff-reviewer) — 完全な機能リファレンス +- **DWP アドオンが接続するもの:** upstream スキルの親デフォルトフロー経由のローカル Security Review 強化;必須 `.review/extension.md`(スキル単体では不完全);Flow B はオプションで `pr-review.yml`(`DailybotHQ/ai-diff-reviewer@v2`)をインストールし、`apply-review` を開発者が呼び出せるコンパニオンとして公開——プランタスクには決してしない +- **フロー:** **A — ローカルのみ**(スキル + 拡張)または **B — デュアルサーフェス**(スキル + 拡張 + CI Action)。アドオンはどのフローか**必ず確認**;デフォルトは決して設定しない +- **ソフト失敗 vs ゲート:** スキル/拡張/呼び出しエラーが欠落しても決してブロックしない;**完了した**ローカルパスからの `critical` 結果は引き続き Security Review 契約に従う +- **同等性(Flow B):** 共有 `prompt.md` + 拡張が方法論/深刻度を整合;CI のイテレーション認識レビューでローカルパスを完全に保ちながらラウンド 2+ を短縮できる +- **ベンダー中立ガードレール:** コア DWP は AI Diff Reviewer への依存が**ゼロ**;決して全員に自動インストールしない +- **提供タイミング:** 開発者またはチームが構造化されたローカルレビューおよび/または CI PR マージゲートを求めているとき + ## スキル スキルは名前で呼び出す再利用可能な手順。スキルは反復可能なワークフロー(テスト実行、lint 修正、コンポーネント作成)をパッケージ化します。 diff --git a/src/content/spec/ko/addons.md b/src/content/spec/ko/addons.md index a8f7e03..d0939f0 100644 --- a/src/content/spec/ko/addons.md +++ b/src/content/spec/ko/addons.md @@ -1,6 +1,6 @@ --- title: 애드온 -description: "선택적 DWP 확장: 네 가지 출시 애드온(devcontainer, Dailybot, dependency-upgrade, design-system), 애드온 계약, 및 키트 개념(스킬, 에이전트, 프리셋, 어댑터, 예제)." +description: "선택적 DWP 확장: 다섯 가지 출시 애드온(devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), 애드온 계약, 및 키트 개념(스킬, 에이전트, 프리셋, 어댑터, 예제)." order: 5 lang: ko section: Addons @@ -23,7 +23,7 @@ section: Addons 발견: `onboard` 흐름은 `skills/deepworkplan/addons/`를 열거하고 핵심 스캐폴딩 후 **7b 단계**에서 각 애드온을 옵트인 단계로 제시합니다. -## 출시 애드온(네 가지) +## 출시 애드온(다섯 가지) 현재 네 가지 애드온이 출시됩니다. 각각 **키트 카탈로그 페이지**(사용자 대상 세부)와 Deep Work Plan 스킬 내 **규범 스펙**이 있습니다. @@ -65,6 +65,18 @@ section: Addons - **프로필 강도:** visual-ui는 감지 시 **기본 켜짐**; cli-output과 conversational은 감지 시 **권장, 항상 질문, 자동 적용 안 함** - **제안 시점:** 사용자 대상 인터페이스 표면이 감지된 경우에만 — 순수 라이브러리, 헤드리스 서비스 또는 인프라 전용 저장소에는 해당 없음 +### AI Diff Reviewer(다섯 번째 애드온) + +**[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)**(marketplace **"AI Diff Reviewer"**, 현재 버전 **v2.0.0**)에 대한 선택적 연결로, 필수 보안 검토를 구조화된 로컬 검토로 강화하고 선택적으로 CI에서 pull request를 게이트합니다. + +- **키트 페이지:** [AI Diff Reviewer](/kit/ai-diff-reviewer) — 전체 기능 참조 +- **DWP 애드온이 연결하는 것:** upstream skill의 부모 기본 플로우를 통한 로컬 보안 검토 강화; 필수 `.review/extension.md` (skill만으로는 불완전함); Flow B는 선택적으로 `pr-review.yml`(`DailybotHQ/ai-diff-reviewer@v2`)을 설치하고 `apply-review`를 개발자가 호출 가능한 컴패니언으로 제공 — 절대 플랜 작업이 아님 +- **플로우:** **A — 로컬 전용** (skill + 확장) 또는 **B — 이중 서피스** (skill + 확장 + CI Action). 애드온은 어떤 플로우인지 **반드시 질문해야 함**; 절대 기본값을 가정하지 않음 +- **소프트 실패 vs 게이트:** 누락된 skill/확장/호출 오류는 절대 차단하지 않음; **완료된** 로컬 패스의 `critical` 결과는 여전히 보안 검토 계약을 따름 +- **동일성(Flow B):** 공유 `prompt.md` + 확장으로 방법론/심각도 정렬; CI Iteration-Aware Review는 로컬 패스가 완전하게 유지되는 동안 2+ 라운드를 줄일 수 있음 +- **공급자 중립 보호:** 핵심 DWP는 AI Diff Reviewer에 대한 **제로** 의존성을 가짐; 모든 사람에게 절대 자동 설치하지 않음 +- **제안 시점:** 개발자 또는 팀이 구조화된 로컬 검토 및/또는 CI PR 병합 게이트를 원할 때 + ## 스킬 스킬은 이름으로 호출하는 재사용 가능한 절차. 스킬은 반복 가능한 워크플로(테스트 실행, lint 수정, 컴포넌트 생성)를 패키징합니다. diff --git a/src/content/spec/pl/addons.md b/src/content/spec/pl/addons.md index 71680c6..95fd077 100644 --- a/src/content/spec/pl/addons.md +++ b/src/content/spec/pl/addons.md @@ -1,6 +1,6 @@ --- title: Dodatki -description: "Opcjonalne rozszerzenia DWP: cztery dostępne addony (devcontainer, Dailybot, dependency-upgrade, design-system), kontrakt addonu oraz koncepcje kit (skille, agenci, presety, adaptery, przykłady)." +description: "Opcjonalne rozszerzenia DWP: pięć dostępnych addonów (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), kontrakt addonu oraz koncepcje kit (skille, agenci, presety, adaptery, przykłady)." order: 5 lang: pl section: Addons @@ -23,7 +23,7 @@ Każdy dostępny addon dostarcza cztery obowiązkowe komponenty: Odkrywanie: przepływ `onboard` enumeruje `skills/deepworkplan/addons/` i prezentuje każdy addon jako opcjonalny krok w **Phase 7b**, po podstawowym scaffoldingu. -## Dostępne addony (cztery) +## Dostępne addony (pięć) Dziś dostępne są cztery addony. Każdy ma **stronę katalogu kit** ze szczegółami dla użytkownika oraz **normatywną specyfikację** w skillu Deep Work Plan. @@ -65,6 +65,18 @@ Aktualizacje zależności niezależne od menedżera pakietów, partiami, zwalido - **Siła profilu:** visual-ui **domyślnie włączony przy wykryciu**; cli-output i conversational **zalecane przy wykryciu, zawsze pytane, nigdy auto-stosowane** - **Kiedy proponować:** tylko gdy wykryto powierzchnię interfejsu dla użytkownika — nie dla czystych bibliotek, usług headless ani repo tylko infra +### AI Diff Reviewer (piąty addon) + +Opcjonalne połączenie z **[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)** (marketplace **"AI Diff Reviewer"**, aktualna wersja **v2.0.0**), które rozszerza obowiązkowy Przegląd Bezpieczeństwa o strukturalny lokalny przegląd i opcjonalnie blokuje pull requesty w CI. + +- **Strona kit:** [AI Diff Reviewer](/kit/ai-diff-reviewer) — pełna referencja możliwości +- **Co addon DWP łączy:** lokalne wzmocnienie Przeglądu Bezpieczeństwa poprzez domyślny przepływ nadrzędny upstream skill; wymagane `.review/extension.md` (sama skill jest niepełna); Flow B opcjonalnie instaluje `pr-review.yml` (`DailybotHQ/ai-diff-reviewer@v2`) i udostępnia `apply-review` jako towarzysza wywoływanego przez dewelopera — nigdy jako zadanie planu +- **Przepływy:** **A — tylko lokalnie** (skill + rozszerzenie) lub **B — podwójna powierzchnia** (skill + rozszerzenie + CI Action). Addon **MUSI pytać** o przepływ; nigdy nie zakładać wartości domyślnej +- **Miękka porażka vs bramka:** brakujące błędy skill/rozszerzenia/wywołania nigdy nie blokują; wyniki `critical` z **zakończonego** lokalnego przebiegu nadal stosują kontrakt Przeglądu Bezpieczeństwa +- **Parytety (Flow B):** wspólny `prompt.md` + rozszerzenie wyrównuje metodologię/ważność; CI Iteration-Aware Review może skrócić rundy 2+ podczas gdy lokalny przebieg pozostaje pełny +- **Ochrona neutralna wobec dostawcy:** rdzeń DWP ma **zero** zależności od AI Diff Reviewer; nigdy nie instaluj automatycznie dla wszystkich +- **Kiedy proponować:** deweloper lub zespół chce strukturalnego lokalnego przeglądu i/lub bramki scalania PR CI + ## Skille Skille to powtarzalne procedury wywoływane po nazwie. Skill pakuje powtarzalny przepływ pracy (uruchamianie testów, naprawa lintu, tworzenie komponentu). diff --git a/src/content/spec/pt/addons.md b/src/content/spec/pt/addons.md index 746fcd6..0cdd1ea 100644 --- a/src/content/spec/pt/addons.md +++ b/src/content/spec/pt/addons.md @@ -1,6 +1,6 @@ --- title: Complementos -description: "Extensões opcionais do DWP: os quatro addons ativos (devcontainer, Dailybot, dependency-upgrade, design-system), o contrato de addon e conceitos do kit." +description: "Extensões opcionais do DWP: os cinco addons ativos (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), o contrato de addon e conceitos do kit." order: 5 lang: pt section: Addons @@ -23,9 +23,9 @@ Cada addon ativo inclui quatro componentes obrigatórios: Descoberta: o fluxo `onboard` enumera `skills/deepworkplan/addons/` e apresenta cada addon como um passo opcional na **Fase 7b**, após o scaffolding central. -## Addons ativos (quatro) +## Addons ativos (cinco) -Quatro addons estão ativos hoje. Cada um tem uma **página do catálogo do kit** com detalhe orientado ao utilizador e uma **spec normativa** dentro da skill Deep Work Plan. +Cinco addons estão ativos hoje. Cada um tem uma **página do catálogo do kit** com detalhe orientado ao utilizador e uma **spec normativa** dentro da skill Deep Work Plan. ### Devcontainer (primeiro addon) @@ -65,6 +65,18 @@ Um `DESIGN.md` com âmbito de superfície de interface que qualquer agente de co - **Força do perfil:** visual-ui está **ativado por defeito quando detetado**; cli-output e conversational são **recomendados quando detetados, sempre perguntados, nunca aplicados automaticamente** - **Quando oferecido:** apenas quando uma superfície de interface orientada ao utilizador é detetada — não para bibliotecas puras, serviços sem interface ou repositórios só de infraestrutura +### AI Diff Reviewer (quinto addon) + +Uma ligação opcional ao **[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)** (marketplace **"AI Diff Reviewer"**, versão atual **v2.0.0**) que aumenta a Revisão de Segurança obrigatória com uma revisão local estruturada e, opcionalmente, controla os pull requests em CI. + +- **Página do kit:** [AI Diff Reviewer](/kit/ai-diff-reviewer) — referência completa de capacidades +- **O que o addon DWP liga:** ampliação local da Revisão de Segurança via o fluxo pai predefinido da skill upstream; `.review/extension.md` obrigatório (a skill sozinha está incompleta); o Fluxo B instala opcionalmente `pr-review.yml` (`DailybotHQ/ai-diff-reviewer@v2`) e expõe `apply-review` como companheiro invocável pelo programador — nunca como tarefa do plano +- **Fluxos:** **A — apenas local** (skill + extensão) ou **B — dupla superfície** (skill + extensão + CI Action). O addon **DEVE perguntar** qual fluxo; nunca assumir +- **Falha suave vs portão:** erros de skill/extensão/invocação ausentes nunca bloqueiam; resultados `critical` de uma passagem local **concluída** seguem o contrato de Revisão de Segurança +- **Paridade (Fluxo B):** `prompt.md` partilhado + extensão alinham metodologia/severidade; a Revisão com Consciência de Iteração de CI pode encurtar a ronda 2+ enquanto a passagem local permanece completa +- **Salvaguarda neutra em relação ao fornecedor:** o DWP central tem **zero** dependência do AI Diff Reviewer; nunca instalar automaticamente para todos +- **Quando oferecido:** programador ou equipa quer revisão local estruturada e/ou um portão de PR em CI + ## Skills As skills são procedimentos reutilizáveis invocados por nome. Uma skill empacota um fluxo de trabalho repetível (executar testes, corrigir lint, criar um componente). diff --git a/src/content/spec/ru/addons.md b/src/content/spec/ru/addons.md index a535e9a..ad463fa 100644 --- a/src/content/spec/ru/addons.md +++ b/src/content/spec/ru/addons.md @@ -1,6 +1,6 @@ --- title: Аддоны -description: "Опциональные расширения DWP: четыре поставляемых аддона (devcontainer, Dailybot, dependency-upgrade, design-system), контракт аддона и концепции kit (навыки, агенты, пресеты, адаптеры, примеры)." +description: "Опциональные расширения DWP: пять поставляемых аддонов (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), контракт аддона и концепции kit (навыки, агенты, пресеты, адаптеры, примеры)." order: 5 lang: ru section: Addons @@ -23,7 +23,7 @@ section: Addons Обнаружение: поток `onboard` перечисляет `skills/deepworkplan/addons/` и представляет каждый аддон как опциональный шаг в **фазе 7b** после базового каркаса. -## Поставляемые аддоны (четыре) +## Поставляемые аддоны (пять) Сегодня поставляются четыре аддона. У каждого есть **страница каталога kit** с пользовательскими деталями и **нормативная спецификация** внутри навыка Deep Work Plan. @@ -65,6 +65,18 @@ section: Addons - **Сила профилей:** visual-ui **включён по умолчанию при обнаружении**; cli-output и conversational **рекомендуются при обнаружении, всегда спрашиваются, никогда не применяются автоматически** - **Когда предлагается:** только при обнаружении пользовательской интерфейсной поверхности — не для чистых библиотек, headless-сервисов или репозиториев только с инфраструктурой +### AI Diff Reviewer (пятый аддон) + +Опциональная связь с **[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)** (marketplace **«AI Diff Reviewer»**, текущая версия **v2.0.0**), дополняющая обязательную Проверку безопасности структурированным локальным анализом и опционально блокирующая pull request'ы в CI. + +- **Страница kit:** [AI Diff Reviewer](/kit/ai-diff-reviewer) — полный справочник возможностей +- **Что подключает аддон DWP:** локальное усиление Проверки безопасности через родительский поток по умолчанию вышестоящего skill; обязательный `.review/extension.md` (skill в одиночку неполна); Flow B опционально устанавливает `pr-review.yml` (`DailybotHQ/ai-diff-reviewer@v2`) и открывает `apply-review` как компаньон, вызываемый разработчиком — никогда не задача плана +- **Потоки:** **A — только локально** (skill + расширение) или **B — двойная поверхность** (skill + расширение + CI Action). Аддон **ОБЯЗАН спрашивать** о потоке; никогда не использовать значение по умолчанию +- **Мягкий сбой vs шлюз:** отсутствующие ошибки skill/расширения/вызова никогда не блокируют; находки `critical` из **завершённого** локального прохода по-прежнему следуют контракту Проверки безопасности +- **Паритет (Flow B):** общий `prompt.md` + расширение согласовывает методологию/серьёзность; итерационно-осознанная проверка CI может сократить раунды 2+ при полном локальном проходе +- **Нейтральная защита от привязки к вендору:** ядро DWP имеет **нулевую** зависимость от AI Diff Reviewer; никогда не устанавливать автоматически для всех +- **Когда предлагается:** разработчик или команда хочет структурированного локального анализа и/или CI PR merge gate + ## Навыки Навыки — переиспользуемые процедуры, вызываемые по имени. Навык упаковывает повторяемый workflow (запуск тестов, исправление lint, создание компонента). diff --git a/src/content/spec/th/addons.md b/src/content/spec/th/addons.md index 8a1cd25..a729e54 100644 --- a/src/content/spec/th/addons.md +++ b/src/content/spec/th/addons.md @@ -1,6 +1,6 @@ --- title: ส่วนเสริม -description: "ส่วนขยาย DWP แบบเลือกได้: สี่ addon ที่จัดส่ง (devcontainer, Dailybot, dependency-upgrade, design-system) สัญญา addon และแนวคิด kit (skills, agents, presets, adapters, examples)" +description: "ส่วนขยาย DWP แบบเลือกได้: ห้า addon ที่จัดส่ง (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer) สัญญา addon และแนวคิด kit (skills, agents, presets, adapters, examples)" order: 5 lang: th section: Addons @@ -23,7 +23,7 @@ section: Addons การค้นพบ: ขั้นตอน `onboard` นับ `skills/deepworkplan/addons/` และนำเสนอแต่ละ addon เป็นขั้นตอน opt-in ใน **Phase 7b** หลัง scaffolding หลัก -## Addon ที่จัดส่ง (สี่ตัว) +## Addon ที่จัดส่ง (ห้าตัว) วันนี้มีสี่ addon แต่ละตัวมี **หน้าแคตตาล็อก kit** พร้อมรายละเอียดสำหรับผู้ใช้ และ **spec normative** ภายใน skill Deep Work Plan @@ -65,6 +65,18 @@ section: Addons - **ความแรงของ profile:** visual-ui **เปิดโดยค่าเริ่มต้นเมื่อตรวจพบ** cli-output และ conversational **แนะนำเมื่อตรวจพบ ถามเสมอ ไม่ auto-apply** - **เมื่อเสนอ:** เฉพาะเมื่อตรวจพบพื้นผิวอินเทอร์เฟซสำหรับผู้ใช้ — ไม่ใช่ไลบรารีล้วน บริการ headless หรือรีโพ infra เท่านั้น +### AI Diff Reviewer (addon ที่ห้า) + +การเชื่อมต่อแบบเลือกใช้กับ **[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)** (marketplace **"AI Diff Reviewer"** เวอร์ชันปัจจุบัน **v2.0.0**) ที่เสริมการตรวจสอบความปลอดภัยบังคับด้วยการตรวจสอบในเครื่องแบบมีโครงสร้าง และเลือกที่จะควบคุม pull request ใน CI + +- **หน้า kit:** [AI Diff Reviewer](/kit/ai-diff-reviewer) — ข้อมูลอ้างอิงความสามารถเต็มรูปแบบ +- **สิ่งที่ DWP addon เชื่อมต่อ:** การเสริมการตรวจสอบความปลอดภัยในเครื่องผ่านโฟลว์หลักเริ่มต้นของ skill ต้นทาง; `.review/extension.md` ที่จำเป็น (skill เพียงอย่างเดียวไม่สมบูรณ์); Flow B ติดตั้ง `pr-review.yml` (`DailybotHQ/ai-diff-reviewer@v2`) ตามเลือกและนำเสนอ `apply-review` เป็นผู้ช่วยที่นักพัฒนาเรียกใช้ได้ — ไม่เคยเป็นไฟล์งานของแผน +- **โฟลว์:** **A — เฉพาะในเครื่อง** (skill + ส่วนขยาย) หรือ **B — สองพื้นผิว** (skill + ส่วนขยาย + CI Action) addon **ต้องถาม** โฟลว์ใด; ไม่เคยสันนิษฐานค่าเริ่มต้น +- **ความล้มเหลวแบบนุ่มนวลเทียบกับเกท:** ข้อผิดพลาดของ skill/ส่วนขยาย/การเรียกที่หายไปไม่เคยบล็อก; ผลการค้นพบ `critical` จากการรันในเครื่องที่ **เสร็จสิ้น** ยังคงปฏิบัติตามสัญญาการตรวจสอบความปลอดภัย +- **ความเท่าเทียม (Flow B):** `prompt.md` ที่ใช้ร่วมกัน + ส่วนขยายจัดแนวระเบียบวิธีและระดับความรุนแรง; Iteration-Aware Review ของ CI อาจทำให้รอบที่ 2+ สั้นลงในขณะที่การรันในเครื่องยังคงสมบูรณ์ +- **การป้องกันที่เป็นกลางต่อผู้ให้บริการ:** DWP หลักมีการพึ่งพา AI Diff Reviewer **เป็นศูนย์**; ไม่เคยติดตั้งให้ทุกคนโดยอัตโนมัติ +- **เมื่อเสนอ:** นักพัฒนาหรือทีมต้องการการตรวจสอบในเครื่องแบบมีโครงสร้างและ/หรือเกทการรวม PR CI + ## Skills Skills เป็นขั้นตอนที่ใช้ซ้ำได้ เรียกด้วยชื่อ skill ห่อ workflow ที่ทำซ้ำได้ (รันเทสต์ แก้ lint สร้างคอมโพเนนต์) diff --git a/src/content/spec/tr/addons.md b/src/content/spec/tr/addons.md index f851974..ca514c2 100644 --- a/src/content/spec/tr/addons.md +++ b/src/content/spec/tr/addons.md @@ -1,6 +1,6 @@ --- title: Eklentiler -description: "İsteğe bağlı DWP uzantıları: dört üretim eklentisi (devcontainer, Dailybot, dependency-upgrade, design-system), eklenti sözleşmesi ve kit kavramları (skill'ler, agent'lar, preset'ler, adapter'lar, örnekler)." +description: "İsteğe bağlı DWP uzantıları: beş üretim eklentisi (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), eklenti sözleşmesi ve kit kavramları (skill'ler, agent'lar, preset'ler, adapter'lar, örnekler)." order: 5 lang: tr section: Addons @@ -23,7 +23,7 @@ Her üretim eklentisi dört zorunlu bileşen sunar: Keşif: `onboard` akışı `skills/deepworkplan/addons/` dizinini numaralandırır ve her eklentiyi temel iskeletten sonra **Faz 7b**'de opt-in adım olarak sunar. -## Üretim eklentileri (dört) +## Üretim eklentileri (beş) Bugün dört eklenti sunulmaktadır. Her birinin kullanıcıya yönelik ayrıntılı bir **kit katalog sayfası** ve Deep Work Plan skill'i içinde **normatif spec**'i vardır. @@ -65,6 +65,18 @@ Tutarlı UI, CLI veya konuşma çıktısı için herhangi bir kodlama agent'ın - **Profil gücü:** visual-ui **tespit edildiğinde varsayılan açık**; cli-output ve conversational **tespit edildiğinde önerilir, her zaman sorulur, asla otomatik uygulanmaz** - **Ne zaman sunulur:** yalnızca kullanıcıya yönelik arayüz yüzeyi tespit edildiğinde — saf kütüphaneler, headless servisler veya yalnızca altyapı depoları için değil +### AI Diff Reviewer (beşinci eklenti) + +Zorunlu Güvenlik İncelemesini yapılandırılmış yerel bir incelemeyle güçlendiren ve isteğe bağlı olarak CI'da pull request'leri kapı altına alan **[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)**'a (marketplace **"AI Diff Reviewer"**, mevcut sürüm **v2.0.0**) isteğe bağlı bir bağlantı. + +- **Kit sayfası:** [AI Diff Reviewer](/kit/ai-diff-reviewer) — tam yetenek referansı +- **DWP eklentisinin bağladıkları:** upstream skill'in üst varsayılan akışı aracılığıyla yerel Güvenlik İncelemesi güçlendirmesi; gerekli `.review/extension.md` (skill tek başına eksiktir); Flow B isteğe bağlı olarak `pr-review.yml` (`DailybotHQ/ai-diff-reviewer@v2`) yükler ve `apply-review`'i geliştirici tarafından çağrılabilir bir yardımcı olarak sunar — asla bir plan görevi değil +- **Akışlar:** **A — yalnızca yerel** (skill + uzantı) veya **B — çift yüzey** (skill + uzantı + CI Action). Eklenti **MUTLAKA sormalıdır** hangi akışın seçileceğini; asla varsayılan seçmemeli +- **Yumuşak başarısızlık vs kapı:** eksik skill/uzantı/çağrı hataları asla bloke etmez; **tamamlanmış** bir yerel geçişten gelen `critical` sonuçlar hâlâ Güvenlik İncelemesi sözleşmesini izler +- **Eşlik (Flow B):** paylaşılan `prompt.md` + uzantı metodoloji/önem derecesini hizalar; CI Yineleme Farkındalıklı İnceleme, yerel geçiş tam kalırken 2.+ turları kısaltabilir +- **Sağlayıcıdan bağımsız güvence:** çekirdek DWP'nin AI Diff Reviewer'a **sıfır** bağımlılığı vardır; asla herkes için otomatik yükleme +- **Ne zaman teklif edilir:** geliştirici veya ekip yapılandırılmış yerel inceleme ve/veya CI PR birleştirme kapısı ister + ## Skill'ler Skill'ler adıyla çağrılan yeniden kullanılabilir prosedürlerdir. Bir skill tekrarlanabilir bir iş akışını paketler (test çalıştırma, lint düzeltme, bileşen oluşturma). diff --git a/src/content/spec/uk/addons.md b/src/content/spec/uk/addons.md index b0973d7..abf1d18 100644 --- a/src/content/spec/uk/addons.md +++ b/src/content/spec/uk/addons.md @@ -1,6 +1,6 @@ --- title: Додатки -description: "Опційні розширення DWP: чотири shipping-аддони (devcontainer, Dailybot, dependency-upgrade, design-system), контракт аддона та концепції kit (скіли, агенти, пресети, адаптери, приклади)." +description: "Опційні розширення DWP: п'ять shipping-аддонів (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), контракт аддона та концепції kit (скіли, агенти, пресети, адаптери, приклади)." order: 5 lang: uk section: Addons @@ -23,7 +23,7 @@ section: Addons Виявлення: потік `onboard` перераховує `skills/deepworkplan/addons/` і представляє кожен аддон як опційний крок у **Phase 7b**, після основного scaffolding. -## Shipping-аддони (чотири) +## Shipping-аддони (п'ять) Сьогодні доступні чотири аддони. Кожен має **сторінку каталогу kit** з деталями для користувача та **нормативну spec** у скілі Deep Work Plan. @@ -65,6 +65,18 @@ Compose-налаштування `.devcontainer/` + `docker/`, виведене - **Сила профілю:** visual-ui **увімкнено за замовчуванням при виявленні**; cli-output і conversational **рекомендовані при виявленні, завжди питаються, ніколи не auto-applied** - **Коли пропонувати:** лише коли виявлено user-facing поверхню інтерфейсу — не для чистих бібліотек, headless-сервісів чи infra-only репозиторіїв +### AI Diff Reviewer (п'ятий аддон) + +Необов'язковий зв'язок з **[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)** (marketplace **«AI Diff Reviewer»**, поточна версія **v2.0.0**), що розширює обов'язковий Огляд безпеки структурованим локальним оглядом і необов'язково контролює pull request у CI. + +- **Сторінка kit:** [AI Diff Reviewer](/kit/ai-diff-reviewer) — повна довідка можливостей +- **Що підключає DWP аддон:** локальне підсилення Огляду безпеки через типовий батьківський потік вихідного skill; обов'язковий `.review/extension.md` (skill сама по собі є неповною); Flow B необов'язково встановлює `pr-review.yml` (`DailybotHQ/ai-diff-reviewer@v2`) та надає `apply-review` як супутника, що викликається розробником — ніколи не як завдання плану +- **Потоки:** **A — лише локально** (skill + розширення) або **B — подвійна поверхня** (skill + розширення + CI Action). Аддон **ПОВИНЕН запитувати** про потік; ніколи не вибирати типовий +- **М'який збій проти шлюзу:** відсутні помилки skill/розширення/виклику ніколи не блокують; знахідки `critical` із **завершеного** локального проходу все ще дотримуються контракту Огляду безпеки +- **Паритет (Flow B):** спільний `prompt.md` + розширення вирівнює методологію/серйозність; CI Iteration-Aware Review може скоротити раунди 2+ поки локальний прохід залишається повним +- **Нейтральний захист щодо постачальника:** ядро DWP має **нульову** залежність від AI Diff Reviewer; ніколи не встановлювати автоматично для всіх +- **Коли пропонувати:** розробник або команда хоче структурований локальний огляд та/або CI PR merge gate + ## Скіли Скіли — багаторазові процедури, що викликаються за іменем. Скіл пакує повторюваний workflow (запуск тестів, виправлення lint, створення компонента). diff --git a/src/content/spec/vi/addons.md b/src/content/spec/vi/addons.md index 8c28ea0..13d4555 100644 --- a/src/content/spec/vi/addons.md +++ b/src/content/spec/vi/addons.md @@ -1,6 +1,6 @@ --- title: Add-on -description: "Phần mở rộng DWP tùy chọn: bốn addon đang phát hành (devcontainer, Dailybot, dependency-upgrade, design-system), hợp đồng addon và khái niệm kit (skill, agent, preset, adapter, ví dụ)." +description: "Phần mở rộng DWP tùy chọn: năm addon đang phát hành (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), hợp đồng addon và khái niệm kit (skill, agent, preset, adapter, ví dụ)." order: 5 lang: vi section: Addons @@ -23,7 +23,7 @@ Mỗi addon đang phát hành cung cấp bốn thành phần bắt buộc: Khám phá: luồng `onboard` liệt kê `skills/deepworkplan/addons/` và trình bày mỗi addon như bước opt-in trong **Giai đoạn 7b**, sau scaffolding cốt lõi. -## Addon đang phát hành (bốn) +## Addon đang phát hành (năm) Hôm nay có bốn addon. Mỗi addon có **trang danh mục kit** với chi tiết hướng người dùng và **spec chuẩn** bên trong skill Deep Work Plan. @@ -65,6 +65,18 @@ Nâng cấp phụ thuộc không phụ thuộc package manager, theo lô, đã x - **Độ mạnh hồ sơ:** visual-ui **bật mặc định khi phát hiện**; cli-output và conversational **khuyến nghị khi phát hiện, luôn hỏi, không bao giờ tự áp dụng** - **Khi đề xuất:** chỉ khi phát hiện bề mặt giao diện người dùng — không cho thư viện thuần, dịch vụ headless hoặc repo chỉ hạ tầng +### AI Diff Reviewer (addon thứ năm) + +Kết nối tùy chọn với **[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)** (marketplace **"AI Diff Reviewer"**, phiên bản hiện tại **v2.0.0**) tăng cường Đánh giá Bảo mật bắt buộc với đánh giá cục bộ có cấu trúc và tùy chọn kiểm soát các pull request trong CI. + +- **Trang kit:** [AI Diff Reviewer](/kit/ai-diff-reviewer) — tài liệu tham khảo khả năng đầy đủ +- **Những gì DWP addon kết nối:** tăng cường Đánh giá Bảo mật cục bộ qua luồng mặc định của skill thượng nguồn; `.review/extension.md` bắt buộc (skill đơn lẻ là chưa đủ); Flow B tùy chọn cài đặt `pr-review.yml` (`DailybotHQ/ai-diff-reviewer@v2`) và hiển thị `apply-review` như một công cụ đồng hành do nhà phát triển gọi — không bao giờ là tệp nhiệm vụ kế hoạch +- **Luồng:** **A — chỉ cục bộ** (skill + tiện ích mở rộng) hoặc **B — hai bề mặt** (skill + tiện ích mở rộng + CI Action). Addon **PHẢI hỏi** luồng nào; không bao giờ mặc định +- **Thất bại nhẹ vs cổng:** lỗi skill/tiện ích mở rộng/gọi bị thiếu không bao giờ chặn; kết quả `critical` từ lượt kiểm tra cục bộ **hoàn tất** vẫn theo hợp đồng Đánh giá Bảo mật +- **Tương đồng (Flow B):** `prompt.md` dùng chung + tiện ích mở rộng căn chỉnh phương pháp luận/mức độ nghiêm trọng; Đánh giá Nhận thức Lặp lại CI có thể rút ngắn vòng 2+ trong khi lượt kiểm tra cục bộ vẫn đầy đủ +- **Bảo vệ trung lập với nhà cung cấp:** DWP cốt lõi có **không** phụ thuộc AI Diff Reviewer; không bao giờ cài đặt tự động cho tất cả mọi người +- **Khi nào được cung cấp:** nhà phát triển hoặc nhóm muốn đánh giá cục bộ có cấu trúc và/hoặc cổng hợp nhất PR CI + ## Skill Skill là quy trình tái sử dụng được gọi theo tên. Skill đóng gói luồng công việc lặp lại (chạy test, sửa lint, tạo thành phần). diff --git a/src/content/spec/zh/addons.md b/src/content/spec/zh/addons.md index 13ef272..7dc47ff 100644 --- a/src/content/spec/zh/addons.md +++ b/src/content/spec/zh/addons.md @@ -1,6 +1,6 @@ --- title: 附加组件 -description: "可选 DWP 扩展:四个已发布的附加组件(devcontainer、Dailybot、dependency-upgrade、design-system)、附加组件合约,以及套件概念(技能、代理、预设、适配器、示例)。" +description: "可选 DWP 扩展:五个已发布的附加组件(devcontainer、Dailybot、dependency-upgrade、design-system、AI Diff Reviewer)、附加组件合约,以及套件概念(技能、代理、预设、适配器、示例)。" order: 5 lang: zh section: Addons @@ -23,9 +23,9 @@ section: Addons 发现机制:`onboard` 流程枚举 `skills/deepworkplan/addons/`,并在核心脚手架完成后的 **第 7b 阶段**将每个附加组件作为可选步骤呈现。 -## 已发布的附加组件(四个) +## 已发布的附加组件(五个) -当前发布四个附加组件。每个都有**套件目录页**(面向用户的详情)以及 Deep Work Plan 技能内的**规范性规格**。 +当前发布五个附加组件。每个都有**套件目录页**(面向用户的详情)以及 Deep Work Plan 技能内的**规范性规格**。 ### Devcontainer(第一个附加组件) @@ -65,6 +65,18 @@ section: Addons - **配置档强度:** 检测到 visual-ui 时**默认开启**;检测到 cli-output 与 conversational 时**推荐、始终询问、绝不自动应用** - **何时提供:** 仅当检测到面向用户的界面表面时——不适用于纯库、无头服务或纯基础设施仓库 +### AI Diff Reviewer(第五个附加组件) + +与 **[AI Diff Reviewer](https://github.com/DailybotHQ/ai-diff-reviewer)**(marketplace **"AI Diff Reviewer"**,当前版本 **v2.0.0**)的可选连接,通过结构化的本地审查增强强制性安全审查,并可选地在 CI 中对拉取请求设置门控。 + +- **套件页:** [AI Diff Reviewer](/kit/ai-diff-reviewer) — 完整能力参考 +- **DWP 附加组件接入的内容:** 通过上游 skill 父级默认流的本地安全审查增强;需要 `.review/extension.md`(仅 skill 不完整);Flow B 可选安装 `pr-review.yml`(`DailybotHQ/ai-diff-reviewer@v2`)并将 `apply-review` 作为开发者调用的伴随工具公开——绝不作为计划任务 +- **流程:** **A — 仅本地**(skill + 扩展)或 **B — 双层面**(skill + 扩展 + CI Action)。附加组件**必须询问**哪个流程;绝不默认 +- **软失败 vs 门控:** 缺少 skill/扩展/调用错误绝不阻塞;来自**已完成**本地通道的 `critical` 结果仍遵循安全审查合同 +- **奇偶性(Flow B):** 共享 `prompt.md` + 扩展对齐方法论/严重程度;CI 迭代感知审查可缩短第 2+ 轮,而本地通道保持完整 +- **供应商中立护栏:** 核心 DWP 对 AI Diff Reviewer **零**依赖;切勿为所有人自动安装 +- **何时提供:** 开发者或团队想要结构化本地审查和/或 CI PR 合并门控 + ## 技能 技能是按名称调用的可复用过程。一项技能将可重复的工作流打包(运行测试、修复 lint、创建组件)。 diff --git a/src/lib/translations/de.ts b/src/lib/translations/de.ts index f3d893a..6596dba 100644 --- a/src/lib/translations/de.ts +++ b/src/lib/translations/de.ts @@ -638,7 +638,7 @@ export const de: SiteTranslations = { { title: 'Das Kit weiterentwickeln und Addons annehmen', description: - 'Nutzen Sie /skill-create und /agent-create (die author-Sub-Skill), um stack-passende Skills, Agenten und Befehle aufzubauen. Das Onboarding bietet außerdem vier Opt-in-Addons — devcontainer, Dailybot, dependency-upgrade und design-system —, die Sie nur annehmen, wenn sie passen.', + 'Nutzen Sie /skill-create und /agent-create (die author-Sub-Skill), um stack-passende Skills, Agenten und Befehle aufzubauen. Das Onboarding bietet außerdem fünf Opt-in-Addons — devcontainer, Dailybot, dependency-upgrade, design-system und AI Diff Reviewer —, die Sie nur annehmen, wenn sie passen.', }, { title: 'Planen und ausführen', @@ -711,7 +711,7 @@ export const de: SiteTranslations = { { title: 'Opt-in-Addons annehmen', description: - 'Das Onboarding bietet vier Opt-in-Addons — devcontainer, Dailybot, dependency-upgrade und design-system —, die Sie nur annehmen, wenn sie passen. Ein Repository ist mit null Addons vollständig konform. Nutzen Sie /skill-create und /agent-create (die author-Sub-Skill), um stack-passende Skills, Agenten und Befehle über die Basislinie hinaus aufzubauen.', + 'Das Onboarding bietet fünf Opt-in-Addons — devcontainer, Dailybot, dependency-upgrade, design-system und AI Diff Reviewer —, die Sie nur annehmen, wenn sie passen. Ein Repository ist mit null Addons vollständig konform. Nutzen Sie /skill-create und /agent-create (die author-Sub-Skill), um stack-passende Skills, Agenten und Befehle über die Basislinie hinaus aufzubauen.', }, { title: 'Planen und ausführen', diff --git a/src/lib/translations/en.ts b/src/lib/translations/en.ts index 6afd9f5..0351cc2 100644 --- a/src/lib/translations/en.ts +++ b/src/lib/translations/en.ts @@ -630,7 +630,7 @@ export const en: SiteTranslations = { { title: 'Evolve the kit and accept addons', description: - 'Use /skill-create and /agent-create (the author sub-skill) to grow stack-appropriate skills, agents, and commands. Onboarding also offers four opt-in addons — devcontainer, Dailybot, dependency-upgrade, and design-system — that you accept only when they fit.', + 'Use /skill-create and /agent-create (the author sub-skill) to grow stack-appropriate skills, agents, and commands. Onboarding also offers five opt-in addons — devcontainer, Dailybot, dependency-upgrade, design-system, and AI Diff Reviewer — that you accept only when they fit.', }, { title: 'Plan and execute', @@ -703,7 +703,7 @@ export const en: SiteTranslations = { { title: 'Accept opt-in addons', description: - 'Onboarding offers four opt-in addons — devcontainer, Dailybot, dependency-upgrade, and design-system — that you accept only when they fit. A repo is fully conformant with zero addons. Use /skill-create and /agent-create (the author sub-skill) to grow stack-appropriate skills, agents, and commands beyond the baseline.', + 'Onboarding offers five opt-in addons — devcontainer, Dailybot, dependency-upgrade, design-system, and AI Diff Reviewer — that you accept only when they fit. A repo is fully conformant with zero addons. Use /skill-create and /agent-create (the author sub-skill) to grow stack-appropriate skills, agents, and commands beyond the baseline.', }, { title: 'Plan and execute', diff --git a/src/lib/translations/es.ts b/src/lib/translations/es.ts index 1b752f5..005c3d3 100644 --- a/src/lib/translations/es.ts +++ b/src/lib/translations/es.ts @@ -632,7 +632,7 @@ export const es: SiteTranslations = { { title: 'Evoluciona el kit y acepta addons', description: - 'Usa /skill-create y /agent-create (la sub-skill author) para hacer crecer skills, agentes y comandos adaptados a tu stack. La incorporación también ofrece cuatro addons opcionales — devcontainer, Dailybot, dependency-upgrade y design-system — que aceptas solo cuando encajan.', + 'Usa /skill-create y /agent-create (la sub-skill author) para hacer crecer skills, agentes y comandos adaptados a tu stack. La incorporación también ofrece cinco addons opcionales — devcontainer, Dailybot, dependency-upgrade, design-system y AI Diff Reviewer — que aceptas solo cuando encajan.', }, { title: 'Planifica y ejecuta', @@ -705,7 +705,7 @@ export const es: SiteTranslations = { { title: 'Acepta addons opcionales', description: - 'La incorporación ofrece cuatro addons opcionales — devcontainer, Dailybot, dependency-upgrade y design-system — que aceptas solo cuando encajan. Un repo es plenamente conforme con cero addons. Usa /skill-create y /agent-create (la sub-skill author) para hacer crecer skills, agentes y comandos más allá de la línea base.', + 'La incorporación ofrece cinco addons opcionales — devcontainer, Dailybot, dependency-upgrade, design-system y AI Diff Reviewer — que aceptas solo cuando encajan. Un repo es plenamente conforme con cero addons. Usa /skill-create y /agent-create (la sub-skill author) para hacer crecer skills, agentes y comandos más allá de la línea base.', }, { title: 'Planifica y ejecuta', diff --git a/src/lib/translations/fr.ts b/src/lib/translations/fr.ts index 82237fd..82070c5 100644 --- a/src/lib/translations/fr.ts +++ b/src/lib/translations/fr.ts @@ -642,7 +642,7 @@ export const fr: SiteTranslations = { { title: 'Faire évoluer le kit et accepter des addons', description: - 'Utilisez /skill-create et /agent-create (le sous-skill author) pour faire grandir des skills, agents et commandes adaptés à votre stack. L’onboarding propose aussi quatre addons facultatifs — devcontainer, Dailybot, dependency-upgrade et design-system — que vous acceptez seulement lorsqu’ils conviennent.', + 'Utilisez /skill-create et /agent-create (le sous-skill author) pour faire grandir des skills, agents et commandes adaptés à votre stack. L’onboarding propose aussi cinq addons facultatifs — devcontainer, Dailybot, dependency-upgrade et design-system — que vous acceptez seulement lorsqu’ils conviennent.', }, { title: 'Planifier et exécuter', @@ -715,7 +715,7 @@ export const fr: SiteTranslations = { { title: 'Accepter les addons optionnels', description: - 'L’onboarding propose quatre addons optionnels — devcontainer, Dailybot, dependency-upgrade et design-system — que vous acceptez seulement lorsqu’ils conviennent. Un dépôt est pleinement conforme avec zéro addon. Utilisez /skill-create et /agent-create (le sous-skill author) pour faire grandir des skills, agents et commandes au-delà de la ligne de base.', + 'L’onboarding propose cinq addons optionnels — devcontainer, Dailybot, dependency-upgrade, design-system et AI Diff Reviewer — que vous acceptez seulement lorsqu’ils conviennent. Un dépôt est pleinement conforme avec zéro addon. Utilisez /skill-create et /agent-create (le sous-skill author) pour faire grandir des skills, agents et commandes au-delà de la ligne de base.', }, { title: 'Planifier et exécuter', diff --git a/src/lib/translations/hi.ts b/src/lib/translations/hi.ts index d932979..6442693 100644 --- a/src/lib/translations/hi.ts +++ b/src/lib/translations/hi.ts @@ -634,7 +634,7 @@ export const hi: SiteTranslations = { { title: 'किट विकसित करें और ऐडऑन स्वीकार करें', description: - 'स्टैक-उपयुक्त स्किल्स, एजेंट्स और कमांड्स विकसित करने के लिए /skill-create और /agent-create (author सब-स्किल) का उपयोग करें। ऑनबोर्डिंग चार ऑप्ट-इन ऐडऑन भी प्रदान करती है — devcontainer, Dailybot, dependency-upgrade और design-system — जिन्हें आप तभी स्वीकार करते हैं जब वे उपयुक्त हों।', + 'स्टैक-उपयुक्त स्किल्स, एजेंट्स और कमांड्स विकसित करने के लिए /skill-create और /agent-create (author सब-स्किल) का उपयोग करें। ऑनबोर्डिंग पाँच ऑप्ट-इन ऐडऑन भी प्रदान करती है — devcontainer, Dailybot, dependency-upgrade और design-system — जिन्हें आप तभी स्वीकार करते हैं जब वे उपयुक्त हों।', }, { title: 'योजना बनाएँ और निष्पादित करें', @@ -768,7 +768,7 @@ export const hi: SiteTranslations = { { title: 'ऑप्ट-इन ऐडऑन स्वीकार करें', description: - 'ऑनबोर्डिंग चार ऑप्ट-इन ऐडऑन प्रदान करती है — devcontainer, Dailybot, dependency-upgrade और design-system — जिन्हें आप तभी स्वीकार करते हैं जब वे उपयुक्त हों। एक रिपॉज़िटरी शून्य ऐडऑन के साथ भी पूर्णतः अनुरूप होती है। बेसलाइन से परे स्टैक-उपयुक्त स्किल्स, एजेंट्स और कमांड्स विकसित करने के लिए /skill-create और /agent-create (author सब-स्किल) का उपयोग करें।', + 'ऑनबोर्डिंग पाँच ऑप्ट-इन ऐडऑन प्रदान करती है — devcontainer, Dailybot, dependency-upgrade, design-system और AI Diff Reviewer — जिन्हें आप तभी स्वीकार करते हैं जब वे उपयुक्त हों। एक रिपॉज़िटरी शून्य ऐडऑन के साथ भी पूर्णतः अनुरूप होती है। बेसलाइन से परे स्टैक-उपयुक्त स्किल्स, एजेंट्स और कमांड्स विकसित करने के लिए /skill-create और /agent-create (author सब-स्किल) का उपयोग करें।', }, { title: 'योजना बनाएँ और निष्पादित करें', diff --git a/src/lib/translations/id.ts b/src/lib/translations/id.ts index ce5bcc5..4117c50 100644 --- a/src/lib/translations/id.ts +++ b/src/lib/translations/id.ts @@ -638,7 +638,7 @@ export const id: SiteTranslations = { { title: 'Kembangkan kit dan terima addon', description: - 'Gunakan /skill-create dan /agent-create (sub-skill author) untuk menumbuhkan skill, agent, dan command yang sesuai stack. Onboarding juga menawarkan empat addon opt-in — devcontainer, Dailybot, dependency-upgrade, dan design-system — yang Anda terima hanya ketika cocok.', + 'Gunakan /skill-create dan /agent-create (sub-skill author) untuk menumbuhkan skill, agent, dan command yang sesuai stack. Onboarding juga menawarkan lima addon opt-in — devcontainer, Dailybot, dependency-upgrade, design-system, dan AI Diff Reviewer — yang Anda terima hanya ketika cocok.', }, { title: 'Rencanakan dan eksekusi', @@ -711,7 +711,7 @@ export const id: SiteTranslations = { { title: 'Terima addon opt-in', description: - 'Onboarding menawarkan empat addon opt-in — devcontainer, Dailybot, dependency-upgrade, dan design-system — yang Anda terima hanya ketika cocok. Sebuah repo sepenuhnya konforman dengan nol addon. Gunakan /skill-create dan /agent-create (sub-skill author) untuk menumbuhkan skill, agent, dan command yang sesuai stack di luar baseline.', + 'Onboarding menawarkan lima addon opt-in — devcontainer, Dailybot, dependency-upgrade, design-system, dan AI Diff Reviewer — yang Anda terima hanya ketika cocok. Sebuah repo sepenuhnya konforman dengan nol addon. Gunakan /skill-create dan /agent-create (sub-skill author) untuk menumbuhkan skill, agent, dan command yang sesuai stack di luar baseline.', }, { title: 'Rencanakan dan eksekusi', diff --git a/src/lib/translations/it.ts b/src/lib/translations/it.ts index 6180dae..a0f1739 100644 --- a/src/lib/translations/it.ts +++ b/src/lib/translations/it.ts @@ -638,7 +638,7 @@ export const it: SiteTranslations = { { title: 'Faccia evolvere il kit e accetti gli addon', description: - 'Usi /skill-create e /agent-create (la sub-skill author) per far crescere skill, agenti e comandi adatti allo stack. L’onboarding offre anche quattro addon opt-in — devcontainer, Dailybot, dependency-upgrade e design-system — che accetta solo quando sono pertinenti.', + 'Usi /skill-create e /agent-create (la sub-skill author) per far crescere skill, agenti e comandi adatti allo stack. L’onboarding offre anche cinque addon opt-in — devcontainer, Dailybot, dependency-upgrade e design-system — che accetta solo quando sono pertinenti.', }, { title: 'Pianifichi ed esegua', @@ -711,7 +711,7 @@ export const it: SiteTranslations = { { title: 'Accetti gli addon opzionali', description: - 'L’onboarding offre quattro addon opt-in — devcontainer, Dailybot, dependency-upgrade e design-system — che accetta solo quando sono pertinenti. Un repo è pienamente conforme anche con zero addon. Usi /skill-create e /agent-create (la sub-skill author) per far crescere skill, agenti e comandi oltre la configurazione di base.', + 'L’onboarding offre cinque addon opt-in — devcontainer, Dailybot, dependency-upgrade, design-system e AI Diff Reviewer — che accetta solo quando sono pertinenti. Un repo è pienamente conforme anche con zero addon. Usi /skill-create e /agent-create (la sub-skill author) per far crescere skill, agenti e comandi oltre la configurazione di base.', }, { title: 'Pianifichi ed esegua', diff --git a/src/lib/translations/ja.ts b/src/lib/translations/ja.ts index 4b8471a..167f8b8 100644 --- a/src/lib/translations/ja.ts +++ b/src/lib/translations/ja.ts @@ -640,7 +640,7 @@ export const ja: SiteTranslations = { { title: 'キットを進化させ、アドオンを受け入れる', description: - '/skill-create と /agent-create(author サブスキル)を使って、スタックに合ったスキル、エージェント、コマンドを育てます。オンボーディングは四つのオプトイン式アドオン(devcontainer、Dailybot、dependency-upgrade、design-system)も提案します。適合する場合にのみ受け入れてください。', + '/skill-create と /agent-create(author サブスキル)を使って、スタックに合ったスキル、エージェント、コマンドを育てます。オンボーディングは五つのオプトイン式アドオン(devcontainer、Dailybot、dependency-upgrade、design-system、AI Diff Reviewer)も提案します。適合する場合にのみ受け入れてください。', }, { title: '計画して実行する', @@ -713,7 +713,7 @@ export const ja: SiteTranslations = { { title: 'オプトインのアドオンを受け入れる', description: - 'オンボーディングは四つのオプトイン式アドオン(devcontainer、Dailybot、dependency-upgrade、design-system)を提案します。適合する場合にのみ受け入れてください。アドオンがゼロでも、リポジトリは完全に適合します。/skill-create と /agent-create(author サブスキル)を使って、ベースラインを超えるスキル、エージェント、コマンドを育てることができます。', + 'オンボーディングは五つのオプトイン式アドオン(devcontainer、Dailybot、dependency-upgrade、design-system、AI Diff Reviewer)を提案します。適合する場合にのみ受け入れてください。アドオンがゼロでも、リポジトリは完全に適合します。/skill-create と /agent-create(author サブスキル)を使って、ベースラインを超えるスキル、エージェント、コマンドを育てることができます。', }, { title: '計画して実行する', diff --git a/src/lib/translations/ko.ts b/src/lib/translations/ko.ts index 6e61a88..3fe57b6 100644 --- a/src/lib/translations/ko.ts +++ b/src/lib/translations/ko.ts @@ -635,7 +635,7 @@ export const ko: SiteTranslations = { { title: '키트 발전과 애드온 채택', description: - '/skill-create와 /agent-create(author 하위 스킬)로 스택에 맞는 스킬, 에이전트, 명령을 키우세요. 온보딩은 또한 네 가지 선택형 애드온 — devcontainer, Dailybot, dependency-upgrade, design-system — 을 제안하며, 맞을 때만 채택하면 됩니다.', + '/skill-create와 /agent-create(author 하위 스킬)로 스택에 맞는 스킬, 에이전트, 명령을 키우세요. 온보딩은 또한 다섯 가지 선택형 애드온 — devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer — 을 제안하며, 맞을 때만 채택하면 됩니다.', }, { title: '계획하고 실행', @@ -708,7 +708,7 @@ export const ko: SiteTranslations = { { title: '선택형 애드온 채택', description: - '온보딩은 네 가지 선택형 애드온 — devcontainer, Dailybot, dependency-upgrade, design-system — 을 제안하며, 맞을 때만 채택하면 됩니다. 애드온이 하나도 없어도 리포지토리는 완전히 적합합니다. /skill-create와 /agent-create(author 하위 스킬)로 기본 구성을 넘어 스택에 맞는 스킬, 에이전트, 명령을 키우세요.', + '온보딩은 다섯 가지 선택형 애드온 — devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer — 을 제안하며, 맞을 때만 채택하면 됩니다. 애드온이 하나도 없어도 리포지토리는 완전히 적합합니다. /skill-create와 /agent-create(author 하위 스킬)로 기본 구성을 넘어 스택에 맞는 스킬, 에이전트, 명령을 키우세요.', }, { title: '계획하고 실행', diff --git a/src/lib/translations/pl.ts b/src/lib/translations/pl.ts index fecc6b6..1a68e02 100644 --- a/src/lib/translations/pl.ts +++ b/src/lib/translations/pl.ts @@ -640,7 +640,7 @@ export const pl: SiteTranslations = { { title: 'Rozwijaj zestaw i przyjmuj dodatki', description: - 'Użyj /skill-create i /agent-create (sub-skill author), by rozwijać skille, agentów i polecenia dopasowane do stosu technologicznego. Onboarding oferuje także cztery dobrowolne dodatki — devcontainer, Dailybot, dependency-upgrade i design-system — które przyjmujesz tylko, gdy pasują.', + 'Użyj /skill-create i /agent-create (sub-skill author), by rozwijać skille, agentów i polecenia dopasowane do stosu technologicznego. Onboarding oferuje także pięć dobrowolnych dodatków — devcontainer, Dailybot, dependency-upgrade, design-system i AI Diff Reviewer — które przyjmujesz tylko, gdy pasują.', }, { title: 'Planuj i realizuj', @@ -774,7 +774,7 @@ export const pl: SiteTranslations = { { title: 'Przyjmij opcjonalne dodatki', description: - 'Onboarding oferuje cztery opcjonalne dodatki — devcontainer, Dailybot, dependency-upgrade i design-system — które przyjmujesz tylko, gdy pasują. Repo jest w pełni zgodne z zerową liczbą dodatków. Użyj /skill-create i /agent-create (sub-skill author), by rozwijać skille, agentów i polecenia wykraczające poza bazowy zestaw.', + 'Onboarding oferuje pięć opcjonalnych dodatków — devcontainer, Dailybot, dependency-upgrade, design-system i AI Diff Reviewer — które przyjmujesz tylko, gdy pasują. Repo jest w pełni zgodne z zerową liczbą dodatków. Użyj /skill-create i /agent-create (sub-skill author), by rozwijać skille, agentów i polecenia wykraczające poza bazowy zestaw.', }, { title: 'Planuj i realizuj', diff --git a/src/lib/translations/pt.ts b/src/lib/translations/pt.ts index 900ae6c..3a94ae0 100644 --- a/src/lib/translations/pt.ts +++ b/src/lib/translations/pt.ts @@ -642,7 +642,7 @@ export const pt: SiteTranslations = { { title: 'Evolua o kit e aceite addons', description: - 'Use /skill-create e /agent-create (a sub-skill author) para desenvolver skills, agents e commands apropriados à sua stack. O onboarding também oferece quatro addons opcionais — devcontainer, Dailybot, dependency-upgrade e design-system — que você aceita apenas quando fizerem sentido.', + 'Use /skill-create e /agent-create (a sub-skill author) para desenvolver skills, agents e commands apropriados à sua stack. O onboarding também oferece cinco addons opcionais — devcontainer, Dailybot, dependency-upgrade, design-system e AI Diff Reviewer — que você aceita apenas quando fizerem sentido.', }, { title: 'Planeje e execute', @@ -715,7 +715,7 @@ export const pt: SiteTranslations = { { title: 'Aceite addons opcionais', description: - 'O onboarding oferece quatro addons opcionais — devcontainer, Dailybot, dependency-upgrade e design-system — que você aceita apenas quando fizerem sentido. Um repositório é totalmente conforme com zero addons. Use /skill-create e /agent-create (a sub-skill author) para desenvolver skills, agents e commands além do conjunto base.', + 'O onboarding oferece cinco addons opcionais — devcontainer, Dailybot, dependency-upgrade, design-system e AI Diff Reviewer — que você aceita apenas quando fizerem sentido. Um repositório é totalmente conforme com zero addons. Use /skill-create e /agent-create (a sub-skill author) para desenvolver skills, agents e commands além do conjunto base.', }, { title: 'Planeje e execute', diff --git a/src/lib/translations/ru.ts b/src/lib/translations/ru.ts index c28cc7e..5b108fc 100644 --- a/src/lib/translations/ru.ts +++ b/src/lib/translations/ru.ts @@ -641,7 +641,7 @@ export const ru: SiteTranslations = { { title: 'Развивайте набор и принимайте дополнения', description: - 'Используйте /skill-create и /agent-create (под-навык author), чтобы растить навыки, агентов и команды, подходящие вашему стеку. Онбординг также предлагает четыре опциональных дополнения — devcontainer, Dailybot, dependency-upgrade и design-system, — которые вы принимаете, только когда они уместны.', + 'Используйте /skill-create и /agent-create (под-навык author), чтобы растить навыки, агентов и команды, подходящие вашему стеку. Онбординг также предлагает пять опциональных дополнений — devcontainer, Dailybot, dependency-upgrade, design-system и AI Diff Reviewer, — которые вы принимаете, только когда они уместны.', }, { title: 'Планируйте и выполняйте', @@ -714,7 +714,7 @@ export const ru: SiteTranslations = { { title: 'Примите опциональные дополнения', description: - 'Онбординг предлагает четыре опциональных дополнения — devcontainer, Dailybot, dependency-upgrade и design-system, — которые вы принимаете, только когда они уместны. Репозиторий полностью соответствует стандарту и с нулём дополнений. Используйте /skill-create и /agent-create (под-навык author), чтобы растить навыки, агентов и команды за пределами базовой конфигурации.', + 'Онбординг предлагает пять опциональных дополнений — devcontainer, Dailybot, dependency-upgrade, design-system и AI Diff Reviewer, — которые вы принимаете, только когда они уместны. Репозиторий полностью соответствует стандарту и с нулём дополнений. Используйте /skill-create и /agent-create (под-навык author), чтобы растить навыки, агентов и команды за пределами базовой конфигурации.', }, { title: 'Планируйте и выполняйте', diff --git a/src/lib/translations/th.ts b/src/lib/translations/th.ts index 5b21325..60290ff 100644 --- a/src/lib/translations/th.ts +++ b/src/lib/translations/th.ts @@ -631,7 +631,7 @@ export const th: SiteTranslations = { { title: 'พัฒนาชุดเครื่องมือและรับ addon', description: - 'ใช้ /skill-create และ /agent-create (สกิลย่อย author) เพื่อสร้างสกิล agent และคำสั่งที่เหมาะกับสแตก การเริ่มต้นยังเสนอ addon แบบสมัครใจสี่ตัว ได้แก่ devcontainer, Dailybot, dependency-upgrade และ design-system ซึ่งคุณรับมาเฉพาะเมื่อเหมาะสม', + 'ใช้ /skill-create และ /agent-create (สกิลย่อย author) เพื่อสร้างสกิล agent และคำสั่งที่เหมาะกับสแตก การเริ่มต้นยังเสนอ addon แบบสมัครใจห้าตัว ได้แก่ devcontainer, Dailybot, dependency-upgrade และ design-system ซึ่งคุณรับมาเฉพาะเมื่อเหมาะสม', }, { title: 'วางแผนและลงมือทำ', @@ -765,7 +765,7 @@ export const th: SiteTranslations = { { title: 'รับ addon แบบสมัครใจ', description: - 'การ onboarding เสนอ addon แบบสมัครใจสี่ตัว ได้แก่ devcontainer, Dailybot, dependency-upgrade และ design-system ซึ่งคุณรับมาเฉพาะเมื่อเหมาะสม repo สอดคล้องอย่างสมบูรณ์โดยมี addon ศูนย์ตัว ใช้ /skill-create และ /agent-create (สกิลย่อย author) เพื่อสร้างสกิล agent และคำสั่งที่เหมาะกับสแตกเกินกว่าชุดพื้นฐาน', + 'การ onboarding เสนอ addon แบบสมัครใจห้าตัว ได้แก่ devcontainer, Dailybot, dependency-upgrade, design-system และ AI Diff Reviewer ซึ่งคุณรับมาเฉพาะเมื่อเหมาะสม repo สอดคล้องอย่างสมบูรณ์โดยมี addon ศูนย์ตัว ใช้ /skill-create และ /agent-create (สกิลย่อย author) เพื่อสร้างสกิล agent และคำสั่งที่เหมาะกับสแตกเกินกว่าชุดพื้นฐาน', }, { title: 'วางแผนและดำเนินการ', diff --git a/src/lib/translations/tr.ts b/src/lib/translations/tr.ts index 35cc8c7..4db682a 100644 --- a/src/lib/translations/tr.ts +++ b/src/lib/translations/tr.ts @@ -639,7 +639,7 @@ export const tr: SiteTranslations = { { title: 'Kiti geliştirin ve eklentileri kabul edin', description: - 'Yığına uygun skill’ler, ajanlar ve komutlar geliştirmek için /skill-create ve /agent-create (author alt skill’i) kullanın. Kuruluma alma ayrıca dört tercihe dayalı eklenti sunar — devcontainer, Dailybot, dependency-upgrade ve design-system — yalnızca uygun olduklarında kabul edersiniz.', + 'Yığına uygun skill’ler, ajanlar ve komutlar geliştirmek için /skill-create ve /agent-create (author alt skill’i) kullanın. Kuruluma alma ayrıca beş tercihe dayalı eklenti sunar — devcontainer, Dailybot, dependency-upgrade, design-system ve AI Diff Reviewer — yalnızca uygun olduklarında kabul edersiniz.', }, { title: 'Planlayın ve yürütün', @@ -712,7 +712,7 @@ export const tr: SiteTranslations = { { title: 'Tercihe dayalı eklentileri kabul edin', description: - 'Kuruluma alma dört tercihe dayalı eklenti sunar — devcontainer, Dailybot, dependency-upgrade ve design-system — yalnızca uygun olduklarında kabul edersiniz. Bir depo, sıfır eklentiyle tam uyumludur. Temel yapının ötesinde yığına uygun skill’ler, ajanlar ve komutlar geliştirmek için /skill-create ve /agent-create (author alt skill’i) kullanın.', + 'Kuruluma alma beş tercihe dayalı eklenti sunar — devcontainer, Dailybot, dependency-upgrade, design-system ve AI Diff Reviewer — yalnızca uygun olduklarında kabul edersiniz. Bir depo, sıfır eklentiyle tam uyumludur. Temel yapının ötesinde yığına uygun skill’ler, ajanlar ve komutlar geliştirmek için /skill-create ve /agent-create (author alt skill’i) kullanın.', }, { title: 'Planlayın ve yürütün', diff --git a/src/lib/translations/uk.ts b/src/lib/translations/uk.ts index bb642ea..98fe2ad 100644 --- a/src/lib/translations/uk.ts +++ b/src/lib/translations/uk.ts @@ -642,7 +642,7 @@ export const uk: SiteTranslations = { { title: 'Розвивайте набір та приймайте addon', description: - 'Використовуйте /skill-create та /agent-create (суб-скіл author), щоб розвивати скіли, агенти та команди, доречні для вашого стеку. Онбординг також пропонує чотири опціональні addon — devcontainer, Dailybot, dependency-upgrade та design-system — які ви приймаєте лише тоді, коли вони доречні.', + 'Використовуйте /skill-create та /agent-create (суб-скіл author), щоб розвивати скіли, агенти та команди, доречні для вашого стеку. Онбординг також пропонує п'ять опціональних addon — devcontainer, Dailybot, dependency-upgrade та design-system — які ви приймаєте лише тоді, коли вони доречні.', }, { title: 'Плануйте та виконуйте', @@ -776,7 +776,7 @@ export const uk: SiteTranslations = { { title: 'Прийміть опціональні addon', description: - 'Онбординг пропонує чотири опціональні addon — devcontainer, Dailybot, dependency-upgrade та design-system — які ви приймаєте лише тоді, коли вони доречні. Репозиторій повністю відповідає вимогам і з нульовою кількістю addon. Використовуйте /skill-create та /agent-create (суб-скіл author), щоб розвивати скіли, агенти та команди понад базовий набір.', + 'Онбординг пропонує п'ять опціональних addon — devcontainer, Dailybot, dependency-upgrade, design-system та AI Diff Reviewer — які ви приймаєте лише тоді, коли вони доречні. Репозиторій повністю відповідає вимогам і з нульовою кількістю addon. Використовуйте /skill-create та /agent-create (суб-скіл author), щоб розвивати скіли, агенти та команди понад базовий набір.', }, { title: 'Плануйте та виконуйте', diff --git a/src/lib/translations/vi.ts b/src/lib/translations/vi.ts index cb702d9..36d2af6 100644 --- a/src/lib/translations/vi.ts +++ b/src/lib/translations/vi.ts @@ -635,7 +635,7 @@ export const vi: SiteTranslations = { { title: 'Phát triển bộ kit và chấp nhận các addon', description: - 'Dùng /skill-create và /agent-create (sub-skill author) để phát triển các skill, agent và command phù hợp với stack. Khởi tạo cũng đề xuất bốn addon tự nguyện — devcontainer, Dailybot, dependency-upgrade và design-system — mà bạn chỉ chấp nhận khi chúng phù hợp.', + 'Dùng /skill-create và /agent-create (sub-skill author) để phát triển các skill, agent và command phù hợp với stack. Khởi tạo cũng đề xuất năm addon tự nguyện — devcontainer, Dailybot, dependency-upgrade, design-system và AI Diff Reviewer — mà bạn chỉ chấp nhận khi chúng phù hợp.', }, { title: 'Lập kế hoạch và thực thi', @@ -708,7 +708,7 @@ export const vi: SiteTranslations = { { title: 'Chấp nhận các addon tự nguyện', description: - 'Khởi tạo đề xuất bốn addon tự nguyện — devcontainer, Dailybot, dependency-upgrade và design-system — mà bạn chỉ chấp nhận khi chúng phù hợp. Một repo hoàn toàn tuân thủ với không cần addon nào. Dùng /skill-create và /agent-create (sub-skill author) để phát triển các skill, agent và command phù hợp với stack vượt ra ngoài cơ sở.', + 'Khởi tạo đề xuất năm addon tự nguyện — devcontainer, Dailybot, dependency-upgrade, design-system và AI Diff Reviewer — mà bạn chỉ chấp nhận khi chúng phù hợp. Một repo hoàn toàn tuân thủ với không cần addon nào. Dùng /skill-create và /agent-create (sub-skill author) để phát triển các skill, agent và command phù hợp với stack vượt ra ngoài cơ sở.', }, { title: 'Lập kế hoạch và thực thi', diff --git a/src/lib/translations/zh.ts b/src/lib/translations/zh.ts index 5f463ed..5b831d7 100644 --- a/src/lib/translations/zh.ts +++ b/src/lib/translations/zh.ts @@ -629,7 +629,7 @@ export const zh: SiteTranslations = { { title: '演化套件并采纳附加组件', description: - '使用 /skill-create 与 /agent-create(author 子技能)来培育与技术栈相适配的技能、代理与命令。接入流程还会提供四个可选附加组件——devcontainer、Dailybot、dependency-upgrade 与 design-system——你只在它们契合时才采纳。', + '使用 /skill-create 与 /agent-create(author 子技能)来培育与技术栈相适配的技能、代理与命令。接入流程还会提供五个可选附加组件——devcontainer、Dailybot、dependency-upgrade、design-system 与 AI Diff Reviewer——你只在它们契合时才采纳。', }, { title: '规划并执行', @@ -702,7 +702,7 @@ export const zh: SiteTranslations = { { title: '接受可选附加组件', description: - '接入流程提供四个可选附加组件——devcontainer、Dailybot、dependency-upgrade 与 design-system——你只在它们契合时才采纳。一个仓库即便不带任何附加组件,也完全符合规范。使用 /skill-create 与 /agent-create(author 子技能)来培育超越基线的技能、代理与命令。', + '接入流程提供五个可选附加组件——devcontainer、Dailybot、dependency-upgrade、design-system 与 AI Diff Reviewer——你只在它们契合时才采纳。一个仓库即便不带任何附加组件,也完全符合规范。使用 /skill-create 与 /agent-create(author 子技能)来培育超越基线的技能、代理与命令。', }, { title: '规划并执行', From 604bdda4a0c589f3a9d78d22dfdf824e76b5d10a Mon Sep 17 00:00:00 2001 From: Sergio Alexander Florez Galeano Date: Thu, 16 Jul 2026 15:08:12 +0000 Subject: [PATCH 2/7] feat(aeo): add Markdown access hint after Canonical in agent .md Expose buildMarkdownAccessLine in the shared serializer so every page and reader mirror documents Accept: text/markdown content negotiation, with localized prose for all 17 languages and unit tests locking the contract. Co-authored-by: Cursor --- docs/aeo/MARKDOWN_FOR_AGENTS.md | 4 + src/lib/README.md | 1 + src/lib/markdown-for-agents.ts | 35 +++++++ tests/unit/lib/markdown-for-agents.test.ts | 102 ++++++++++++++++++++- 4 files changed, 140 insertions(+), 2 deletions(-) diff --git a/docs/aeo/MARKDOWN_FOR_AGENTS.md b/docs/aeo/MARKDOWN_FOR_AGENTS.md index 9347e47..9762c9c 100644 --- a/docs/aeo/MARKDOWN_FOR_AGENTS.md +++ b/docs/aeo/MARKDOWN_FOR_AGENTS.md @@ -41,6 +41,7 @@ Source: `src/content/pages/{en,es}/` content collection. Language: en Canonical: https://deepworkplan.com/about +Markdown: send header `Accept: text/markdown` on any URL to receive Markdown instead of HTML. --- @@ -51,6 +52,7 @@ Canonical: https://deepworkplan.com/about - Blockquote description — visually distinct - Simple key-value metadata — easy to parse - Canonical URL — always points to the HTML version +- **Markdown access line** — tells agents to send `Accept: text/markdown` on any URL for Markdown instead of HTML (content negotiation; do not rely on appending `.md`). Localized prose per language; the media type stays literal. Owned by `buildMarkdownAccessLine(lang)` in `src/lib/markdown-for-agents.ts` - Separator before body — clear content boundary - Site navigation footer — global nav links appended to every output (see below) @@ -70,7 +72,9 @@ Canonical: https://deepworkplan.com/about ### Serialization Functions +- `buildMarkdownAccessLine(lang)` — localized `Markdown:` header hint (content negotiation) - `serializePageToAgentMarkdown(page, { slug, lang })` — site pages +- `serializeReaderEntryToAgentMarkdown(entry, { basePath, slug, lang })` — methodology / spec / kit / examples readers ### Site Navigation Partial diff --git a/src/lib/README.md b/src/lib/README.md index a7bc50d..017ab2d 100644 --- a/src/lib/README.md +++ b/src/lib/README.md @@ -137,6 +137,7 @@ Serializes pages and reader entries into agent-friendly Markdown, powering the | Function | Description | |----------|-------------| +| `buildMarkdownAccessLine(lang)` | Localized `Markdown:` header hint (`Accept: text/markdown` content negotiation) | | `serializePageToAgentMarkdown(...)` | Serialize a static page to agent Markdown | | `serializeReaderEntryToAgentMarkdown(...)` | Serialize a methodology/spec/kit entry to agent Markdown | diff --git a/src/lib/markdown-for-agents.ts b/src/lib/markdown-for-agents.ts index 6d44052..18b6103 100644 --- a/src/lib/markdown-for-agents.ts +++ b/src/lib/markdown-for-agents.ts @@ -5,6 +5,39 @@ import { getTranslations } from '@/lib/translations'; const SITE_URL = 'https://deepworkplan.com'; +/** + * Localized prose for the Markdown access hint. The media type + * `Accept: text/markdown` stays literal in every language so agents can parse it. + */ +const MARKDOWN_ACCESS_LINES: Record = { + en: 'Markdown: send header `Accept: text/markdown` on any URL to receive Markdown instead of HTML.', + es: 'Markdown: envía el header `Accept: text/markdown` en cualquier URL para recibir Markdown en lugar de HTML.', + pt: 'Markdown: envie o header `Accept: text/markdown` em qualquer URL para receber Markdown em vez de HTML.', + de: 'Markdown: sende den Header `Accept: text/markdown` an jede URL, um Markdown statt HTML zu erhalten.', + fr: "Markdown: envoyez l'en-tête `Accept: text/markdown` sur n'importe quelle URL pour recevoir du Markdown au lieu du HTML.", + it: "Markdown: invia l'header `Accept: text/markdown` su qualsiasi URL per ricevere Markdown invece di HTML.", + ja: 'Markdown: 任意の URL にヘッダー `Accept: text/markdown` を送ると、HTML の代わりに Markdown を受け取れます。', + zh: 'Markdown: 在任意 URL 上发送请求头 `Accept: text/markdown` 即可获取 Markdown 而非 HTML。', + ko: 'Markdown: 모든 URL에 `Accept: text/markdown` 헤더를 보내면 HTML 대신 Markdown을 받을 수 있습니다.', + ru: 'Markdown: отправьте заголовок `Accept: text/markdown` на любой URL, чтобы получить Markdown вместо HTML.', + tr: "Markdown: herhangi bir URL'ye `Accept: text/markdown` başlığını göndererek HTML yerine Markdown alın.", + id: 'Markdown: kirim header `Accept: text/markdown` pada URL mana pun untuk menerima Markdown, bukan HTML.', + vi: 'Markdown: gửi header `Accept: text/markdown` trên mọi URL để nhận Markdown thay vì HTML.', + hi: 'Markdown: किसी भी URL पर `Accept: text/markdown` हेडर भेजें ताकि HTML के बजाय Markdown मिले।', + pl: 'Markdown: wyślij nagłówek `Accept: text/markdown` na dowolny URL, aby otrzymać Markdown zamiast HTML.', + uk: 'Markdown: надішліть заголовок `Accept: text/markdown` на будь-який URL, щоб отримати Markdown замість HTML.', + th: 'Markdown: ส่งเฮดเดอร์ `Accept: text/markdown` บน URL ใดก็ได้เพื่อรับ Markdown แทน HTML.', +}; + +/** + * One-line hint in every .md mirror header so agents know how to fetch + * Markdown for any other URL on the site via content negotiation. + * Keep the key prefix exactly `Markdown:` (same pattern as `Canonical:`). + */ +export function buildMarkdownAccessLine(lang: string): string { + return MARKDOWN_ACCESS_LINES[lang] ?? MARKDOWN_ACCESS_LINES.en; +} + /** * Generate a site-wide navigation section for agent markdown. * Appended to all serialized outputs so AI agents can discover every page from @@ -101,6 +134,7 @@ export function serializePageToAgentMarkdown( lines.push(''); lines.push(`Language: ${lang}`); lines.push(`Canonical: ${canonicalUrl}`); + lines.push(buildMarkdownAccessLine(lang)); if ('lastUpdated' in page.data && page.data.lastUpdated instanceof Date) { lines.push(`Last Updated: ${formatDate(page.data.lastUpdated)}`); @@ -158,6 +192,7 @@ export function serializeReaderEntryToAgentMarkdown( lines.push(''); lines.push(`Language: ${lang}`); lines.push(`Canonical: ${canonicalUrl}`); + lines.push(buildMarkdownAccessLine(lang)); lines.push(''); lines.push('---'); lines.push(''); diff --git a/tests/unit/lib/markdown-for-agents.test.ts b/tests/unit/lib/markdown-for-agents.test.ts index 3aabbfa..3f5e045 100644 --- a/tests/unit/lib/markdown-for-agents.test.ts +++ b/tests/unit/lib/markdown-for-agents.test.ts @@ -1,6 +1,10 @@ import { describe, expect, it } from 'vitest'; -import { serializePageToAgentMarkdown } from '@/lib/markdown-for-agents'; +import { + buildMarkdownAccessLine, + serializePageToAgentMarkdown, + serializeReaderEntryToAgentMarkdown, +} from '@/lib/markdown-for-agents'; // ─── Mock Data ───────────────────────────────────────── @@ -23,6 +27,40 @@ const mockPageNoLastUpdated = { body: '## Ponte en Contacto\n\nSiempre abierto a conversaciones.', }; +const EN_ACCESS_LINE = + 'Markdown: send header `Accept: text/markdown` on any URL to receive Markdown instead of HTML.'; + +const ES_ACCESS_LINE = + 'Markdown: envía el header `Accept: text/markdown` en cualquier URL para recibir Markdown en lugar de HTML.'; + +const PT_ACCESS_LINE = + 'Markdown: envie o header `Accept: text/markdown` em qualquer URL para receber Markdown em vez de HTML.'; + +// ─── buildMarkdownAccessLine ─────────────────────────── + +describe('buildMarkdownAccessLine', () => { + it('returns the canonical English line', () => { + expect(buildMarkdownAccessLine('en')).toBe(EN_ACCESS_LINE); + }); + + it('localizes Spanish and Portuguese while keeping Accept: text/markdown literal', () => { + expect(buildMarkdownAccessLine('es')).toBe(ES_ACCESS_LINE); + expect(buildMarkdownAccessLine('pt')).toBe(PT_ACCESS_LINE); + expect(buildMarkdownAccessLine('es')).toContain('Accept: text/markdown'); + expect(buildMarkdownAccessLine('pt')).toContain('Accept: text/markdown'); + }); + + it('falls back to English for unknown languages', () => { + expect(buildMarkdownAccessLine('xx')).toBe(EN_ACCESS_LINE); + }); + + it('does not mention appending .md', () => { + expect(buildMarkdownAccessLine('en')).not.toContain('append `.md`'); + expect(buildMarkdownAccessLine('es')).not.toContain('append `.md`'); + expect(buildMarkdownAccessLine('pt')).not.toContain('`.md`'); + }); +}); + // ─── serializePageToAgentMarkdown ────────────────────── describe('serializePageToAgentMarkdown', () => { @@ -36,10 +74,28 @@ describe('serializePageToAgentMarkdown', () => { expect(result).toContain('> Technology Enthusiast and Lifelong Learner.'); expect(result).toContain('Language: en'); expect(result).toContain('Canonical: https://deepworkplan.com/about'); + expect(result).toContain(EN_ACCESS_LINE); expect(result).toContain('Last Updated: 2026-03-09'); expect(result).toContain('## About'); }); + it('places the Markdown access line immediately after Canonical', () => { + const result = serializePageToAgentMarkdown(mockPage as any, { + slug: 'about', + lang: 'en', + }); + const canonicalIdx = result.indexOf( + 'Canonical: https://deepworkplan.com/about' + ); + const markdownIdx = result.indexOf(EN_ACCESS_LINE); + const lastUpdatedIdx = result.indexOf('Last Updated:'); + + expect(canonicalIdx).toBeGreaterThan(-1); + expect(markdownIdx).toBeGreaterThan(canonicalIdx); + expect(lastUpdatedIdx).toBeGreaterThan(markdownIdx); + expect(result).not.toContain('append `.md`'); + }); + it('should handle index slug with correct canonical URL', () => { const indexPage = { ...mockPage, @@ -54,9 +110,10 @@ describe('serializePageToAgentMarkdown', () => { expect(result).toContain('Canonical: https://deepworkplan.com'); // Should not be https://deepworkplan.com/index expect(result).not.toContain('/index'); + expect(result).toContain(EN_ACCESS_LINE); }); - it('should handle ES language', () => { + it('should handle ES language with localized access line', () => { const result = serializePageToAgentMarkdown(mockPageNoLastUpdated as any, { slug: 'contact', lang: 'es', @@ -64,6 +121,7 @@ describe('serializePageToAgentMarkdown', () => { expect(result).toContain('Language: es'); expect(result).toContain('Canonical: https://deepworkplan.com/es/contact'); + expect(result).toContain(ES_ACCESS_LINE); expect(result).not.toContain('Last Updated:'); }); @@ -76,3 +134,43 @@ describe('serializePageToAgentMarkdown', () => { expect(result).not.toContain('Last Updated:'); }); }); + +// ─── serializeReaderEntryToAgentMarkdown ─────────────── + +describe('serializeReaderEntryToAgentMarkdown', () => { + it('includes the Markdown access line after Canonical', () => { + const result = serializeReaderEntryToAgentMarkdown( + { + data: { + title: 'Add-ons', + description: 'Optional DWP extensions.', + }, + body: '## Contract\n\nAddons are opt-in.', + }, + { basePath: 'spec', slug: 'addons', lang: 'en' } + ); + + expect(result).toContain('Canonical: https://deepworkplan.com/spec/addons'); + expect(result).toContain(EN_ACCESS_LINE); + expect(result.indexOf(EN_ACCESS_LINE)).toBeGreaterThan( + result.indexOf('Canonical: https://deepworkplan.com/spec/addons') + ); + expect(result).not.toContain('append `.md`'); + }); + + it('localizes the access line for Portuguese reader entries', () => { + const result = serializeReaderEntryToAgentMarkdown( + { + data: { + title: 'Add-ons', + description: 'Extensões opcionais do DWP.', + }, + body: '## Contrato', + }, + { basePath: 'spec', slug: 'addons', lang: 'pt' } + ); + + expect(result).toContain(PT_ACCESS_LINE); + expect(result).toContain('Accept: text/markdown'); + }); +}); From beea1477383082f2a7074a0860cafb14251dfae7 Mon Sep 17 00:00:00 2001 From: Sergio Alexander Florez Galeano Date: Thu, 16 Jul 2026 15:09:41 +0000 Subject: [PATCH 3/7] fix(i18n): escape Ukrainian apostrophe in five-addons strings MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit п'ять inside single-quoted TS strings broke the uk locale parse and tests. Co-authored-by: Cursor --- src/lib/translations/uk.ts | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/lib/translations/uk.ts b/src/lib/translations/uk.ts index 98fe2ad..3636a94 100644 --- a/src/lib/translations/uk.ts +++ b/src/lib/translations/uk.ts @@ -642,7 +642,7 @@ export const uk: SiteTranslations = { { title: 'Розвивайте набір та приймайте addon', description: - 'Використовуйте /skill-create та /agent-create (суб-скіл author), щоб розвивати скіли, агенти та команди, доречні для вашого стеку. Онбординг також пропонує п'ять опціональних addon — devcontainer, Dailybot, dependency-upgrade та design-system — які ви приймаєте лише тоді, коли вони доречні.', + "Використовуйте /skill-create та /agent-create (суб-скіл author), щоб розвивати скіли, агенти та команди, доречні для вашого стеку. Онбординг також пропонує п'ять опціональних addon — devcontainer, Dailybot, dependency-upgrade, design-system та AI Diff Reviewer — які ви приймаєте лише тоді, коли вони доречні.", }, { title: 'Плануйте та виконуйте', @@ -776,7 +776,7 @@ export const uk: SiteTranslations = { { title: 'Прийміть опціональні addon', description: - 'Онбординг пропонує п'ять опціональних addon — devcontainer, Dailybot, dependency-upgrade, design-system та AI Diff Reviewer — які ви приймаєте лише тоді, коли вони доречні. Репозиторій повністю відповідає вимогам і з нульовою кількістю addon. Використовуйте /skill-create та /agent-create (суб-скіл author), щоб розвивати скіли, агенти та команди понад базовий набір.', + "Онбординг пропонує п'ять опціональних addon — devcontainer, Dailybot, dependency-upgrade, design-system та AI Diff Reviewer — які ви приймаєте лише тоді, коли вони доречні. Репозиторій повністю відповідає вимогам і з нульовою кількістю addon. Використовуйте /skill-create та /agent-create (суб-скіл author), щоб розвивати скіли, агенти та команди понад базовий набір.", }, { title: 'Плануйте та виконуйте', From 8d007612930541507669809549921aead1a534df Mon Sep 17 00:00:00 2001 From: Sergio Alexander Florez Galeano Date: Thu, 16 Jul 2026 15:11:37 +0000 Subject: [PATCH 4/7] perf(docker): cache git dirty check in bash prompt Enable core.untrackedcache and TTL-cache git status in set_bash_prompt so Enter no longer waits ~3s on the macOS bind mount for every redraw. Co-authored-by: Cursor --- docker/custom_commands.sh | 30 +++++++++++++++++++++++++++--- 1 file changed, 27 insertions(+), 3 deletions(-) diff --git a/docker/custom_commands.sh b/docker/custom_commands.sh index a5c16aa..c5d986b 100644 --- a/docker/custom_commands.sh +++ b/docker/custom_commands.sh @@ -257,6 +257,19 @@ function git_status_indicator() { fi } +# Speed up `git status` on macOS bind mounts (caches the untracked-files walk). +# Repo-local; do not enable core.fsmonitor — unreliable through this mount. +if git rev-parse --git-dir >/dev/null 2>&1; then + git config core.untrackedcache true +fi + +# Cached git dirty state for the prompt. `git status` costs ~0.4s on the +# macOS bind mount even with core.untrackedCache, so refresh at most every +# 5 seconds instead of on every prompt redraw. +__GIT_DIRTY_CACHE="" +__GIT_DIRTY_REPO="" +__GIT_DIRTY_TS=-10 + # Custom PS1 prompt with colors and git info function set_bash_prompt() { local exit_code=$? @@ -270,7 +283,9 @@ function set_bash_prompt() { # Get git branch and status local git_info="" - if git rev-parse --git-dir > /dev/null 2>&1; then + local repo_root + repo_root=$(git rev-parse --show-toplevel 2>/dev/null) + if [[ -n "$repo_root" ]]; then local branch branch=$(git rev-parse --abbrev-ref HEAD 2>/dev/null) @@ -278,8 +293,17 @@ function set_bash_prompt() { branch='detached*' fi - # Check if there are uncommitted changes - if [[ -n $(git status --porcelain 2>/dev/null) ]]; then + if [[ "$repo_root" != "$__GIT_DIRTY_REPO" ]] || (( SECONDS - __GIT_DIRTY_TS >= 5 )); then + if [[ -n $(git status --porcelain 2>/dev/null) ]]; then + __GIT_DIRTY_CACHE=1 + else + __GIT_DIRTY_CACHE=0 + fi + __GIT_DIRTY_REPO="$repo_root" + __GIT_DIRTY_TS=$SECONDS + fi + + if [[ "$__GIT_DIRTY_CACHE" == 1 ]]; then git_info=" ${red}(${branch}*)${reset}" else git_info=" ${green}(${branch})${reset}" From 0337a1eb18fb2de9c6f6be80d2ac3333f69bd38b Mon Sep 17 00:00:00 2001 From: Sergio Alexander Florez Galeano Date: Thu, 16 Jul 2026 15:16:20 +0000 Subject: [PATCH 5/7] UPdate --- pnpm-workspace.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml index 4514f35..3d53cd2 100644 --- a/pnpm-workspace.yaml +++ b/pnpm-workspace.yaml @@ -2,10 +2,10 @@ packages: - . # Supply-chain guard: only allow installing package versions that were -# published to the registry at least 1 week ago (10080 minutes). Protects +# published to the registry at least 3 days ago (4320 minutes). Protects # against compromised packages that get yanked or patched within days. # Affects new installs / updates only — the existing lockfile is respected. -minimumReleaseAge: 10080 +minimumReleaseAge: 4320 allowBuilds: # Native bindings / install scripts pnpm 10+ would otherwise refuse to run. From a9ebbb9555b7ddd1b6a7780911ed56ef9908b14f Mon Sep 17 00:00:00 2001 From: Sergio Alexander Florez Galeano Date: Thu, 16 Jul 2026 15:22:01 +0000 Subject: [PATCH 6/7] fix(content): remove invalid YAML escape in FR kit frontmatter Double-quoted YAML rejects \'; d'extension must be unescaped so Astro content sync and codecheck can load kit/fr/ai-diff-reviewer.md. Co-authored-by: Cursor --- src/content/kit/fr/ai-diff-reviewer.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/kit/fr/ai-diff-reviewer.md b/src/content/kit/fr/ai-diff-reviewer.md index cfc1647..c3b8a8a 100644 --- a/src/content/kit/fr/ai-diff-reviewer.md +++ b/src/content/kit/fr/ai-diff-reviewer.md @@ -1,6 +1,6 @@ --- title: AI Diff Reviewer -description: "Addon DWP optionnel : renforce la Revue de sécurité avec un passage local AI Diff Reviewer, porte de fusion CI optionnelle Flow B (v2), fichier d\'extension partagé et compagnon apply-review." +description: "Addon DWP optionnel : renforce la Revue de sécurité avec un passage local AI Diff Reviewer, porte de fusion CI optionnelle Flow B (v2), fichier d'extension partagé et compagnon apply-review." kind: addon lang: fr order: 5 From 7ee57689a33e6ef1923ee531a22616ee570a02d3 Mon Sep 17 00:00:00 2001 From: Sergio Alexander Florez Galeano Date: Thu, 16 Jul 2026 15:46:22 +0000 Subject: [PATCH 7/7] fix(content): address AI review on fifth-addon docs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Sync leftover four→five body copy, complete quickstart addon lists, trim kit/spec meta descriptions to 130–160 chars, fix ES/DE wording, and restore the 7-day pnpm minimumReleaseAge guard. Co-authored-by: Cursor --- pnpm-workspace.yaml | 4 ++-- src/content/kit/de/ai-diff-reviewer.md | 4 ++-- src/content/kit/en/ai-diff-reviewer.md | 2 +- src/content/kit/es/ai-diff-reviewer.md | 4 ++-- src/content/kit/fr/ai-diff-reviewer.md | 2 +- src/content/kit/hi/ai-diff-reviewer.md | 2 +- src/content/kit/id/ai-diff-reviewer.md | 2 +- src/content/kit/it/ai-diff-reviewer.md | 2 +- src/content/kit/ja/ai-diff-reviewer.md | 2 +- src/content/kit/ko/ai-diff-reviewer.md | 2 +- src/content/kit/pl/ai-diff-reviewer.md | 2 +- src/content/kit/pt/ai-diff-reviewer.md | 2 +- src/content/kit/ru/ai-diff-reviewer.md | 2 +- src/content/kit/th/ai-diff-reviewer.md | 2 +- src/content/kit/tr/ai-diff-reviewer.md | 2 +- src/content/kit/uk/ai-diff-reviewer.md | 2 +- src/content/kit/vi/ai-diff-reviewer.md | 2 +- src/content/kit/zh/ai-diff-reviewer.md | 2 +- src/content/spec/de/addons.md | 2 +- src/content/spec/en/addons.md | 2 +- src/content/spec/es/addons.md | 2 +- src/content/spec/fr/addons.md | 4 ++-- src/content/spec/hi/addons.md | 4 ++-- src/content/spec/id/addons.md | 4 ++-- src/content/spec/it/addons.md | 4 ++-- src/content/spec/ja/addons.md | 2 +- src/content/spec/ko/addons.md | 4 ++-- src/content/spec/pl/addons.md | 4 ++-- src/content/spec/pt/addons.md | 2 +- src/content/spec/ru/addons.md | 4 ++-- src/content/spec/th/addons.md | 4 ++-- src/content/spec/tr/addons.md | 4 ++-- src/content/spec/uk/addons.md | 4 ++-- src/content/spec/vi/addons.md | 4 ++-- src/content/spec/zh/addons.md | 2 +- src/lib/translations/fr.ts | 2 +- src/lib/translations/hi.ts | 2 +- src/lib/translations/it.ts | 2 +- src/lib/translations/th.ts | 2 +- 39 files changed, 53 insertions(+), 53 deletions(-) diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml index 3d53cd2..4514f35 100644 --- a/pnpm-workspace.yaml +++ b/pnpm-workspace.yaml @@ -2,10 +2,10 @@ packages: - . # Supply-chain guard: only allow installing package versions that were -# published to the registry at least 3 days ago (4320 minutes). Protects +# published to the registry at least 1 week ago (10080 minutes). Protects # against compromised packages that get yanked or patched within days. # Affects new installs / updates only — the existing lockfile is respected. -minimumReleaseAge: 4320 +minimumReleaseAge: 10080 allowBuilds: # Native bindings / install scripts pnpm 10+ would otherwise refuse to run. diff --git a/src/content/kit/de/ai-diff-reviewer.md b/src/content/kit/de/ai-diff-reviewer.md index d571929..f046e02 100644 --- a/src/content/kit/de/ai-diff-reviewer.md +++ b/src/content/kit/de/ai-diff-reviewer.md @@ -1,6 +1,6 @@ --- title: AI Diff Reviewer -description: "Optionales DWP-Addon: erweitert die Sicherheitsprüfung um einen lokalen AI Diff Reviewer-Durchlauf, optionalen Flow-B-CI-Merge-Gate (v2), gemeinsame Erweiterungsdatei und apply-review-Begleiter." +description: "Optionales DWP-Addon: lokaler AI Diff Reviewer-Lauf für Security Review, optionales Flow-B-CI-Gate (v2), gemeinsame Extension und apply-review." kind: addon lang: de order: 5 @@ -51,7 +51,7 @@ Nach CI-Veröffentlichung einer Überprüfung kann der Entwickler `apply-review` ## Verhalten -- **Flow erfragen; niemals raten.** Ein unaufgefordert installierten Workflow hat einen größeren Fußabdruck als beim Flow A zu bleiben. +- **Flow erfragen; niemals raten.** Ein unaufgefordert installierter Workflow hat einen größeren Fußabdruck als beim Flow A zu bleiben. - **Abstimmen, nicht überschreiben.** Vorhandener Skill, Erweiterung oder `pr-review.yml` bleiben erhalten; nur Lücken füllen. - **Auth verschoben.** Provider-Secrets für CI werden vom Maintainer konfiguriert; dieses Addon speichert keine Anmeldeinformationen. - **Anbieterneutral.** Ablehnen hinterlässt ein vollständig AI-first-Repository. diff --git a/src/content/kit/en/ai-diff-reviewer.md b/src/content/kit/en/ai-diff-reviewer.md index 09df5df..ae95b48 100644 --- a/src/content/kit/en/ai-diff-reviewer.md +++ b/src/content/kit/en/ai-diff-reviewer.md @@ -1,6 +1,6 @@ --- title: AI Diff Reviewer -description: "Opt-in DWP addon: augment Security Review with a local AI Diff Reviewer pass, optional Flow B CI merge gate (v2), shared extension file, and apply-review companion." +description: "Opt-in DWP addon: local AI Diff Reviewer Security Review pass, optional Flow B CI gate (v2), shared extension, and apply-review companion." kind: addon lang: en order: 5 diff --git a/src/content/kit/es/ai-diff-reviewer.md b/src/content/kit/es/ai-diff-reviewer.md index df28837..4348a1e 100644 --- a/src/content/kit/es/ai-diff-reviewer.md +++ b/src/content/kit/es/ai-diff-reviewer.md @@ -1,6 +1,6 @@ --- title: AI Diff Reviewer -description: "Addon DWP opcional: amplía la Revisión de Seguridad con un pase local de AI Diff Reviewer, compuerta de CI opcional de Flujo B (v2), archivo de extensión compartido y compañero apply-review." +description: "Addon DWP opcional: pase local de AI Diff Reviewer en la Revisión de Seguridad, puerta CI Flow B opcional (v2), extensión compartida y apply-review." kind: addon lang: es order: 5 @@ -52,7 +52,7 @@ Tras publicar CI una revisión, el desarrollador puede invocar `apply-review` du ## Comportamiento - **Pregunta el flujo; nunca asumas.** Instalar un flujo no solicitado es una huella mayor que permanecer en el Flujo A. -- **Reconcilia, no sobreescriba.** La skill, extensión o `pr-review.yml` existentes se preservan; solo rellena huecos. +- **Reconcilia, no sobrescribas.** La skill, extensión o `pr-review.yml` existentes se preservan; solo rellena huecos. - **Auth diferida.** Los secretos del proveedor para CI los configura el mantenedor; este addon nunca almacena credenciales. - **Neutral respecto al proveedor.** Rechazarlo deja un repositorio plenamente AI-first. diff --git a/src/content/kit/fr/ai-diff-reviewer.md b/src/content/kit/fr/ai-diff-reviewer.md index c3b8a8a..a2a997f 100644 --- a/src/content/kit/fr/ai-diff-reviewer.md +++ b/src/content/kit/fr/ai-diff-reviewer.md @@ -1,6 +1,6 @@ --- title: AI Diff Reviewer -description: "Addon DWP optionnel : renforce la Revue de sécurité avec un passage local AI Diff Reviewer, porte de fusion CI optionnelle Flow B (v2), fichier d'extension partagé et compagnon apply-review." +description: "Addon DWP optionnel : passage local AI Diff Reviewer pour la Revue de sécurité, porte CI Flow B optionnelle (v2), extension partagée et apply-review." kind: addon lang: fr order: 5 diff --git a/src/content/kit/hi/ai-diff-reviewer.md b/src/content/kit/hi/ai-diff-reviewer.md index dc09157..2af15f6 100644 --- a/src/content/kit/hi/ai-diff-reviewer.md +++ b/src/content/kit/hi/ai-diff-reviewer.md @@ -1,6 +1,6 @@ --- title: AI Diff Reviewer -description: "वैकल्पिक DWP ऐड-ऑन: स्थानीय AI Diff Reviewer पास से सुरक्षा समीक्षा को बेहतर बनाएं, वैकल्पिक Flow B CI मर्ज गेट (v2), साझा एक्सटेंशन फ़ाइल, और apply-review साथी।" +description: "वैकल्पिक DWP ऐड-ऑन: Security Review के लिए स्थानीय AI Diff Reviewer पास, वैकल्पिक Flow B CI गेट (v2), साझा extension, और apply-review साथी।" kind: addon lang: hi order: 5 diff --git a/src/content/kit/id/ai-diff-reviewer.md b/src/content/kit/id/ai-diff-reviewer.md index 5893171..8464604 100644 --- a/src/content/kit/id/ai-diff-reviewer.md +++ b/src/content/kit/id/ai-diff-reviewer.md @@ -1,6 +1,6 @@ --- title: AI Diff Reviewer -description: "Add-on DWP opsional: perkuat Tinjauan Keamanan dengan penerusan lokal AI Diff Reviewer, gerbang gabungan CI Flow B opsional (v2), file ekstensi bersama, dan pendamping apply-review." +description: "Add-on DWP opsional: pass lokal AI Diff Reviewer untuk Security Review, gerbang CI Flow B opsional (v2), extension bersama, dan apply-review." kind: addon lang: id order: 5 diff --git a/src/content/kit/it/ai-diff-reviewer.md b/src/content/kit/it/ai-diff-reviewer.md index e9f09e4..c1b5a52 100644 --- a/src/content/kit/it/ai-diff-reviewer.md +++ b/src/content/kit/it/ai-diff-reviewer.md @@ -1,6 +1,6 @@ --- title: AI Diff Reviewer -description: "Addon DWP opzionale: potenzia la Revisione di Sicurezza con un passaggio locale di AI Diff Reviewer, gate CI opzionale Flow B (v2), file di estensione condiviso e compagno apply-review." +description: "Addon DWP opzionale: passaggio locale AI Diff Reviewer per la Revisione di Sicurezza, gate CI Flow B opzionale (v2), extension condivisa e apply-review." kind: addon lang: it order: 5 diff --git a/src/content/kit/ja/ai-diff-reviewer.md b/src/content/kit/ja/ai-diff-reviewer.md index e2175a3..c6e09f1 100644 --- a/src/content/kit/ja/ai-diff-reviewer.md +++ b/src/content/kit/ja/ai-diff-reviewer.md @@ -1,6 +1,6 @@ --- title: AI Diff Reviewer -description: "オプションの DWP アドオン:ローカル AI Diff Reviewer パスでセキュリティレビューを強化、オプションの Flow B CI マージゲート(v2)、共有拡張ファイル、apply-review コンパニオン。" +description: "任意のDWPアドオンです。Security Review向けのローカルAI Diff Reviewer実行、任意のFlow B CIマージゲート(v2)、共有の.review/extensionファイル、およびapply-reviewコンパニオンを提供し、ローカルとCIのレビューを揃えます。" kind: addon lang: ja order: 5 diff --git a/src/content/kit/ko/ai-diff-reviewer.md b/src/content/kit/ko/ai-diff-reviewer.md index c1a17cd..17e5a71 100644 --- a/src/content/kit/ko/ai-diff-reviewer.md +++ b/src/content/kit/ko/ai-diff-reviewer.md @@ -1,6 +1,6 @@ --- title: AI Diff Reviewer -description: "선택적 DWP 애드온: 로컬 AI Diff Reviewer 패스로 보안 검토 강화, 선택적 Flow B CI 병합 게이트(v2), 공유 확장 파일, apply-review 컴패니언." +description: "선택적 DWP 애드온입니다. Security Review용 로컬 AI Diff Reviewer 패스, 선택적 Flow B CI 머지 게이트(v2), 공유 .review/extension 파일, apply-review 동반 기능으로 로컬과 CI 리뷰를 맞춥니다." kind: addon lang: ko order: 5 diff --git a/src/content/kit/pl/ai-diff-reviewer.md b/src/content/kit/pl/ai-diff-reviewer.md index 09cd2dc..d5a509b 100644 --- a/src/content/kit/pl/ai-diff-reviewer.md +++ b/src/content/kit/pl/ai-diff-reviewer.md @@ -1,6 +1,6 @@ --- title: AI Diff Reviewer -description: "Opcjonalny dodatek DWP: rozszerza Przegląd Bezpieczeństwa o lokalny przebieg AI Diff Reviewer, opcjonalną bramkę scalania CI Flow B (v2), współdzielony plik rozszerzenia i towarzysza apply-review." +description: "Opcjonalny dodatek DWP: lokalny przebieg AI Diff Reviewer w Security Review, opcjonalna bramka CI Flow B (v2), wspólne extension i apply-review." kind: addon lang: pl order: 5 diff --git a/src/content/kit/pt/ai-diff-reviewer.md b/src/content/kit/pt/ai-diff-reviewer.md index 38ca618..7b0924f 100644 --- a/src/content/kit/pt/ai-diff-reviewer.md +++ b/src/content/kit/pt/ai-diff-reviewer.md @@ -1,6 +1,6 @@ --- title: AI Diff Reviewer -description: "Addon DWP opcional: aumenta a Revisão de Segurança com uma passagem local do AI Diff Reviewer, portão de CI opcional do Fluxo B (v2), ficheiro de extensão partilhado e companheiro apply-review." +description: "Addon DWP opcional: passagem local do AI Diff Reviewer na Revisão de Segurança, porta CI Flow B opcional (v2), extensão partilhada e apply-review." kind: addon lang: pt order: 5 diff --git a/src/content/kit/ru/ai-diff-reviewer.md b/src/content/kit/ru/ai-diff-reviewer.md index a95a792..9857aae 100644 --- a/src/content/kit/ru/ai-diff-reviewer.md +++ b/src/content/kit/ru/ai-diff-reviewer.md @@ -1,6 +1,6 @@ --- title: AI Diff Reviewer -description: "Дополнение DWP по выбору: расширяет проверку безопасности локальным проходом AI Diff Reviewer, опциональным CI-шлюзом Flow B (v2), общим файлом расширения и компаньоном apply-review." +description: "Дополнение DWP по выбору: локальный проход AI Diff Reviewer для Security Review, опциональный CI-шлюз Flow B (v2), общее extension и apply-review." kind: addon lang: ru order: 5 diff --git a/src/content/kit/th/ai-diff-reviewer.md b/src/content/kit/th/ai-diff-reviewer.md index 12647df..4c2a944 100644 --- a/src/content/kit/th/ai-diff-reviewer.md +++ b/src/content/kit/th/ai-diff-reviewer.md @@ -1,6 +1,6 @@ --- title: AI Diff Reviewer -description: "ส่วนเสริม DWP แบบเลือกใช้: เสริมการตรวจสอบความปลอดภัยด้วยการรัน AI Diff Reviewer ในเครื่อง, เกท CI Flow B แบบเลือกใช้ (v2), ไฟล์ส่วนขยายที่ใช้ร่วมกัน และผู้ช่วย apply-review" +description: "Addon DWP แบบสมัครใจ: ผ่าน AI Diff Reviewer ภายในสำหรับ Security Review, ประตู CI Flow B แบบเลือกได้ (v2), ไฟล์ extension ร่วม และ apply-review" kind: addon lang: th order: 5 diff --git a/src/content/kit/tr/ai-diff-reviewer.md b/src/content/kit/tr/ai-diff-reviewer.md index 6866997..bf22c2a 100644 --- a/src/content/kit/tr/ai-diff-reviewer.md +++ b/src/content/kit/tr/ai-diff-reviewer.md @@ -1,6 +1,6 @@ --- title: AI Diff Reviewer -description: "İsteğe bağlı DWP eklentisi: Güvenlik İncelemesini yerel bir AI Diff Reviewer geçişiyle güçlendirir, isteğe bağlı Flow B CI birleştirme kapısı (v2), paylaşılan uzantı dosyası ve apply-review yardımcısı." +description: "İsteğe bağlı DWP eklentisi: Security Review için yerel AI Diff Reviewer geçişi, isteğe bağlı Flow B CI kapısı (v2), ortak extension ve apply-review." kind: addon lang: tr order: 5 diff --git a/src/content/kit/uk/ai-diff-reviewer.md b/src/content/kit/uk/ai-diff-reviewer.md index 3fa65a3..7c82f57 100644 --- a/src/content/kit/uk/ai-diff-reviewer.md +++ b/src/content/kit/uk/ai-diff-reviewer.md @@ -1,6 +1,6 @@ --- title: AI Diff Reviewer -description: "Необов'язковий додаток DWP: розширює Огляд безпеки локальним проходом AI Diff Reviewer, необов'язковим CI-шлюзом Flow B (v2), спільним файлом розширення та супутником apply-review." +description: "Необов'язковий додаток DWP: локальний прохід AI Diff Reviewer для Security Review, опційний CI-шлюз Flow B (v2), спільне extension і apply-review." kind: addon lang: uk order: 5 diff --git a/src/content/kit/vi/ai-diff-reviewer.md b/src/content/kit/vi/ai-diff-reviewer.md index 63dd05f..8d1b842 100644 --- a/src/content/kit/vi/ai-diff-reviewer.md +++ b/src/content/kit/vi/ai-diff-reviewer.md @@ -1,6 +1,6 @@ --- title: AI Diff Reviewer -description: "Tiện ích bổ sung DWP tùy chọn: tăng cường Đánh giá Bảo mật bằng lượt kiểm tra cục bộ AI Diff Reviewer, cổng hợp nhất CI Flow B tùy chọn (v2), tệp mở rộng dùng chung và trợ lý apply-review." +description: "Addon DWP tùy chọn: lượt AI Diff Reviewer cục bộ cho Security Review, cổng CI Flow B tùy chọn (v2), extension dùng chung và apply-review." kind: addon lang: vi order: 5 diff --git a/src/content/kit/zh/ai-diff-reviewer.md b/src/content/kit/zh/ai-diff-reviewer.md index d5788dc..e2a1198 100644 --- a/src/content/kit/zh/ai-diff-reviewer.md +++ b/src/content/kit/zh/ai-diff-reviewer.md @@ -1,6 +1,6 @@ --- title: AI Diff Reviewer -description: "可选 DWP 附加组件:通过本地 AI Diff Reviewer 通道增强安全审查,可选 Flow B CI 合并门控(v2),共享扩展文件及 apply-review 伴随工具。" +description: "可选的DWP附加组件:为Security Review提供本地AI Diff Reviewer通道、可选的Flow B CI合并门控(v2)、共享的.review/extension文件,以及apply-review伴侣流程,使本地审查与CI审查两边保持一致。" kind: addon lang: zh order: 5 diff --git a/src/content/spec/de/addons.md b/src/content/spec/de/addons.md index 6430a97..3493e78 100644 --- a/src/content/spec/de/addons.md +++ b/src/content/spec/de/addons.md @@ -1,6 +1,6 @@ --- title: Add-ons -description: "Optionale DWP-Erweiterungen: die fünf aktiven Addons (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), der Addon-Vertrag und Kit-Konzepte." +description: "Optionale DWP-Erweiterungen: fünf Addons (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), Addon-Vertrag und Kit-Konzepte." order: 5 lang: de section: Addons diff --git a/src/content/spec/en/addons.md b/src/content/spec/en/addons.md index 3298128..673af20 100644 --- a/src/content/spec/en/addons.md +++ b/src/content/spec/en/addons.md @@ -1,6 +1,6 @@ --- title: Add-ons -description: "Optional DWP extensions: the five shipping addons (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), the addon contract, and kit concepts (skills, agents, presets, adapters, examples)." +description: "Optional DWP extensions: five shipping addons (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), addon contract, and kit concepts." order: 5 lang: en section: Addons diff --git a/src/content/spec/es/addons.md b/src/content/spec/es/addons.md index 6db50b3..0c53dd4 100644 --- a/src/content/spec/es/addons.md +++ b/src/content/spec/es/addons.md @@ -1,6 +1,6 @@ --- title: Complementos -description: "Extensiones opcionales de DWP: los cinco addons activos (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), el contrato de addon y conceptos del kit." +description: "Extensiones opcionales de DWP: cinco addons (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), contrato y conceptos del kit." order: 5 lang: es section: Addons diff --git a/src/content/spec/fr/addons.md b/src/content/spec/fr/addons.md index 0694d8c..3f1bc6f 100644 --- a/src/content/spec/fr/addons.md +++ b/src/content/spec/fr/addons.md @@ -1,6 +1,6 @@ --- title: Modules complémentaires -description: "Extensions DWP optionnelles : les cinq addons actifs (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), le contrat d'addon et les concepts du kit." +description: "Extensions DWP optionnelles : cinq addons (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), contrat d’addon et concepts du kit." order: 5 lang: fr section: Addons @@ -25,7 +25,7 @@ Découverte : le flux `onboard` énumère `skills/deepworkplan/addons/` et prés ## Addons actifs (cinq) -Quatre addons sont actifs aujourd'hui. Chacun a une **page du catalogue kit** avec des détails orientés utilisateur et une **spec normative** dans la skill Deep Work Plan. +Cinq addons sont actifs aujourd'hui. Chacun a une **page du catalogue kit** avec des détails orientés utilisateur et une **spec normative** dans la skill Deep Work Plan. ### Devcontainer (premier addon) diff --git a/src/content/spec/hi/addons.md b/src/content/spec/hi/addons.md index 822a7cc..3c48715 100644 --- a/src/content/spec/hi/addons.md +++ b/src/content/spec/hi/addons.md @@ -1,6 +1,6 @@ --- title: ऐडऑन -description: "वैकल्पिक DWP विस्तार: पाँच shipping ऐडऑन (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), ऐडऑन अनुबंध, और kit अवधारणाएँ (skills, agents, presets, adapters, examples)।" +description: "वैकल्पिक DWP विस्तार: पाँच ऐडऑन (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), ऐडऑन अनुबंध और kit अवधारणाएँ।" order: 5 lang: hi section: Addons @@ -25,7 +25,7 @@ section: Addons ## Shipping ऐडऑन (पाँच) -आज चार ऐडऑन ship होते हैं। हर एक का **kit catalog पृष्ठ** user-facing विवरण के साथ और Deep Work Plan स्किल के अंदर **normative spec** है। +आज पाँच ऐडऑन ship होते हैं। हर एक का **kit catalog पृष्ठ** user-facing विवरण के साथ और Deep Work Plan स्किल के अंदर **normative spec** है। ### Devcontainer (पहला ऐडऑन) diff --git a/src/content/spec/id/addons.md b/src/content/spec/id/addons.md index a7d01b2..005deed 100644 --- a/src/content/spec/id/addons.md +++ b/src/content/spec/id/addons.md @@ -1,6 +1,6 @@ --- title: Add-on -description: "Ekstensi DWP opsional: lima addon yang dikirim (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), kontrak addon, dan konsep kit (skill, agen, preset, adapter, contoh)." +description: "Ekstensi DWP opsional: lima addon (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), kontrak addon, dan konsep kit." order: 5 lang: id section: Addons @@ -25,7 +25,7 @@ Penemuan: alur `onboard` mengekstrak `skills/deepworkplan/addons/` dan menyajika ## Addon yang dikirim (lima) -Empat addon tersedia hari ini. Masing-masing memiliki **halaman katalog kit** dengan detail untuk pengguna dan **spec normatif** di dalam skill Deep Work Plan. +Lima addon tersedia hari ini. Masing-masing memiliki **halaman katalog kit** dengan detail untuk pengguna dan **spec normatif** di dalam skill Deep Work Plan. ### Devcontainer (addon pertama) diff --git a/src/content/spec/it/addons.md b/src/content/spec/it/addons.md index 6913b2d..90825b6 100644 --- a/src/content/spec/it/addons.md +++ b/src/content/spec/it/addons.md @@ -1,6 +1,6 @@ --- title: Add-on -description: "Estensioni DWP opzionali: i cinque addon in produzione (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), il contratto addon e i concetti del kit (skill, agenti, preset, adapter, esempi)." +description: "Estensioni DWP opzionali: cinque addon (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), contratto e concetti del kit." order: 5 lang: it section: Addons @@ -25,7 +25,7 @@ Scoperta: il flusso `onboard` enumera `skills/deepworkplan/addons/` e presenta o ## Addon in produzione (cinque) -Quattro addon sono disponibili oggi. Ognuno ha una **pagina del catalogo kit** con dettagli per l'utente e una **spec normativa** all'interno della skill Deep Work Plan. +Cinque addon sono disponibili oggi. Ognuno ha una **pagina del catalogo kit** con dettagli per l'utente e una **spec normativa** all'interno della skill Deep Work Plan. ### Devcontainer (primo addon) diff --git a/src/content/spec/ja/addons.md b/src/content/spec/ja/addons.md index 9c9cc54..44d5be1 100644 --- a/src/content/spec/ja/addons.md +++ b/src/content/spec/ja/addons.md @@ -1,6 +1,6 @@ --- title: アドオン -description: "オプションの DWP 拡張:5 つの出荷済みアドオン(devcontainer、Dailybot、dependency-upgrade、design-system、AI Diff Reviewer)、アドオン契約、およびキット概念(スキル、エージェント、プリセット、アダプター、例)。" +description: "オプションのDWP拡張機能:5つの出荷アドオン(devcontainer、Dailybot、dependency-upgrade、design-system、AI Diff Reviewer)、アドオン契約、およびキットの基本概念(skills・agents・presets)を説明します。" order: 5 lang: ja section: Addons diff --git a/src/content/spec/ko/addons.md b/src/content/spec/ko/addons.md index d0939f0..be1b780 100644 --- a/src/content/spec/ko/addons.md +++ b/src/content/spec/ko/addons.md @@ -1,6 +1,6 @@ --- title: 애드온 -description: "선택적 DWP 확장: 다섯 가지 출시 애드온(devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), 애드온 계약, 및 키트 개념(스킬, 에이전트, 프리셋, 어댑터, 예제)." +description: "선택적 DWP 확장: 다섯 가지 출시 애드온(devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), 애드온 계약 및 키트 개념(skills, agents, presets)을 설명합니다." order: 5 lang: ko section: Addons @@ -25,7 +25,7 @@ section: Addons ## 출시 애드온(다섯 가지) -현재 네 가지 애드온이 출시됩니다. 각각 **키트 카탈로그 페이지**(사용자 대상 세부)와 Deep Work Plan 스킬 내 **규범 스펙**이 있습니다. +현재 다섯 가지 애드온이 출시됩니다. 각각 **키트 카탈로그 페이지**(사용자 대상 세부)와 Deep Work Plan 스킬 내 **규범 스펙**이 있습니다. ### Devcontainer(첫 번째 애드온) diff --git a/src/content/spec/pl/addons.md b/src/content/spec/pl/addons.md index 95fd077..1b1ceae 100644 --- a/src/content/spec/pl/addons.md +++ b/src/content/spec/pl/addons.md @@ -1,6 +1,6 @@ --- title: Dodatki -description: "Opcjonalne rozszerzenia DWP: pięć dostępnych addonów (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), kontrakt addonu oraz koncepcje kit (skille, agenci, presety, adaptery, przykłady)." +description: "Opcjonalne rozszerzenia DWP: pięć addonów (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), kontrakt i pojęcia kitu." order: 5 lang: pl section: Addons @@ -25,7 +25,7 @@ Odkrywanie: przepływ `onboard` enumeruje `skills/deepworkplan/addons/` i prezen ## Dostępne addony (pięć) -Dziś dostępne są cztery addony. Każdy ma **stronę katalogu kit** ze szczegółami dla użytkownika oraz **normatywną specyfikację** w skillu Deep Work Plan. +Dziś dostępne są pięć addonów. Każdy ma **stronę katalogu kit** ze szczegółami dla użytkownika oraz **normatywną specyfikację** w skillu Deep Work Plan. ### Devcontainer (pierwszy addon) diff --git a/src/content/spec/pt/addons.md b/src/content/spec/pt/addons.md index 0cdd1ea..185744d 100644 --- a/src/content/spec/pt/addons.md +++ b/src/content/spec/pt/addons.md @@ -1,6 +1,6 @@ --- title: Complementos -description: "Extensões opcionais do DWP: os cinco addons ativos (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), o contrato de addon e conceitos do kit." +description: "Extensões opcionais do DWP: cinco addons (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), contrato e conceitos do kit." order: 5 lang: pt section: Addons diff --git a/src/content/spec/ru/addons.md b/src/content/spec/ru/addons.md index ad463fa..56454fc 100644 --- a/src/content/spec/ru/addons.md +++ b/src/content/spec/ru/addons.md @@ -1,6 +1,6 @@ --- title: Аддоны -description: "Опциональные расширения DWP: пять поставляемых аддонов (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), контракт аддона и концепции kit (навыки, агенты, пресеты, адаптеры, примеры)." +description: "Опциональные расширения DWP: пять аддонов (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), контракт аддона и понятия kit." order: 5 lang: ru section: Addons @@ -25,7 +25,7 @@ section: Addons ## Поставляемые аддоны (пять) -Сегодня поставляются четыре аддона. У каждого есть **страница каталога kit** с пользовательскими деталями и **нормативная спецификация** внутри навыка Deep Work Plan. +Сегодня поставляются пять аддонов. У каждого есть **страница каталога kit** с пользовательскими деталями и **нормативная спецификация** внутри навыка Deep Work Plan. ### Devcontainer (первый аддон) diff --git a/src/content/spec/th/addons.md b/src/content/spec/th/addons.md index a729e54..b4c3eba 100644 --- a/src/content/spec/th/addons.md +++ b/src/content/spec/th/addons.md @@ -1,6 +1,6 @@ --- title: ส่วนเสริม -description: "ส่วนขยาย DWP แบบเลือกได้: ห้า addon ที่จัดส่ง (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer) สัญญา addon และแนวคิด kit (skills, agents, presets, adapters, examples)" +description: "ส่วนขยาย DWP แบบเลือกได้: ห้า addon (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), สัญญา addon และแนวคิด kit" order: 5 lang: th section: Addons @@ -25,7 +25,7 @@ section: Addons ## Addon ที่จัดส่ง (ห้าตัว) -วันนี้มีสี่ addon แต่ละตัวมี **หน้าแคตตาล็อก kit** พร้อมรายละเอียดสำหรับผู้ใช้ และ **spec normative** ภายใน skill Deep Work Plan +วันนี้มีห้า addon แต่ละตัวมี **หน้าแคตตาล็อก kit** พร้อมรายละเอียดสำหรับผู้ใช้ และ **spec normative** ภายใน skill Deep Work Plan ### Devcontainer (addon แรก) diff --git a/src/content/spec/tr/addons.md b/src/content/spec/tr/addons.md index ca514c2..da1b54f 100644 --- a/src/content/spec/tr/addons.md +++ b/src/content/spec/tr/addons.md @@ -1,6 +1,6 @@ --- title: Eklentiler -description: "İsteğe bağlı DWP uzantıları: beş üretim eklentisi (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), eklenti sözleşmesi ve kit kavramları (skill'ler, agent'lar, preset'ler, adapter'lar, örnekler)." +description: "İsteğe bağlı DWP uzantıları: beş eklenti (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), eklenti sözleşmesi ve kit kavramları." order: 5 lang: tr section: Addons @@ -25,7 +25,7 @@ Keşif: `onboard` akışı `skills/deepworkplan/addons/` dizinini numaralandır ## Üretim eklentileri (beş) -Bugün dört eklenti sunulmaktadır. Her birinin kullanıcıya yönelik ayrıntılı bir **kit katalog sayfası** ve Deep Work Plan skill'i içinde **normatif spec**'i vardır. +Bugün beş eklenti sunulmaktadır. Her birinin kullanıcıya yönelik ayrıntılı bir **kit katalog sayfası** ve Deep Work Plan skill'i içinde **normatif spec**'i vardır. ### Devcontainer (birinci eklenti) diff --git a/src/content/spec/uk/addons.md b/src/content/spec/uk/addons.md index abf1d18..0e88f1d 100644 --- a/src/content/spec/uk/addons.md +++ b/src/content/spec/uk/addons.md @@ -1,6 +1,6 @@ --- title: Додатки -description: "Опційні розширення DWP: п'ять shipping-аддонів (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), контракт аддона та концепції kit (скіли, агенти, пресети, адаптери, приклади)." +description: "Опційні розширення DWP: п'ять аддонів (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), контракт аддона та поняття kit." order: 5 lang: uk section: Addons @@ -25,7 +25,7 @@ section: Addons ## Shipping-аддони (п'ять) -Сьогодні доступні чотири аддони. Кожен має **сторінку каталогу kit** з деталями для користувача та **нормативну spec** у скілі Deep Work Plan. +Сьогодні доступні п'ять аддонів. Кожен має **сторінку каталогу kit** з деталями для користувача та **нормативну spec** у скілі Deep Work Plan. ### Devcontainer (перший аддон) diff --git a/src/content/spec/vi/addons.md b/src/content/spec/vi/addons.md index 13d4555..af8af21 100644 --- a/src/content/spec/vi/addons.md +++ b/src/content/spec/vi/addons.md @@ -1,6 +1,6 @@ --- title: Add-on -description: "Phần mở rộng DWP tùy chọn: năm addon đang phát hành (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), hợp đồng addon và khái niệm kit (skill, agent, preset, adapter, ví dụ)." +description: "Phần mở rộng DWP tùy chọn: năm addon (devcontainer, Dailybot, dependency-upgrade, design-system, AI Diff Reviewer), hợp đồng addon và khái niệm kit." order: 5 lang: vi section: Addons @@ -25,7 +25,7 @@ Khám phá: luồng `onboard` liệt kê `skills/deepworkplan/addons/` và trìn ## Addon đang phát hành (năm) -Hôm nay có bốn addon. Mỗi addon có **trang danh mục kit** với chi tiết hướng người dùng và **spec chuẩn** bên trong skill Deep Work Plan. +Hôm nay có năm addon. Mỗi addon có **trang danh mục kit** với chi tiết hướng người dùng và **spec chuẩn** bên trong skill Deep Work Plan. ### Devcontainer (addon đầu tiên) diff --git a/src/content/spec/zh/addons.md b/src/content/spec/zh/addons.md index 7dc47ff..0c9a04b 100644 --- a/src/content/spec/zh/addons.md +++ b/src/content/spec/zh/addons.md @@ -1,6 +1,6 @@ --- title: 附加组件 -description: "可选 DWP 扩展:五个已发布的附加组件(devcontainer、Dailybot、dependency-upgrade、design-system、AI Diff Reviewer)、附加组件合约,以及套件概念(技能、代理、预设、适配器、示例)。" +description: "可选的DWP扩展:五个已发布附加组件(devcontainer、Dailybot、dependency-upgrade、design-system、AI Diff Reviewer)、附加组件合约,以及套件相关概念(skills、agents、presets)说明。" order: 5 lang: zh section: Addons diff --git a/src/lib/translations/fr.ts b/src/lib/translations/fr.ts index 82070c5..f94460a 100644 --- a/src/lib/translations/fr.ts +++ b/src/lib/translations/fr.ts @@ -642,7 +642,7 @@ export const fr: SiteTranslations = { { title: 'Faire évoluer le kit et accepter des addons', description: - 'Utilisez /skill-create et /agent-create (le sous-skill author) pour faire grandir des skills, agents et commandes adaptés à votre stack. L’onboarding propose aussi cinq addons facultatifs — devcontainer, Dailybot, dependency-upgrade et design-system — que vous acceptez seulement lorsqu’ils conviennent.', + 'Utilisez /skill-create et /agent-create (le sous-skill author) pour faire grandir des skills, agents et commandes adaptés à votre stack. L’onboarding propose aussi cinq addons facultatifs — devcontainer, Dailybot, dependency-upgrade, design-system et AI Diff Reviewer — que vous acceptez seulement lorsqu’ils conviennent.', }, { title: 'Planifier et exécuter', diff --git a/src/lib/translations/hi.ts b/src/lib/translations/hi.ts index 6442693..d3539d5 100644 --- a/src/lib/translations/hi.ts +++ b/src/lib/translations/hi.ts @@ -634,7 +634,7 @@ export const hi: SiteTranslations = { { title: 'किट विकसित करें और ऐडऑन स्वीकार करें', description: - 'स्टैक-उपयुक्त स्किल्स, एजेंट्स और कमांड्स विकसित करने के लिए /skill-create और /agent-create (author सब-स्किल) का उपयोग करें। ऑनबोर्डिंग पाँच ऑप्ट-इन ऐडऑन भी प्रदान करती है — devcontainer, Dailybot, dependency-upgrade और design-system — जिन्हें आप तभी स्वीकार करते हैं जब वे उपयुक्त हों।', + 'स्टैक-उपयुक्त स्किल्स, एजेंट्स और कमांड्स विकसित करने के लिए /skill-create और /agent-create (author सब-स्किल) का उपयोग करें। ऑनबोर्डिंग पाँच ऑप्ट-इन ऐडऑन भी प्रदान करती है — devcontainer, Dailybot, dependency-upgrade, design-system और AI Diff Reviewer — जिन्हें आप तभी स्वीकार करते हैं जब वे उपयुक्त हों।', }, { title: 'योजना बनाएँ और निष्पादित करें', diff --git a/src/lib/translations/it.ts b/src/lib/translations/it.ts index a0f1739..a5cac87 100644 --- a/src/lib/translations/it.ts +++ b/src/lib/translations/it.ts @@ -638,7 +638,7 @@ export const it: SiteTranslations = { { title: 'Faccia evolvere il kit e accetti gli addon', description: - 'Usi /skill-create e /agent-create (la sub-skill author) per far crescere skill, agenti e comandi adatti allo stack. L’onboarding offre anche cinque addon opt-in — devcontainer, Dailybot, dependency-upgrade e design-system — che accetta solo quando sono pertinenti.', + 'Usi /skill-create e /agent-create (la sub-skill author) per far crescere skill, agenti e comandi adatti allo stack. L’onboarding offre anche cinque addon opt-in — devcontainer, Dailybot, dependency-upgrade, design-system e AI Diff Reviewer — che accetta solo quando sono pertinenti.', }, { title: 'Pianifichi ed esegua', diff --git a/src/lib/translations/th.ts b/src/lib/translations/th.ts index 60290ff..c6a74dd 100644 --- a/src/lib/translations/th.ts +++ b/src/lib/translations/th.ts @@ -631,7 +631,7 @@ export const th: SiteTranslations = { { title: 'พัฒนาชุดเครื่องมือและรับ addon', description: - 'ใช้ /skill-create และ /agent-create (สกิลย่อย author) เพื่อสร้างสกิล agent และคำสั่งที่เหมาะกับสแตก การเริ่มต้นยังเสนอ addon แบบสมัครใจห้าตัว ได้แก่ devcontainer, Dailybot, dependency-upgrade และ design-system ซึ่งคุณรับมาเฉพาะเมื่อเหมาะสม', + 'ใช้ /skill-create และ /agent-create (สกิลย่อย author) เพื่อสร้างสกิล agent และคำสั่งที่เหมาะกับสแตก การเริ่มต้นยังเสนอ addon แบบสมัครใจห้าตัว ได้แก่ devcontainer, Dailybot, dependency-upgrade, design-system และ AI Diff Reviewer ซึ่งคุณรับมาเฉพาะเมื่อเหมาะสม', }, { title: 'วางแผนและลงมือทำ',