用途：该资料是给 AI 生成 MoonBit 代码时使用的实践指南，目标是在编写 MoonBit 代码时避免常见错误，覆盖语法、测试与基准测试。若有不理解处，建议用 moonbit-docs 技能检索官方文档。
主要能力与约定：代码导航优先使用 moon ide 而非 Read 或 grep，例如 moon ide peek-def Parser::parse、moon ide goto-definition -tags 'pub fn' -query 'parse'、moon ide find-references parse、moon ide outline src/parser.mbt；实现前用 moon doc '<Type>' 查看 API；编辑 moon.pkg.json / moon.mod.json 前查看 reference/configuration.md；更新 CLAUDE.md 前查看 reference/agents.md。常用命令包括 moon fmt、moon info、moon test、moon test -u、moon test --filter 'glob'、moon bench、moon check。
常见语法要点：变量和函数名不用大写；mut 仅用于重新赋值，数组 push 不需要；最后一个表达式即返回值，无需 return；方法需 Type:: 前缀；不支持 ++、--，用 i = i + 1 或 i += 1；错误传播不需要 try；没有 await 关键字，用 async fn 声明；优先范围 for，如 for i in 0..<n {...}。旧语法 function_name!(...) 与 function_name(...)? 已废弃。类型参数应写在 fn 之后（fn[T] identity(...)），不再使用 -> T!Error，改用 raise 关键字；宏调用不再需要 ! 后缀。多行文本用 #|；///| 是块分隔符。快照测试中 inspect(val, content="") 可由 moon test -u 自动填充；文档测试可用 mbt test 等代码块。
适用场景与限制：适用于 MoonBit 项目的 AI 辅助编码、代码导航、测试与发布前检查（moon fmt、moon info）。pkg.generated.mbti 由 moon info 自动生成，不要直接编辑。仓库还包含 assets/ci.yaml 的 GitHub Actions 工作流。具体版本要求、收费与完整官方文档细节暂未提供。