菜单
日志分析技能：从日志中快速定位异常、统计错误分布、提取关键时间线。 支持各种日志格式（JSON、纯文本、结构化、非结构化）。 触发词：帮我看看日志、这段日志什么意思、找找报错、日志分析、error log。 触发场景：线上问题排查、错误日志分析、用户反馈复现、性能问题排查。 即使用户没有说"日志分析"，只要给了一段日志让你看，都应触发此技能。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
通用写作技能：以"内容→组件→组合"的方式产出技术文档、产品文档、汇报材料。 覆盖 spec / plan / PRD / 用户手册 / 项目汇报 / 方案路演 / 调研报告 等所有结构化文档场景。 核心理念：组件驱动，不预设模板。先看内容形态，再挑能装这种形态的组件， 组合自然成文——不强制章节结构、不预设"必备模块"。 组件库（HTML / Markdown / 图示）见 references/components.md， 常见组合范式（spec / plan / PRD 等）见 references/templates/——但模板是参考不是规定。 触发词：写文档、写方案、写计划、写 PRD、写汇报、项目总结、写指南、帮我写、文档、方案设计。 即使用户没有明确说"写"，只要意图是"产出一份结构化的文档/报告/材料"，都应触发此技能。 本 skill 只负责"写"，不负责"调研"（调研由 deep-research 承担）和"调度"（流程由 task-start 承担）。
深度调研技能：对任意命题进行系统性调研并输出专业研究报告。 覆盖技术选型、行业分析、学术研究、竞品分析、概念探索等所有调研场景。 核心方法论：快速扫描→假设驱动研究、内外数据结合（先摸清内部现状再对标外部水位）、 反面证据强制搜索、数据来源三级分类、结论置信度分级、多层次报告输出。 采用 Orchestrator-Subagent 架构（Lead+Sub-agent 并行深挖、压缩回传、Scaling Rules 预算控制）， 对齐 Anthropic 官方 Research 工程实践。 包含信息交叉验证、专业图表生成（Diagram Bridge 统一图表体系）、 数据来源分级标注、分析框架自动选择、报告组件驱动（不预设模板，按内容形态调用组件）、质量自检（6 步工作流）。 触发词：调研、研究、分析报告、对比分析、行业报告、技术选型、竞品分析、 市场调研、深度研究、出一份报告、帮我调研一下、了解一下xxx、 评估、诊断、健康度、差距分析。 即使用户没有明确说"调研"，只要意图是"系统性地了解某个命题并形成结论"，都应触发此技能。
MD 文件浏览器预览：GitHub 风格渲染 + 左侧自动目录。 在完成方案设计（specs）或开发计划（plans）的 MD 文件后触发。 询问用户是否要在浏览器中打开预览，确认后执行。 触发词：方案写完、计划写完、review MD、预览文档。 工作流位置：task-start 方案产出后 / 任意 MD 文档完成后
专业图表生成技能：根据需求自动选择合适的图表类型，生成符合设计规范的 PNG 图表。 覆盖 29 种图表：结构图（流程图、泳道图、时序图、架构图、状态图、ER图、类图、思维导图、甘特图、Kanban、Git Graph 等） 和统计图（柱状图、折线图、饼图、雷达图、热力图、散点图、桑基图、漏斗图、瀑布图、矩形树图、柱线混合图等）。 统一工具：HTML/SVG + 内联 JS 布局计算。ER/类图使用 ELKjs 布局引擎。 所有图表遵循统一的设计规范（配色/字体/组件/间距），风格现代简洁。 支持三种输出：PNG（默认）、HTML（富文档嵌入）、DSL（Mermaid 文本，嵌入 MD 文档）。 触发词：画图、画一个、生成图表、流程图、架构图、时序图、柱状图、对比图、关系图。 即使用户没有说"画图"，只要需求中涉及可视化展示（流程、架构、数据对比、关系），都应触发此技能。 被 deep-research 等其他技能调用时，同样遵循本规范生成图表。
项目知识库引擎：持续维护 docs/ 目录作为活的知识库。 灵感来源：Karpathy LLM Wiki — LLM 不只是写文档，而是持续维护知识库。 五个核心操作：Ingest（摄入新信息）、Query（检索知识）、Lint（健康检查）、Index（索引维护）、Synthesize（聚合全局视图）。 触发词：文档检查、清理文档、文档索引、docs 整理、知识库、文档过期了吗、架构文档、用户手册。 触发场景：task-manager 标 done 时自动触发 Ingest、定期 Lint 健检、用户查询项目历史、 task-finish 提醒后触发 Synthesize 更新 architecture/ 或 user-guide/。 即使用户没有说"文档管理"，只要涉及 docs/ 目录的整理/检查/更新，都应触发此技能。
提交前质量门禁：CR 自检（快速/深度）。在 commit 之前触发。 只负责代码质量自检，不负责复盘——复盘在需求标 done 时由 task-manager 触发。 触发词：提交代码、自检、准备提交。 工作流位置：task-start → task-execute → task-finish（自检）→ task-manager（需求关闭时复盘）
| name | log-analysis |
| version | 1.0.0 |
| last_updated | "2026-04-08T00:00:00.000Z" |
| repository | https://github.com/312362115/claude |
| description | 日志分析技能：从日志中快速定位异常、统计错误分布、提取关键时间线。 支持各种日志格式（JSON、纯文本、结构化、非结构化）。 触发词：帮我看看日志、这段日志什么意思、找找报错、日志分析、error log。 触发场景：线上问题排查、错误日志分析、用户反馈复现、性能问题排查。 即使用户没有说"日志分析"，只要给了一段日志让你看，都应触发此技能。 |
日志是系统说的话。大部分时候它在说废话，但出问题时，答案就藏在那些废话里。
拿到日志
│
├─ 1. 识别日志格式和结构
├─ 2. 定位异常和错误
├─ 3. 构建时间线
├─ 4. 分析根因
└─ 5. 给出结论和建议
| 格式 | 特征 | 处理方式 |
|---|---|---|
| JSON 结构化 | 每行一个 JSON 对象 | 解析 JSON，按字段筛选 |
| 标准日志格式 | [时间] [级别] [模块] 消息 | 正则提取字段 |
| 纯文本 | 无固定格式 | 按关键词和时间戳模式匹配 |
| 堆栈跟踪 | Error + at file:line | 识别错误类型和调用栈 |
如果日志太长（>500 行），先问用户：
按优先级从高到低扫描：
FATAL / CRITICAL → ERROR → WARN → 异常模式（超时、重试、拒绝）
| 模式 | 关键词 | 可能的问题 |
|---|---|---|
| 异常/错误 | Error, Exception, FATAL, panic | 代码错误 |
| 超时 | timeout, ETIMEDOUT, deadline exceeded | 网络/依赖慢 |
| 连接失败 | ECONNREFUSED, connection reset, ECONNRESET | 服务不可达 |
| 资源耗尽 | OOM, too many open files, pool exhausted | 资源泄漏 |
| 权限问题 | 403, permission denied, unauthorized | 权限配置 |
| 数据问题 | null, undefined, NaN, invalid | 数据质量 |
| 重试/降级 | retry, fallback, circuit breaker | 依赖不稳定 |
## 错误统计
| 错误类型 | 次数 | 首次出现 | 最后出现 |
|---------|------|---------|---------|
| ConnectionTimeout | 45 | 14:23:01 | 14:28:33 |
| NullPointerError | 3 | 14:25:12 | 14:25:14 |
| AuthTokenExpired | 12 | 14:20:00 | 14:30:00 |
将关键事件按时间排列，还原问题发生经过：
## 事件时间线
14:20:00 [正常] 服务启动，连接数据库成功
14:23:01 [异常] 首次出现 ConnectionTimeout，目标：redis:6379
14:23:15 [异常] ConnectionTimeout 频率上升，10s 内 15 次
14:24:00 [告警] Redis 连接池耗尽，开始排队
14:25:12 [错误] NullPointerError — getUserSession() 返回 null
↑ 因为 Redis 不可用，session 查询失败
14:25:30 [降级] 熔断器触发，Redis 请求直接返回 fallback
14:28:33 [恢复] Redis 连接恢复，ConnectionTimeout 消失
14:30:00 [正常] 错误率归零
## 根因分析
### 现象
用户登录页报 500 错误
### 直接原因
getUserSession() 返回 null，后续代码未做空值处理导致 NullPointerError
### 根本原因
Redis 实例在 14:23 出现网络抖动（可能是运维变更），
导致连接超时 → 连接池耗尽 → session 查询失败 → 空值未处理 → 500
### 因果链
Redis 网络抖动 → 连接超时 → 连接池耗尽 → session 查询失败
→ 返回 null → 未做空值检查 → NullPointerError → 500 响应
## 结论
1. **根因**：Redis 网络抖动导致连接超时，session 查询失败
2. **影响面**：14:23-14:28 期间约 200 个请求受影响
3. **恢复方式**：Redis 连接自动恢复后问题消失
## 建议
### 短期（立即修复）
- getUserSession() 增加空值检查，返回 null 时走降级逻辑而非抛异常
### 中期（防止复发）
- Redis 连接池增加健康检查和自动重连机制
- 添加 Redis 连接状态监控告警
### 长期（提升韧性）
- session 查询增加本地缓存兜底
- 考虑 Redis Sentinel 或 Cluster 提高可用性
src/services/auth.ts:45 的 getUserSession() 返回值后加空值检查"