科研 Skill
硬件设计评审演示制作
product-presentation
Builds a hardware project’s final design-review deck as one HTML file plus PDF, covering renders, cost, and certifications, with a layout check. Use for the final pitch.
SKILL.md
Product presentation
This skill turns the project workspace into a deck that a founder, a manufacturer or an investor can read in ten minutes. Every slide comes from a file another skill produced. The deck adds no fact, no claim and no art of its own.
Talk to the user in their language. The deck itself stays in the language of hw/brief.md. Set "lang" in deck.json when it is not English.
Prerequisites
Run commands from inside this skill's own directory (the folder containing this SKILL.md), since script and reference paths below (such as scripts/foo.py) are written relative to it, not to the project root.
Inputs
The builder reads only what exists. A missing input removes its slide and adds a row to a final "Not produced yet" slide, which names the skill that produces it. It never draws placeholder art. The exact formats are in references/input-contract.md.
| Slide | File | Producer |
|---|---|---|
| Cover, idea, use, key numbers | hw/brief.md | product-discovery |
| Renders, one per slide | hw/renders/hero.png, desk.png, hand.png, dark.png, exploded.png, lineup.png (any other name follows, sorted by name), plus captions.json | product-render |
| Blueprint | hw/drawings/blueprint.svg (SVG preferred over PNG), plus captions.json | technical-drawing |
| What is inside | hw/architecture.svg, or a Mermaid flowchart in hw/architecture.md (the builder draws it) | specs-engineer |
| Components | hw/bom.csv (CONVENTIONS.md §5) | specs-engineer, electronics-researcher |
| Battery life | hw/power/budget.json (output of power_budget.py -o) | battery-and-power |
| Ready to build, open findings | hw/doability/score.json (canonical verdict, key overall; output of doability_score.py --json) and hw/doability/findings.json (findings) | doability-review |
| Build package checklist | hw/release/<rev>/checks/release-check.json (output of release_check.py), latest release | build-package |
| Cost per unit, one-time costs | hw/cost/model.json (output of cost_model.py) | cost-and-sourcing |
| Certifications | hw/compliance/matrix.md (output of compliance_matrix.py), else hw/compliance.md | compliance-planner |
| Roadmap | hw/roadmap/schedule.md (output of roadmap.py --md), else hw/roadmap/timeline.svg, else hw/roadmap.md | prototype-roadmap |
| Next steps | the "Must be measured or quoted" list in hw/doability/review.md, or next_steps in deck.json | doability-review |
| Overrides | hw/presentation/deck.json (templates/deck.example.json) | this skill |
A real render (hero.png) replaces an SVG of the same name. Captions are keyed by file stem ("hero"), so they survive the swap.
Outputs
hw/presentation/index.html: self-contained. Images are inlined below 25 MB in total (--inline-limit). Above that, they are copied tohw/presentation/assets/.hw/presentation/presentation.pdfwith--pdf: one 1600 × 900 page per slide, printed by headless Chrome, Chromium or Edge.hw/presentation/layout-check/:findings.jsonand screenshots of the slides that fail.
Gate
The deck is done when all of these are true:
layout_checkpasses at 1440, 1280, 1024, 768 and 390 px, in light and dark. It finds no overflow, overlap, crowding, edge or spill.build_presentation.pyruns it automatically when a browser is available and exits with code 4 on any finding.--check(the chart geometry check) reports no problem.- You have looked at every screenshot yourself.
- Every number on a slide carries its evidence tag, or comes from a file whose evidence the "How to read the numbers" slide explains.
Method
-
Make sure the producing skills have run, then run the builder:
python3 scripts/build_presentation.py hw --check --pdf -
Read the summary line.
missing inputslists the slides that are absent. Decide with the user whether to produce them now or to ship the deck with the "Not produced yet" slide. -
Look at the screenshots. Run
python3 scripts/layout_check.py hw/presentation/index.html --shots allto get every slide at 1440 px. Fix each finding at its source:- a style or chart issue: in this skill's builder;
- a too-long text: in the producing file, by shortening the caption or splitting the table.
Never hide a finding with CSS. Rerun until the gate passes.
-
Order and trim with
deck.jsonwhen the audience needs it. An investor deck can skipnreandcompliance. A manufacturer deck keeps them. -
Present the result in a few sentences: what the deck shows, the ready-to-build status, and what is "not produced yet".
Writing on slides
- One idea per slide. The title states the conclusion, for example "Baseline lasts 13–15 months on a 225 mAh cell". It is not a topic like "Battery".
- Experience before specification. Write "15 months on one coin cell" before "18 µA average". The data stays one level below.
- Say it once. No eyebrow labels, taglines or summary paragraphs that repeat the title. A caption adds a fact or is left out.
- Never invent. Do not add highlights, quotes, metrics or claims that are not in the workspace. Text that a user wrote is quoted as written.
- Be honest about status. Show the maturity on the cover. Estimates carry
est.. Missing parts appear on "Not produced yet". Never use a stock photo or placeholder art for the product.
Taste and pitfalls
- Charts follow the dataviz rules:
- one axis and one unit, picked from the data;
- round ticks such as 0, 6, 12, 18 months;
- thin bars with 4 px ends;
- the value at the tip, and solid hairline gridlines;
- a dashed target line, labelled above the plot area;
- emphasis by color (meets the target, or below it) with a legend. Labels never touch a line: the builder measures them and moves them past the target, or inside the bar, or onto a halo in the page color.
- Chart colors were validated with the dataviz palette validator:
#E8590Con light and#E8661Con dark, for single-series marks. Status colors (green, amber, red) always come with an icon and a label. - Stat tiles fit to width. The number shrinks down to a floor, then the unit wraps onto its own line, smaller and lighter. The evidence pill stays with the last word of its label.
- Tables stack into cards below 900 px. Every cell carries its header as a label. Numbers use tabular figures and align right.
- Images:
- render slides show the whole image (
object-fit: contain), never cropped; - a file name with
dark,nightorledgets a dark slide; - drawings sit on white.
- render slides show the whole image (
- Ready-to-build slide:
- the headline is the overall status: "Ready to build · prototype", "Ready to build · production" or "Not ready to build";
- under it: GO, FIX or BLOCKED per area, and the build package checklist;
- then "Verify on the prototype" when the design is ready, or the blockers with their exact actions when it is not. The score, if any, stays small.
- Print:
@pageis 1600 × 900 px with one slide per page. The theme button and tooltips are hidden. Print uses the light theme unless--theme darkis set.
Files
scripts/build_presentation.py: the builder. It uses the standard library only.--helplists the options.scripts/layout_check.py: the browser layout lint. It also runs on its own.references/input-contract.md: every input path, the fields read from it and the fallbacks.templates/deck.example.json: overrides for slide order, hero, highlights, captions, theme and next steps.
示例提示词
帮我把这个硬件项目做成一份完整的设计评审演示文件。
所属插件
安装该插件会一并获得同领域的 63 个 Skill / MCP。
同插件的其他科研 Skill
- ANDES电力系统动态仿真Runs ANDES power-system dynamic studies via PowerMCP: power flow, eigenvalue analysis, and time-domain simulation. Use for damping, stability, or oscillation-mode questions.
- 电池选型与电源预算Builds an evidence-tagged power budget and sizes a manufacturable battery with pouch outline, seals, and derating. Use when sizing runtime, mAh, charging, or supply rails.
- FPGA比特流生成与烧录Generates a Xilinx FPGA bitstream and programs it over JTAG, or burns an MCS image into flash for power-on boot. Use when flashing a board or diagnosing boot failures.
- 硬件项目发布包组装Assembles a hardware release package (fab files, BOM/CPL, carts, assembly guide, hashed manifest) and runs a ready-to-build gate. Use before ordering prototypes.
- 时钟域交叉风险审查Audits clock-domain-crossing risk on an FPGA design and applies the smallest safe synchronizer or constraint fix. Use to resolve CDC violations before sign-off.
- 硬件产品认证合规规划Plans certifications a hardware product needs per target market (FCC, CE/RED, UKCA, battery/radio rules), with cost and lead-time estimates. Use before PCB or enclosure tooling.
- Vivado XDC时序约束编写Authors a Vivado XDC timing constraint set from scratch: clocks, I/O delays, and timing exceptions. Use first, before timing closure, on a design with no or incomplete constraints.
- N-1/N-2应急违规处置Playbook for N-1/N-2 contingency violations: ranks contingencies and proposes preventive and corrective actions. Use after a study shows voltage or thermal problems.
- 潮流计算不收敛诊断Playbook for power-flow convergence failures in PSS/E, PSLF, PowerWorld, pandapower, PyPSA, surge, or OpenDSS. Use when a case diverges or fails to solve.
- 硬件成本核算与采购Prices a hardware product at multiple volumes with one-time vs per-unit cost, landed cost per country, and sourcing leads. Use to estimate unit cost before a pitch.
- RTL仿真覆盖率收敛Measures RTL simulation code coverage and iteratively closes it toward a target by adding testbench stimulus. Use for a sign-off-grade coverage report.
- 配电网DER接纳能力治理Playbook for distribution DER hosting-capacity limits: voltage rise, reverse flow, and thermal limits from PV and storage. Use to estimate how much DER a feeder can host.
- 电子电路设计与审查Designs, audits, or corrects an electronic circuit from a brief, schematic, or netlist, checking power domains, reset sequencing, and ratings. Use for circuit review.
- 硬件可制造性红队审查Red-team audit that fix-loops a hardware project to ready-to-build, re-deriving parts, rails, battery physics, and cost. Use for a reality check before committing to a design.
- 电力系统动态稳定处置Playbook for dynamic stability problems: poor damping, angle instability, or sustained oscillations from eigenvalue or time-domain studies. Use after an unstable study result.
- Egret电力市场调度优化Runs Egret market/operations optimization (DC-OPF, AC-OPF, unit commitment) via PowerMCP. Use for cheapest dispatch, unit commitment, or congestion checks.
- 电子元器件选型核查Researches electronic components against primary sources: part numbers, datasheet limits, lifecycle, stock, and price breaks, one dossier per part. Use to verify or source a BOM.
- EMC电磁兼容预测试Plans grounding, shielding, and filtering for EMC/EMI, and runs an emissions pre-scan with a root-cause fix sequence. Use before a lab test or after a failed EMI scan.
- 产品外壳参数化建模Designs a hardware enclosure as parametric CAD with STEP/STL/GLB output, a DFM check, and Blender assembly validation. Use when designing a case or checking fit.
- 电网频率响应问题处置Playbook for frequency problems: low inertia, high RoCoF, weak primary response, or UFLS risk after loss of the largest unit. Use when a study flags frequency issues.
- FPGA RTL到比特流全流程Drives a Xilinx FPGA design end to end through RTL, simulation, synthesis, implementation, and bitstream, gated at every stage. Use to run the complete build flow in one pass.
- 硬件产品全流程总协调Leads a physical electronic product from idea to a doable design, coordinating specs, parts, battery, PCB, enclosure, render, and cost sub-skills. Use starting a hardware product.
- 硬件原理图与BOM审查Reviews hardware projects: checks schematics against datasheets, pin connections, and firmware-to-hardware alignment across KiCad/Altium files. Use for a design alignment check.
- FPGA ILA在线逻辑调试Inserts an Integrated Logic Analyzer, programs the board, arms a trigger, and reads captured waveforms on real FPGA hardware. Use when sim passes but the board fails.
常见问题
硬件设计评审演示制作能做什么?
Builds a hardware project’s final design-review deck as one HTML file plus PDF, covering renders, cost, and certifications, with a layout check. Use for the final pitch。
如何安装硬件设计评审演示制作?
在科搭 Codar 左侧点击「插件」,在「组件」页签搜索「硬件设计评审演示制作」并安装;在 Claude Code 或 Codex 中可以发送本页的安装提示词,或下载 Skill 包后解压到 ~/.claude/skills 或 ~/.codex/skills。
硬件设计评审演示制作需要哪些权限?
该科研 Skill没有声明额外权限;执行具体操作时仍由 Agent 按自身规则请求确认。
硬件设计评审演示制作经过官方审核吗?
是。SpeedSkills 收录的每个版本都会记录内容摘要与权限声明,当前版本已通过安全审核。