aurora-admin

12 Commits 2 Branches 0 Tags

2 Commits

Include renames

Author	SHA1	Message	Date
aurora-admin	dd1e306c86	docs: AGENTS.md 执行约定 + 补全 ROADMAP 的结构性缺口补三处规划漏洞（自查发现，非用户指出） 1) 缺「执行模型自动能读到的约束」 - 新建 AGENTS.md（216 行）：其他模型不会主动翻 ROADMAP，但大多会自动读 AGENTS.md。把它做成硬约束入口 - 含六条铁律（零依赖/ASCII-only/改模板/改内嵌层/data.json 是承诺/八次回归） - 含禁止事项表（6 条）、交付说明模板、失败升级路径、关键文件地图、已知陷阱速查（7 条）、当前状态 - 验证过文档里承诺的命令真能跑：铁律 1 的验收命令在 package.json 不存在时输出 "n/a" 而非报错（原写法会失败） 2) 缺「显式不做」清单 - 新增第四章：8 项不做什么及理由（不引打包器/不做全量像素回归/不做 SSR/ 不做主题商店/不重写 app.js/不改 frameworks 视觉/不做 Storybook/不做单测） - 没有这份清单，执行模型会以为"漏了"，或在不当时机自作主张 3) 缺「未解问题」 - 新增第五章：6 个我无法单方面决策的问题（是否发布 npm/目标用户/设计团队协作/RTL 必要性/性能预算底线/暗色 iframe 策略），每项附影响面与建议修正验收命令的 3 处踩坑（自查发现） - P2 的 npm pack 校验：原写法 `npm pack \| grep -q site/ && echo FAIL \|\| echo OK` 在 npm 不可用时 grep 也失败 → 误报 OK。改为显式判断 exit code - P4 的 sources 文件计数：目录不存在时错误信息不友好 → 加提示与 exit 1 - 铁律 1 的依赖检查：package.json 不存在时报错 → 改为可容错章节编号顺延（原「五、验收总纲」→「七」，因新增两章）回归：100%（961 断言 / 0 失败 / 79 页全通过）	2026-09-11 22:47:51 +08:00
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

Author

SHA1

Message

Date

aurora-admin

dd1e306c86

docs: AGENTS.md 执行约定 + 补全 ROADMAP 的结构性缺口

补三处规划漏洞（自查发现，非用户指出）

1) 缺「执行模型自动能读到的约束」
- 新建 AGENTS.md（216 行）：其他模型不会主动翻 ROADMAP，但大多会自动读
  AGENTS.md。把它做成硬约束入口
- 含六条铁律（零依赖/ASCII-only/改模板/改内嵌层/data.json 是承诺/八次回归）
- 含禁止事项表（6 条）、交付说明模板、失败升级路径、关键文件地图、
  已知陷阱速查（7 条）、当前状态
- 验证过文档里承诺的命令真能跑：铁律 1 的验收命令在 package.json 不存在时
  输出 "n/a" 而非报错（原写法会失败）

2) 缺「显式不做」清单
- 新增第四章：8 项不做什么及理由（不引打包器/不做全量像素回归/不做 SSR/
  不做主题商店/不重写 app.js/不改 frameworks 视觉/不做 Storybook/不做单测）
- 没有这份清单，执行模型会以为"漏了"，或在不当时机自作主张

3) 缺「未解问题」
- 新增第五章：6 个我无法单方面决策的问题（是否发布 npm/目标用户/设计团队
  协作/RTL 必要性/性能预算底线/暗色 iframe 策略），每项附影响面与建议

修正验收命令的 3 处踩坑（自查发现）
- P2 的 npm pack 校验：原写法 `npm pack | grep -q site/ && echo FAIL || echo OK`
  在 npm 不可用时 grep 也失败 → 误报 OK。改为显式判断 exit code
- P4 的 sources 文件计数：目录不存在时错误信息不友好 → 加提示与 exit 1
- 铁律 1 的依赖检查：package.json 不存在时报错 → 改为可容错

章节编号顺延（原「五、验收总纲」→「七」，因新增两章）

回归：100%（961 断言 / 0 失败 / 79 页全通过）

2026-09-11 22:47:51 +08:00

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