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:
@@ -0,0 +1,19 @@
|
||||
---
|
||||
paths: ["backend/**", "agent/**", "frontend/**"]
|
||||
---
|
||||
|
||||
# 可观测性
|
||||
|
||||
> correlation_id 全链路 + 结构化日志 + 健康探针。
|
||||
|
||||
- **correlation_id 贯穿全链路**:前端生成 → WS header/首帧带上 → Backend(作 request_id)→ Agent(随 session_id 一起进日志)。三层日志可用同一 id 串联检索。
|
||||
- **结构化日志**:JSON 每行一条(见各服务 logging 章节)
|
||||
|
||||
| 层 | 文件 | 格式 |
|
||||
|----|------|------|
|
||||
| Backend | `~/ppt-gen/logs/backend.log` | JSON,每行一条,含 request_id |
|
||||
| Agent | `~/ppt-gen/logs/agent.log` | JSON,每行一条,含 session_id |
|
||||
| Frontend | console(dev)/ 可接 Sentry(prod) | 结构化对象 |
|
||||
|
||||
- **探针**:每个服务暴露 `GET /health`(存活)与 `GET /ready`(依赖就绪,如 Agent 检查 skill 已装、Chromium 可启动)
|
||||
- 禁止 `print()` / `console.log()`,统一用各层 logger(见 `conventions.md`)
|
||||
Reference in New Issue
Block a user