一、④段整套同步(用户选候选 A)
- 新增 `references/stage-proto-doc/assets/产品文档模板.html`(16 KB/247 行,从备份拷、转 LF)。
- ④段 SKILL.md 换成备份 15:28 那版,并按模板口径改齐:
· 「产品文档框架」从「四块+一附录」改成**六节** —— 页面结构/功能清单/使用场景/操作流程/
跨页与界面状态/待确认与偏离;与模板同构,⛔ 不从空白页重写结构。
· 编号从 R/S/F 改成 **P 页面/S 场景/F 功能/J 二级功能**,各自唯一、按展示顺序通排。
· 保留旧版有价值的要求:每项功能补齐 做什么/入口在哪/输入边界/异常与恢复;重点功能三处标红;
横向流程图每步写清页面/功能/操作/完成判据。
· 完成标准「七节」→「六节」,自查清单同步换掉「需求」那批条目,补模板与配图两条。
· 路径 `designs/<项目>/` → `docs/pm/<项目>/ui/`(2 处)。
· 补回本机那条「每份产出文档开头都要有一张图」的引用(指向主 skill,段内不复述)。
- 主 skill 同步:四段结构表④行、④段沿革、画图小节(④段画页面结构图 + 用户路径)。
二、open-design 移到技能根(用户选候选 A)
- `git mv product-planning/references/stage-delivery/assets/open-design → open-design/`(4178 文件)。
- `.gitignore` 白名单加 `!/open-design/` —— 否则移出去就不再纳入版本控制。
- 引用改 11 处:路径形态 `assets/open-design/...` → `<技能根>/open-design/...`;
「随段携带的自带件」改称「同根技能」;「路径怎么找」那条改成自带件(段内相对路径)与
同根技能(`<技能根>/<技能名>/`)两类分开写。
- open-design 自己的 ATTRIBUTION.md 两处同步(它现在与 oil-ui-pro 同层)。
- 副作用(有益):命名闸门读数由 2063 降到 225 —— 此前它把 open-design 里 919 个第三方 md
当成规则一起扫了;现在只扫本包 23 个 md。已确认④段的 H1 与 4a/4b/4c 子步仍在检查范围内。
三、验收
- check_naming.py --ws E:/ProgramData/AIProject/contentm_agent = 通过 225 / 失败 0 / 提示 27。
- 活文件里 `assets/open-design` 残留 0;工作区 CRLF 文件 0。
77 lines
2.7 KiB
Markdown
77 lines
2.7 KiB
Markdown
---
|
||
name: dashboard
|
||
description: |
|
||
Admin / analytics dashboard in a single HTML file. Fixed left sidebar,
|
||
top bar with user/search, main grid of KPI cards and one or two charts.
|
||
Use when the brief asks for a "dashboard", "admin", "analytics", or
|
||
"control panel" screen.
|
||
triggers:
|
||
- "dashboard"
|
||
- "admin panel"
|
||
- "analytics"
|
||
- "control panel"
|
||
- "后台"
|
||
- "管理后台"
|
||
od:
|
||
mode: prototype
|
||
platform: desktop
|
||
scenario: operations
|
||
preview:
|
||
type: html
|
||
entry: index.html
|
||
design_system:
|
||
requires: true
|
||
sections: [color, typography, layout, components]
|
||
craft:
|
||
requires: [state-coverage, accessibility-baseline, laws-of-ux]
|
||
---
|
||
|
||
# Dashboard Skill
|
||
|
||
Produce a single-screen admin / analytics dashboard.
|
||
|
||
## Workflow
|
||
|
||
1. **Read the active DESIGN.md** (injected above). Colors, typography, spacing,
|
||
component styling all come from it. Do not invent new tokens.
|
||
2. **Classify** what the dashboard monitors (sales, traffic, usage, incidents,
|
||
ops, etc.) from the brief. Generate specific, plausible metric names and
|
||
values — no "Metric A / Metric B" placeholders.
|
||
3. **Lay out** the required regions:
|
||
- **Left sidebar** (220–260px): brand mark at top, 6–8 nav links with
|
||
icons, active state uses the DS accent.
|
||
- **Top bar**: page title on the left, search input + user avatar / status
|
||
on the right.
|
||
- **Main**:
|
||
- Row 1: 3–4 KPI cards (label + big number + delta vs. prior period).
|
||
- Row 2: one primary chart (full width or 2/3) — render as an inline SVG
|
||
line / bar / area chart drawn from real-looking numbers.
|
||
- Row 3: one secondary chart or table (recent events, top items, etc.).
|
||
4. **Write** one self-contained HTML document:
|
||
- `<!doctype html>` through `</html>`, CSS in one inline `<style>` block.
|
||
- CSS Grid for the overall layout; Flexbox inside cards.
|
||
- Semantic HTML: `<aside>`, `<header>`, `<main>`, `<section>`.
|
||
- Tag each logical region with `data-od-id="slug"` for comment mode.
|
||
5. **Charts**: inline SVG only, no JS libraries. A line chart is ~10 lines of
|
||
`<polyline>` with a subtle area fill. A bar chart is N `<rect>`s with
|
||
DS-accent fill. Label axes lightly (muted text, smaller scale).
|
||
6. **Self-check**:
|
||
- Every color comes from DESIGN.md tokens.
|
||
- Accent used at most twice (sidebar active + one chart highlight).
|
||
- Sidebar + top bar are sticky; main scrolls independently.
|
||
- Density matches the DS mood — airy DSes get more padding, dense DSes
|
||
(trading, crypto) tighten rows.
|
||
|
||
## Output contract
|
||
|
||
Emit between `<artifact>` tags:
|
||
|
||
```
|
||
<artifact identifier="dashboard-slug" type="text/html" title="Dashboard Title">
|
||
<!doctype html>
|
||
<html>...</html>
|
||
</artifact>
|
||
```
|
||
|
||
One sentence before the artifact, nothing after.
|