 aurora-admin
|
d88cdf2324
|
docs: 长期路线图（ROADMAP.md，12 个可执行任务包）+ 执行 P1 LICENSE
规划师角色切换后的首份交付：把规划做成可交接工件，而非聊天里的建议。
ROADMAP.md 的形态
- 每个任务包含：目标 / 依据 / 依赖 / 精确路径 / 步骤 / 验收命令 / 预期输出 /
失败判据。执行模型照做即可，不需要再问
- 附「交接约定」6 条（零依赖不可破、build-site.ps1 必须 ASCII-only、改结构要改
模板、改样式要改内嵌层、验收以实测为准、单次改动跑八次回归）
- 附「验收总纲」5 条（给完整输出、跑八次回归、CHANGELOG 条目、ROADMAP 标记、
新问题写成新任务包不顺手修）
基线全部实测（非估计）
- 资产：79 组件 / 395 端文件 / 79 契约 / 358 usageHints / 139 unknowns /
101 doNotInvent / 75 令牌 / 330 字典 / 961 断言
- 回归 100%（八次连跑一致）/ 契约保真 93.9% / 令牌语义 0 错配 / i18n 0 残留
- 性能：文档站 1247KB，其中 data.js 1058KB（85%）
- 八项缺口（G1-G8）每项附实测证据
关键诊断（在规划里就完成，避免执行模型走弯路）
- data.json 体积实测拆解：sources 字段 888KB = 89.6%。拆出后 data.js
991KB → ~110KB（−89%）。规划里的推测值已被实测替换
阶段划分与决策依据
- S1 可交付（LICENSE/npm/CI/data.js）→ S2 可信（暗色/跨端/行为断言）→
S3 完整（RTL/FAQ）→ S4 生态（Figma/模板/发布）
- 顺序依据：S1 是「能不能用」，S2 是「能不能信」，S3 是「够不够全」，
S4 是「好不好用」。颠倒会做出没人敢用的产品
顺带执行 P1（验证规划可落地）
- LICENSE：MIT 全文，README 新增许可证段与路线图链接，版本号校正为 v1.4.1
- 验收输出：LICENSE OK / README OK
- ROADMAP 对应任务包下追加完成标记（验证闭环机制可用）
回归：100%（961 断言 / 0 失败 / 79 页全通过）
|
2026-09-11 22:40:10 +08:00 |
|