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 入库
934 B
934 B
paths
| paths | |||
|---|---|---|---|
|
可观测性
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)