feat: 重组为标准 skill 包结构 + 修复 verify.sh bash 3.2 兼容

- 新增 .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 入库
This commit is contained in:
baozaotumao
2026-06-01 21:19:45 -07:00
parent 167fa10dde
commit 39fe248f9f
53 changed files with 3744 additions and 55 deletions
+40
View File
@@ -0,0 +1,40 @@
# 全局约定
> 命名规范 + 禁 print/console + 注释 + 包管理概览。
## 命名规范(已定)
不是"全部 snake":各随语言生态,边界(wire)统一为 snake。
| 范围 | 命名 | 强制 |
|------|------|------|
| Pythonbackend+agent | snake_case 变量/函数、PascalCase 类、UPPER_SNAKE 常量 | ruff `N`pep8-naming |
| 前端 TS | camelCase 变量/函数、PascalCase 组件/类型 | eslint naming-convention |
| 通信线 JSON 契约 | snake_case | 契约源 Pydanticsnake),后端零映射 |
- 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` 安装。各目录详细命令见对应服务规则。