baozaotumao
39fe248f9f
- 新增 .claude/skills/new-project/SKILL.md（标准 skill 格式） - install-skill.sh 安装时组装 SKILL.md + verify.sh，单一源无重复 - verify.sh 改用索引数组替代 declare -A，兼容 macOS bash 3.2 - log_pass/log_skip 显式 return 0，避免 set -e 下非 verbose 误退出 - README 改为 skill 优先；补全 copier.yml/scripts/template 入库
41 lines
1.5 KiB
Markdown
41 lines
1.5 KiB
Markdown
# 全局约定
|
||
|
||
> 命名规范 + 禁 print/console + 注释 + 包管理概览。
|
||
|
||
## 命名规范（已定）
|
||
|
||
不是"全部 snake"：各随语言生态，边界（wire）统一为 snake。
|
||
|
||
| 范围 | 命名 | 强制 |
|
||
|------|------|------|
|
||
| Python（backend+agent） | snake_case 变量/函数、PascalCase 类、UPPER_SNAKE 常量 | ruff `N`（pep8-naming） |
|
||
| 前端 TS | camelCase 变量/函数、PascalCase 组件/类型 | eslint naming-convention |
|
||
| 通信线 JSON 契约 | snake_case | 契约源 Pydantic（snake），后端零映射 |
|
||
|
||
- Python 字段 `agent_ws_url` ↔ 环境变量 `AGENT_WS_URL` 为 pydantic-settings 默认映射，**无需 `alias_generator`**（见 `config.md`）
|
||
- 旧文档中"Python camelCase"与 `to_screaming_snake` 描述已作废，一律按上表
|
||
|
||
## 禁 print / console
|
||
|
||
- 禁止 `print()`（Python）和 `console.log()`（TS）：统一用各层 logger
|
||
- Python 用 `from loguru import logger`，禁用 stdlib `logging`
|
||
- ruff `T20`（Python）/ eslint `no-console`（TS，允许 warn/error）强制
|
||
|
||
## 注释
|
||
|
||
- 不写无意义注释；WHY 不明显时才写注释
|
||
|
||
## 其他约定
|
||
|
||
- 每次生成请求使用独立 UUID 工作目录：`~/ppt-gen/{uuid}/`
|
||
|
||
## 包管理概览
|
||
|
||
| 目录 | 工具 | 锁文件 |
|
||
|------|------|--------|
|
||
| `backend/` | uv | `uv.lock` |
|
||
| `agent/` | uv | `uv.lock` |
|
||
| `frontend/` | pnpm | `pnpm-lock.yaml` |
|
||
|
||
锁文件必须提交 git，保证环境一致性。CI 用 `--frozen`/`--frozen-lockfile` 安装。各目录详细命令见对应服务规则。
|