菜单
Add a new plot/chart type to RING-5 (subclass BasePlot, emit engine-agnostic traces, register in PlotFactory, wire config UI, test). Use when the user asks to add or modify a visualization/chart/plot type.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Add a new data-transformation shaper to RING-5's pipeline (subclass Shaper, add a discriminated-union TypedDict config, register in ShaperFactory with a camelCase key, add the UI config). Use when the user wants a new transform/shaper/pipeline step.
Gate the ApplicationAPI facade contract — the single Web→Core entry point, its three sub-APIs, and the async parse/scan protocol. Use when verifying API usage, reviewing facade/service changes, or checking that the UI talks to core only through the facade.
Gate the RING-5 architecture — the 7 hard rules and the strict 3-layer dependency direction (Web → Core ← Parsing). Use before merging, after any structural/refactor change, or when asked to "check architecture", "run the arch gate", or verify layer boundaries.
Sweep code and docs for dead, duplicated, or stale paths/symbols and remove them — repoint drifted paths, delete docs for removed subsystems, and enforce canon-only docs (no "was X, now Y" history). Use when asked to clean up stale references, dead paths, doc debt, or legacy shims/aliases.
Write or debug RING-5's Streamlit UI tests — the no-browser AppTest/ui_logic/ui_unit layers and the Playwright browser e2e/visual suite (Page Object Model, data-testid selectors, and Streamlit-specific gotchas). Use for any UI test, Playwright, AppTest, screenshot, or flaky-UI-test task.
Gate the gem5 parsing/scanning subsystem for correctness — no data fabrication, async-only API, the StatType lifecycle invariant, Perl regex duplication, and worker-pool lifecycle. Use to verify parser/scanner/Perl/stat-type changes before merging (complements the parsing-and-variable-types build skill).
| name | add-plot-type |
| description | Add a new plot/chart type to RING-5 (subclass BasePlot, emit engine-agnostic traces, register in PlotFactory, wire config UI, test). Use when the user asks to add or modify a visualization/chart/plot type. |
Plots are engine-agnostic: a plot builds TraceConfig objects (a TraceBuildResult), and the
rendering layer converts those to Plotly or Matplotlib. You almost never touch Plotly/Matplotlib
directly when adding a plot type.
Best starting move: copy the nearest existing type in
src/web/pages/ui/plotting/types/ (e.g. bar_plot.py for a simple one, stacked_bar_plot.py /
grouped_stacked_bar_plot.py for composites) and adapt. grouped_stacked_bar shows the
"extend another plot type" pattern (GroupedStackedBarPlot(StackedBarPlot)).
Create the class — src/web/pages/ui/plotting/types/<name>_plot.py:
from src.web.pages.ui.plotting.base_plot import BasePlot
# ... TraceBuildResult / TraceConfig imports from src.core.models.visualization
class MyPlot(BasePlot):
def __init__(self, plot_id: int, name: str) -> None:
self.plot_type = "my_plot" # set BEFORE super().__init__
super().__init__(plot_id, name)
def create_traces(self, data: pd.DataFrame, config: PlotConfig) -> TraceBuildResult:
# build TraceConfig objects from data + config; return TraceBuildResult
...
def get_legend_column(self, config: PlotConfig) -> str | None:
# which column groups traces into legend entries (color/group col), or None
...
create_figure() is provided by BasePlot (delegates to create_traces + trace_to_plotly);
only override it if you genuinely need to.
Export the class from src/web/pages/ui/plotting/types/__init__.py.
Register in src/web/pages/ui/plotting/plot_factory.py:
PlotFactory._plot_classes with a snake_case key (e.g. "my_plot");_plot_metadata (display_name, icon, category ∈
basic|comparison|distribution).Config UI (only if the plot needs options beyond the shared X/Y/color selectors):
add a component under src/web/components/plotting/config/ and wire it through
plot_config_ui.py / the PlotConfigUIMixin. Reuse helpers in config/base_plot_config.py
(detect_column_types, render_xy_selectors, …). Keep widget keys per-plot-unique:
f"{prefix}_{field}_{plot_id}".
Serialization is automatic via BasePlot.to_dict/from_dict + PlotFactory — make sure any
new state is plain/JSON-serializable so portfolios round-trip.
Tests:
tests/unit/ — exercise create_traces/create_figure with sample_data
(root conftest fixture) for the new type;tests/integration/ for the full render path if non-trivial;mypy/black/flake8 clean.TraceConfig, never call go.*/plt.* inside the plot class.FigureConfig + the connectors
(see the rendering-figureconfig skill).wong (colorblind-safe). Error-bar columns use the {y}.sd suffix.make arch-check && ./python_venv/bin/mypy src/ && make test-unit.