 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 |
|