aria-language-change
aria 语言面改动同步清单:改文法(docs/grammar.txt)、词法、语义或新增语言特性时使用。列出全部同步义务面:Parser/CodeGen 实现、tests/language 语料正负向、docs/guide 教程章节、README 特性表、.agents/reference 模块参考,及双配置全量验证要求。
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- aria-language-change
- description
- aria 语言面改动同步清单:改文法(docs/grammar.txt)、词法、语义或新增语言特性时使用。列出全部同步义务面:Parser/CodeGen 实现、tests/language 语料正负向、docs/guide 教程章节、README 特性表、.agents/reference 模块参考,及双配置全量验证要求。
03 SKILL.md 正文
aria 语言面改动同步清单
场景:动语言面(新语法 / 新语义 / 行为变更 / 报错变更)时逐项过本清单。 语言面的单一事实源是
docs/grammar.txt;教程是可执行验收面,语料是行为安全网, 三者与实现同步走,缺一即回炉。
1. 同步义务面(按序过)
| # | 面 | 位置 | 义务 |
|---|---|---|---|
| 1 | 文法 | docs/grammar.txt |
产生式与实现保持一致;单点特判挂文末「说明」区的「上下文消歧」列表,不为 parser 特判立非终结符 |
| 2 | 实现 | src/compile/(Lexer / Parser / CodeGen) |
词法 token、产生式、语义检查、字节码发射;报错文案走句式家族(技能 aria-error-messages) |
| 3 | 语料 | tests/language/ |
正向脚本 assert 收口钉住新语义;行为报错变更同步负向用例与 .err 子串;显示/输出语义变更要重生成受影响的 .out golden(人工核对后冻结) |
| 4 | 教程 | docs/guide/ 对应章 |
示例实跑验证(教程只写已落地特性,报错展示真实输出);必要时更新章首目录与 17-builtin-reference.md |
| 5 | 特性表 | README.md「语言特性」节 |
新特性 / 行为变更须反映在读者面清单 |
| 6 | 模块参考与规格 | .agents/reference/ |
模块参考随代码同批更新;新增/改动指令还要同步 reference/specs/instruction-set.md 与 lowering.md |
2. 验证要求
- 按测试文档完成默认与 TagValue 的全量验证(含语料);新增语料先单点验证。
- 报错文案变更跑
python3 tools/check_error_messages.py,并手工同步docs/guide/17-builtin-reference.md「常见错误消息速查」里逐字引用的消息(门禁只扫src/)。
3. 常见走偏
- 只改实现不改文法 / 只改文法不改语料 = 验收面缺口(三者都是验收面,缺一项即未完成)。
- 按语料规则编写用例。特性落地时同步删掉该 README「当前禁区」中已失效的条目。
- 教程面:map 顺序未规定,示例一律先 sort 再输出。
- 语义决策(拍板点)记入
.agents/reference/或.agents/notes/的对应文档, 不散落在 commit 说明或会话里。
04 同仓库更多 Skills
aria-testing
写 aria 的 C++ GTest 用例或语言语料时使用。核对 CMake 登记、语料位置、期望文件与双配置验收;运行命令见 docs/testing.md,语料判定规则见 tests/language/README.md。
aria-error-messages
aria 报错文案规范速查:写或改任何面向用户的报错文案(编译期 / 运行期 / CLI / ASSERT)时使用。含 detail 通则、句式家族要点、元数族 arity_error 唯一口、被调者泛称、ASSERT 文案规则与机械门禁 tools/check_error_messages.py 的实际覆盖面。规范本体在 .agents/reference/specs/error-messages.md。
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)。