wehub-skill-sync
4.2 KiB
4.2 KiB
发布前检查清单（P0 必须通过；在全部绿灯前不得生成 index.html）
请在回复中逐条引用每个 P0 项，并在前方标注 [x] 或 [ ]。有任何 P0 项未勾选时，不得发布。
视觉完整性
- P0 — 显示字体。页面标题使用系统 / 偏 Notion 风格的无衬线字体（SF Pro / system-ui），或来自当前 DESIGN.md 中的编辑型衬线字体。禁止使用 Inter Display，禁止在正文尺寸使用 SF Pro Display，禁止使用 Helvetica condensed。
- P0 — 强调色克制。
--accent令牌在正文标记中最多出现两次（典型用法为一个刷新按钮 + 一条迷你趋势线）。KPI 数字上不得使用强调色。 - P0 — 无紫/粉渐变页头。Notion 的惯用风格为纯色。背景使用
#fff或var(--bg-soft)。 - P0 — 正文对比度。正文文本与背景的对比度 ≥ 4.5:1。次要文本 ≥ 4.0:1。
- P0 — 顶部无 emoji 图标条。页面 emoji 只有一个，且语义明确（运营用
📊，文档用📓，上线用🚀——禁止出现 emoji 装饰行）。
数据真实性（最常违反的规则）
- P0 — 无虚构指标。每个数字要么由用户提供，要么由数据连接器提供，要么标注为
—/Sample。禁止出现以下内容："10× faster"、"join 50,000 founders"、"99.99% uptime"，除非用户提供了确切的数字。 - P0 — 示例数据标识。当
inputs.connector === mock时，页面必须在实时指示器或提示框中显示"Sample data"，以确保该产物的截图永远不会被误认为真实运营数据。 - P0 — 合理的 KPI 范围。小型团队的
Total tasks< 500。Active members≤ 团队人数。Done this week≤ Total。
连接器接线（仅当 connector !== mock 时适用）
- P0 —
connectors.json存在于项目根目录。详见connectors.md中的 schema 说明。 - P0 — 端点已文档化。
index.html中的每个fetch()调用均对应connectors.json中的一条记录。 - P0 — 无硬编码密钥。标记中不得包含 API 令牌、集成密钥、OAuth 客户端 ID 或工作区 ID。OD 守护进程通过
media-config.json解析这些信息。 - P0 — 过期降级。当
fetch出错或超过 90 秒无成功轮询时，指示器切换为琥珀色，页面上保留上一次的值。产物不得显示空白。
结构
- P0 — 单文件。
index.html自包含。除系统字体栈和一个 OD 自定义元素外，不得引入外部 CSS/JS。无 CDN 链接。 - P0 — 侧边栏在
< 980px时折叠。仪表板可在移动端阅读；侧边栏隐藏，KPI 网格两列堆叠，表格隐藏due和priority列。 - P0 —
prefers-reduced-motion。当(prefers-reduced-motion: reduce)生效时，所有动画和脉冲效果均被禁用。 - P0 — KPI 数值使用
tabular-nums。数值在动画或自动刷新过程中不应水平抖动。
精细打磨（P1）
- P1 — 刷新按钮在轮询期间显示旋转的 ↻ 图标，轮询结束后恢复静止。不得产生布局偏移。
- P1 — 活动动态：新插入的行在左侧显示强调色圆点（•），并带有柔和的强调色背景，持续 2 秒后淡出。
- P1 — 数据库中被修改的行，其背景以 1.4 秒的 ease-out 渐变闪烁。
- P1 — 实时指示器状态：绿色脉冲（空闲）、蓝色实心（同步中）、琥珀色实心（过期）。
- P1 — 迷你趋势图的网格线为虚线，线条颜色来自
--line，stroke-dasharray为2 3。数据点为填充色--accent，半径 r=3。 - P1 — 提示消息位于底部居中，深色
#1f1f1f，1800 毫秒自动消失。
内容
- P1 — 人员头像：18px 圆形头像，两字母首字母缩写，每人有固定的颜色。首字母不超过 2 个字符。
- P1 — 状态标签文字使用 Notion 标准标签："Done"、"In progress"、"Blocked"、"In review"、"To do"。大小写需注意："In progress" 而非 "In-Progress"。
- P1 — 页脚署名需精确标明来源平台及连接器 slug：
composio.notion、composio.linear等。