aria-error-messages
aria 报错文案规范速查:写或改任何面向用户的报错文案(编译期 / 运行期 / CLI / ASSERT)时使用。含 detail 通则、句式家族要点、元数族 arity_error 唯一口、被调者泛称、ASSERT 文案规则与机械门禁 tools/check_error_messages.py 的实际覆盖面。规范本体在 .agents/reference/specs/error-messages.md。
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- aria-error-messages
- description
- aria 报错文案规范速查:写或改任何面向用户的报错文案(编译期 / 运行期 / CLI / ASSERT)时使用。含 detail 通则、句式家族要点、元数族 arity_error 唯一口、被调者泛称、ASSERT 文案规则与机械门禁 tools/check_error_messages.py 的实际覆盖面。规范本体在 .agents/reference/specs/error-messages.md。
03 SKILL.md 正文
aria 报错文案速查
场景:新增或修改报错点、写 ASSERT 文案、被机械门禁打回。通则与句式家族全文见
.agents/reference/specs/error-messages.md(这里只留落笔判据,冲突时以本体为准);四条错误通道的归属见.agents/reference/error.md。
1. 硬规则
- 英文 ASCII-only:禁 CJK、禁全角标点。门禁扫的是
src/下全部字符串字面量,不限报错点--加一个合法的非 ASCII 字面量也会被打回。 - 小写起首、无句尾标点:detail 紧跟
Code之后;以{}占位或类型名开头的天然符合。 - 消息壳
Code由 X-Macro#派生(src/error/ErrorCode.hpp),Category来自手写kCategoryNames(六项含Ok);两者都不另加中文名表,故 detail 一律英文。
2. 门禁的真实覆盖面(tools/check_error_messages.py)
只查三类:① 所有字面量的非 ASCII 字符;② 报错入口的每行首个字面量--不以 . 结尾(!/? 不拦)、首字母小写;③ ASSERT 文案不带 Class::method: 这类实体身份前缀。
它查不到:消息壳是否真的由 X-Macro 派生;std::format 中转后再交给 Error::from_detail 的文案(入口与字面量不在同一调用链就漏检);同一行第二个字面量的形状;非 src/ 的文案(docs/guide/17-builtin-reference.md 逐字引用真实消息、语料 .err 也是逐字引用,改文案要手工同步)。
钩子是本地配置:git config core.hooksPath tools/hooks 才生效(tools/hooks/pre-commit)。没配时只有手跑 python3 tools/check_error_messages.py 才能兜住;脚本无参数时缺省扫 src/。
3. 高频句式族(完整家族表见本体)
| 语义 | 唯一形状 |
|---|---|
| 语法期望 | expected <what>, got <spelling|end of file> |
| 元数 | function expects <spec>, got <n> |
| 类型 | <what> must be <T>, got <actual> |
| 越界 | <what> <value|range> out of range |
| 空容器 | <what> from empty <container> |
| 缺键 | map key not found: <value> |
| 成员缺失 | <recv repr> has no member '<name>' |
| 协议不支持 | type <T> does not support <op> |
- 元数族唯一口 =
AriaExeContext::arity_error(三口:精确数 / 闭区间 / 仅下界,真身不在AriaVM)。调用点只给数量,不得手写格式串;被调者一律泛称function,不收名字。 - 类型族同理不带被调者名:
<what>用泛称argument,不写Coroutine.create一类全名。 - 算子钩子缺失不走协议族:
x.__add__的 miss 是普通成员缺失(<recv repr> has no member '__add__');type <T> does not support <op>只用于'__call__'、'__str__'与 field/subscript access。
4. ASSERT / static_assert 文案
ASSERT宏已打[file:line] Assert failed in <func>(),断言文案不写封闭实体身份(Class::method:前缀是重复);主语可用被检查的类型/量名。static_assert不给函数名,类型/组件名可作主语(InternPool: Alloc must satisfy TrivialAllocator)。- 两者的 ASCII-only 约束同 §1。
5. 位置与通道归属
- 编译期错误:位置
path:line:col:前缀由 Lexer/Parser/CodeGen 烘进消息;detail 本身不带位置。 - 运行期错误:实体是
ObjException(携码 + 烘焙消息、不含位置),位置由未捕获出口的逐帧at <fn> (<mod>:line)行给出;运行期报错点不就地构造Error。
04 同仓库更多 Skills
aria-testing
写 aria 的 C++ GTest 用例或语言语料时使用。核对 CMake 登记、语料位置、期望文件与双配置验收;运行命令见 docs/testing.md,语料判定规则见 tests/language/README.md。
aria-language-change
aria 语言面改动同步清单:改文法(docs/grammar.txt)、词法、语义或新增语言特性时使用。列出全部同步义务面:Parser/CodeGen 实现、tests/language 语料正负向、docs/guide 教程章节、README 特性表、.agents/reference 模块参考,及双配置全量验证要求。
aria-commit
暂无简介
aria-bytecode-change
加或改一条字节码指令(OpCode)时使用。列出完整同步面:code.hpp X 表追加与枚举序、dispatch_loop 的 case(漏 case 是运行期 fatal)、opcode_profile 的平行 switch 与 size_of/records_fall_pair、反汇编渲染与 kOpCodeCount 哨兵、CodeGen/CodeUnit 发射侧、instruction-set.md 与 lowering.md、语料与画像。
aria-bench
aria 性能测量纪律:跑基准、做 A/B 对比、写性能报告时使用。含三层分工(bench/lang 进程级墙钟与跨语言对照、lexer/vm/hashtable 进程内微基准、bench/profile 指令频度画像)、各自的构建配方与目录、A/B 对照方法与报告规范、构建旗(ARIA_USE_TAGVALUE / ARIA_USE_MIMALLOC / ARIA_OPCODE_PROFILE)。
aria-add-builtin
给 aria 加内建方法、静态原语或新内建类时使用。列出完整同步面:方法体与方法表、make_class 注册口(实例方法 vs 不绑定的静态原语)、receiver<T> 与 obj_tag 守卫、arity_error 元数口、返回值写槽与 GC 根、语料与文档(含 docs/guide/17-builtin-reference.md)。