Agent 开发入口

Norm-Skill 提供 CLI 和语言规则的任务索引。库的 Skill 必须和发布库的源码、module.norm 位于同一个仓库。通过 Registry 找到库仓库后，按仓库 Skill 发布契约读取不可变版本的 Skill。

CLI 用法以安装版 norm -h 为入口；各命令使用 norm <command> -h，重构类型使用 norm refactor name -h。帮助不会执行项目操作。

使用当前工具链支持的语言与 API。能力成熟度见 Status，工具设计原则与规划见 Agent 工具设计。Agent 模块通过 Norm 包管理器以 github:agent@1 发布和解析。

基础文件 Agent 的可执行入口见文件 Agent。它使用建立在协议层 OpenAI 模块之上的 Agent 模块，工具声明从 Norm 函数和注解派生。

学习与查询

语义查询提供项目概览、声明搜索、强引用选择与上下文。

语义重构预检提供基于文档修订的编辑预览与静态验证。

• Language Tour：连续学习与可执行例子；
• 语言参考：精确语法与语义；
• 设计原则：类型、信息和分层边界；
• 标准库：当前模块入口；
• API 文档导出：从语义模型获取公开声明与文档；
• VS Code：补全、签名、导航、引用与重命名。

类型关系优先查阅 value、class 与 ref 的语义、空值与推断、函数和错误处理。不要从其他语言推定 Norm 行为。

验证

静态检查、定向测试与机器输出见检查与测试。测试声明和关联见测试 API。项目内可执行文档例子的组织和验证命令见 Norm 测试索引。

验证结论必须说明实际执行范围。编译成功只证明静态约束，测试通过只证明被执行用例的断言；修改后需重新验证对应源码。

可复用的任务准备、独立验收与测量边界见 Agent 任务基准。