# 项目说明

本工作区由前端团队维护（由 **frontend-craft** OpenClaw 插件模板初始化）。

核心要求：

- 在调整架构前，先理解现有代码
- 优先复用，而不是重复造轮子
- 保持改动小、清晰、便于评审
- 先遵循项目标准，再考虑通用模式

## 项目基础信息

<!-- 请根据项目实际情况修改以下配置 -->

- 语言：TypeScript
- 包管理器：pnpm
- 构建工具：Vite
- 测试工具: Vitest + Testing Library
- UI 体系：优先复用现有组件库和设计 Token
- 设计实现流程：如有条件，优先使用设计工具 MCP（Figma / MasterGo / Pixso / 墨刀 / Sketch）上下文

## 常用命令

优先使用仓库现有命令，不要自行发明替代命令。

<!-- 请根据项目实际情况修改 -->

- 安装：`pnpm install`
- 开发：`pnpm dev`
- Lint：`pnpm lint`
- 类型检查：`pnpm type-check`
- 测试：`pnpm test`
- 构建：`pnpm build`

如果命令缺失，先检查 `package.json`。

## 通用工作原则

改代码前：

1. 阅读目标模块及其周边模块
2. 搜索已有可复用组件或工具函数
3. 理解当前样式和 Token 约定
4. 如果仓库里已有一套模式，不要再引入第二套

实现时：

- 保持组件职责聚焦
- 将重复逻辑提取到 hooks / composables / utils
- 优先使用明确类型
- 优先使用可推导状态，避免重复维护状态
- 除非任务明确要求破坏性变更，否则保持向后兼容

完成后：

- 执行 lint
- 如有类型检查则执行 type check
- 如有测试则执行测试
- 总结改动文件、关键决策和剩余风险

## Git 规范

- 提交前必须通过 lint 和类型检查
- 未经我确认不要直接 commit
- 分支命名: feature/xxx, fix/xxx, refactor/xxx
- Commit 格式: 遵循 Conventional Commits（详见本文件同目录 skills 下的 `git-conventions.md`）

## 设计稿实现工作流

当存在设计上下文时：

1. 先通过 MCP 读取设计上下文（Figma / MasterGo / Pixso / 墨刀 / Sketch，摹客则使用截图/标注）
2. 检查项目现有组件体系
3. 先产出简短实现计划
4. 分步骤实现
5. 执行校验命令
6. 总结偏差和风险

## 安全要求

不要主动暴露或打印任何密钥。
除非任务明确要求且权限允许，不要读取或修改敏感文件。
除非明确要求并获得批准，不要执行破坏性 shell 命令。

## 规则与扩展技能

OpenClaw 会从本工作区的 `skills/` 加载 Markdown 技能。初始化后规则文件位于：

`skills/frontend-craft-rules/`

按需阅读并在对话中引用相关片段，例如：

- `skills/frontend-craft-rules/vue.md` / `react.md` — 框架规范
- `skills/frontend-craft-rules/typescript.md` — TypeScript/JavaScript（与 `typescript-reviewer` 剧本联动）
- `skills/frontend-craft-rules/code-comments.md` — 代码注释（何时写、写什么）
- `skills/frontend-craft-rules/testing.md`、`performance.md`、`design-system.md` 等
- `skills/frontend-craft-rules/agent-workflow.md` — 子代理协作边界
- `skills/frontend-craft-rules/working-modes.md` — 调研、计划、开发、评审、收尾模式

若项目不需要某项规则，可删除对应文件或在对话中说明忽略。
