— AI Agent 上下文 > 本文件遵循 [AGENTS.md 开放规范](https://agents.md/),供 Claude Code、Qwen Code、Cursor、Copilot 等 AI 工具读取。 > 由炼境接入包分发。请按项目实际补全下方 TODO 段落。 ## 项目概况 ## 核心开发约束 ### 包管理 - **pnpm 唯一**:禁止 npm / yarn / npx / bun - lock 文件只有 `pnpm-lock.yaml`,不生成其他 ### 代码规范 - TypeScript 优先,避免 `any` - 函数/变量 camelCase;组件 PascalCase - 异步统一 `async/await`,不用裸 Promise 链 - 错误处理明确 `try/catch`,不吞异常 - 优先编辑现有文件,避免创建不必要的新文件 ## Git 工作流 见 `docs/ai-context/git-workflow.md`(分支策略 + Conventional Commits + PR 规范)。 **commit 必须符合 Conventional Commits**(lefthook 强制),炼境据此采集飞轮数据。 ## 架构与模块 ## 多 AI CLI 协作 本项目可由多个 AI CLI 协同。交接时把结果总结成 3 条传给下一个: ``` 1. 已完成:<改了哪些文件 + 核心决策> 2. 待验证:<需要确认的地方> 3. 约束继承:<影响后续的关键限制> ``` ## 关键文档索引