skills/nexu-io__open-design
1
0
Fork 0
mirror of https://github.com/nexu-io/open-design.git synced 2026-09-20 06:15:06 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
chore/plugin-previews
nexu-io__open-design/plugins/community/humanize-ppt/docs/index.md
T
卡尔的AI沃茨 5435274ab4 Add Humanize PPT plugin (#5655) 
* feat(plugins): add Humanize PPT community plugin

Ports LearnPrompt/humanize-ppt (MIT) into plugins/community/ following
the community/hallmark precedent, and registers it in the community
marketplace index (0.2.0 -> 0.2.1).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* fix(plugins): harden humanize-ppt per review — out-dir guard, PPTX fail-closed, packaging (v1.1.1)

- brief mode no longer wipes a non-empty --out unless it carries Humanize
  run markers or --force is passed; wipe semantics documented in SKILL.md
  and docs/local-demo.md
- read_source fails closed on .ppt/.pptx with guidance (extract text
  first; rendered decks go to --qa-from); SKILL.md/SPEC.md wording aligned
- vendor examples/01-ai-tool-update/source.md, inline-fixture fallback in
  smoke_check.py, drop repo-only record_demo_gif.py, point dangling doc
  links at the upstream repo

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* fix(plugins): humanize-ppt review follow-ups — outline-gate markers, shim exit codes (v1.1.2)

- HUMANIZE_OUT_MARKERS now includes outline-preview.md and
  preview-confirmed.json, so the documented --preview-outline ->
  --confirm-outline -> brief flow on one --out is no longer refused by
  the out-dir guard; refusal text, --out help, SKILL.md/SPEC.md/
  docs/local-demo.md list all four markers
- humanize_ppt_v3/v4/v5 shims call sys.exit(main()) like the stable
  entrypoint, so validation failures propagate exit 2 instead of 0
- smoke_check.py gains an outline-gate check (preview -> confirm ->
  brief on one --out, plus the unrelated-out refusal negative path) and
  an exit-code matrix across all five public entrypoints
- plugin 1.1.2, community registry 0.2.3

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2026-07-21 07:52:47 +00:00

9.2 KiB
Raw Permalink Blame History

Humanize PPT

This is the marketplace-slim package. It ships the runtime-critical references, adapters, and one runnable example. The full examples/, docs/versions/, docs/plans/, and docs/showcase/ trees live in the upstream repo: https://github.com/LearnPrompt/humanize-ppt — links below that point outside this package go there.

Public preview docs. The current public preview shows the tuned Skill sharing deck plus the stable Chinese and English Hermes Agent Mastery routes.

Full annotated reference index

Moved from SKILL.md (which keeps only the runtime-critical shortlist).

Core contracts & specs

  • ../references/guizang-production-brief-orchestrator.md — v0.6.4 canonical brief specification. The human + agent-facing contract for what <renderer>-production-prompt.md must contain and what it must not contain.
  • ../SPEC.md — engine technical specification: boundary, CLI surface (mode-check order), data flow, output contract, the v0.9 style gallery, the presentation checkup, the per-page media model, and the renderer registry. The authoritative "what the engine does and guarantees" reference.
  • ../references/qa-failure-modes.md (+ English mirror ../references/qa-failure-modes.en.md) — failure mode catalog for the presentation checkup (演讲体检): a renderer-agnostic failure-class layer plus guizang-specific modes, each with what the audience would see. Human-readable; the code-side source of truth is FAILURE_MODES in ../scripts/humanize_ppt_v2.py. Includes the WebGL-hero static-screenshot capture trap as a "static scan can't catch yet" class.
  • ../references/style-gallery-spec.md — v0.9 spec for the --style-gallery cover-style gate: candidates, cover-only commands, the zero-dependency picker, re-injection, and the WebGL screenshot warning.
  • ../references/renderer-guidance.md — per-renderer recommended paths (Chinese / English / native PPTX) and the known-good checkpoint rules.
  • ../references/renderer-verification.md — per-renderer verification evidence behind the SKILL.md frontmatter one-liners.

Renderer adapters & evidence

  • ../adapters/ppt-master-bridge-notes.md — native PPTX route boundary, semantic/media/notes mapping, raw-template routing, and OOXML checkup contract.
  • Real PPT Master export and Humanize PPTX checkup evidence: https://github.com/LearnPrompt/humanize-ppt/blob/main/docs/showcase/ppt-master-native/verification-2026-07-10.md
  • Paired Chinese/English PPT Master exports, rendered previews, native-editability evidence, and Humanize checkup results: https://github.com/LearnPrompt/humanize-ppt/blob/main/docs/showcase/ppt-master-native/verification-2026-07-14.md
  • ../references/guizang-material-qa.md — Guizang downstream workflow, material production rules, Swiss visual QA checklist, and failure patterns learned from a full Humanize PPT → guizang deck pass. Caveat: these rules apply to the rendered HTML, not to the Humanize brief.
  • ../references/guizang-presenter-deploy.md — Default Chinese PPT production path: guizang stable deck, material QA, presenter shell, and static deploy checks. Caveat: these rules apply to the rendered HTML, not to the Humanize brief.
  • ../references/beautiful-preview-first-adapter.md — Durable adapter pattern for connecting beautiful-html-templates: version boundary, template selection, real title-slide previews, manifests, QA, and pitfalls. (Historical; v0.6.4 hands template selection to the downstream skill.)
  • ../references/selected-template-full-deck-adapter.md — Durable adapter pattern for V0.4 selected-template full deck generation: required artifacts, routing, QA, and TDD coverage. (Historical.)
  • ../references/presenter-export-adapter.md — Durable adapter pattern for adding V0.5-style presenter shell and export package after a final deck exists. (Historical; v0.6.4 hands presenter/export to the downstream skill.)

Helper scripts

Positioning & packaging

  • ../references/agent-teams-public-preview.md — Agent Teams architecture, specialist-agent command protocol, public preview release loop, and README split convention. (Historical; v0.6.4 collapses the Agent Teams model into a brief + QA loop.)
  • ../references/humanize-ppt-public-writing.md — Public-facing positioning and article/script patterns: Humanize PPT as brief orchestrator, not a fixed 4-Skill bundle.
  • ../references/workbuddy-team-packaging-and-video-materials.md — WorkBuddy/CodeBuddy team upload zip structure, validation script, scenario rules shape, and the Remotion/HyperFrames-as-material-producers pitfall.

Version notes

Full version history lives upstream at https://github.com/LearnPrompt/humanize-ppt/tree/main/docs/versions — this package does not ship it.

Reference in New Issue View Git Blame Copy Permalink