Menu
将日志表格生成为 Markdown 文档，含概述、涉及仓库组件、关键配置、日志表格、Mermaid 流程图、关键说明。触发词：生成Markdown、生成文档、日志文档。
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
| name | log-analysis-document |
| description | 将日志表格生成为 Markdown 文档，含概述、涉及仓库组件、关键配置、日志表格、Mermaid 流程图、关键说明。触发词：生成Markdown、生成文档、日志文档。 |
将日志表格转换为带 Mermaid 流程图的 Markdown 文档。
生成Markdown、生成文档、日志文档
| 输入 | 必需 | 说明 |
|---|---|---|
| 校正后的日志表格 | 必需 | log-analysis-correct 输出的 CSV |
| 功能描述 | 必需 | 功能名称，如"缩P保D"、"PD建链" |
| 输出目录 | 必需 | Markdown 文件输出路径 |
| 输出 | 格式 | 说明 |
|---|---|---|
| Markdown 文档 | .md 文件 | 含表格、流程图、关键说明 |
# [功能名称] 日志整理
## 概述
[功能描述、触发条件、整体流程]
## 涉及仓库与组件
- **repo1**: component1, component2
- **repo2**: component1
## 关键配置
| 配置项 | 值 | 说明 |
|--------|-----|------|
| ... | ... | ... |
---
## 日志表格
| 编号 | 出现场景 | 组件 | 日志级别 | 日志内容 | 出现阶段 | 含义 | 下一步走向 | 代码位置 |
|------|----------|------|---------|----------|----------|------|-----------|---------|
| ... | ... | ... | ... | ... | ... | ... | ... | ... |
---
## 逻辑流程图
[Mermaid flowchart]
---
## 关键说明
[触发条件、核心组件职责、典型场景示例]
---
## 校正报告（如有）
[仅当提供了实际日志时输出]
---
## 故障模式库
[摘要表格 + 关联图，仅当 log-analysis-fault-mode 完成后补充]
每个 subgraph 对应表格中的一个"出现阶段"，节点标注 函数名 #日志编号：
graph TB
subgraph 初始化
A1["[model] 服务启动 #1"]
A2["[model] 加载配置 #2"]
A3["[model] 申请显存 #3"]
end
subgraph 建链
B1["[router] 发起建链请求 #4"]
B2{"建链成功?"}
B3["[router] 建链成功 #5"]
B4["[router] 建链失败 #6"]
end
subgraph 推理
C1["[scheduler] 接收请求 #7"]
C2["[worker] 执行推理 #8"]
C3["[worker] 推理完成 #9"]
end
| 颜色 | 含义 | 用于 |
|---|---|---|
#ffcccc（浅红） | 错误、故障 | ERROR 日志节点 |
#ffcc99（浅橙） | 判断点、告警 | 条件判断节点 |
#99ff99（浅绿） | 成功、完成 | 正常结束节点 |
#ccccff（浅蓝） | 外部系统/跨仓库 | 跨组件调用节点 |
#ffffff（白色） | 正常操作 | 一般操作节点 |
[组件] 函数描述 #日志编号
示例：
[llm/model] Link established #5[cmotor/router] Route request #12[vllm/scheduler] Schedule batch #20-->--> |条件| 标注分支条件 subgraph 循环 包裹==>graph TB
A["[pymotor] 收到请求 #1"]
B{"参数校验"}
A --> B
B --> |成功| C["[llm] 执行推理 #3"]
B --> |失败| D["[pymotor] 返回错误 #4"]
C --> E["[pymotor] 返回结果 #5"]
D --> E
每个阶段说明：
文件路径：{输出目录}/{功能名称}日志整理.md
从代码仓提取指定特性的关键日志，生成「日志定位指南」Markdown（正文三层快速定位+分阶段+卡点速查，附录含特性链路全量日志表与 Mermaid）。不产出 CSV/9列表格关系图。触发词：整理{特性}日志定位指南、生成{特性}日志定位指南、从代码整理{特性}定位指南。
日志标准规范的适配器层。根据外部标准文档执行日志质量检查，调用 scan / rewrite / write 能力。触发词：日志标准、日志规范、日志质量标准、log standard、log quality、制定日志规范。
Controller 精度告警触发的实例「自杀」(terminate) 失败日志诊断。当 precision auto-recovery 应杀 P/D 却未杀、terminate_instance_for_recovery 失败、或 Recovery/NodeManager stop 报错时， 按 Coordinator→Controller→Recovery→NodeManager 链路定位根因。触发词：controller自杀、自杀失败、 terminate失败、precision-auto-recover、精度告警恢复、terminate_instance、Recovery:、实例终止失败、 auto-recovery failed、add_alarm、0xFC001107。
大 EP 场景启动失败/拉不起来的日志诊断。当 Controller 或 Coordinator 无法到达 MindIE-MS coordinator is ready，或长期 not ready 时，按 cmotor 启动五阶段定位；PD 分离卡在就绪前则下钻 mindie-llm 建链。触发词：大EP拉不起来、大EP启动失败、大EP启动卡住、coordinator not ready、coordinator is ready、MindIE-MS coordinator is not ready、大EP起不来。
MindIE/cmotor 日志诊断调度器。接收 MindIE/PyMotor/cmotor 相关日志，自动判断问题方向并调度对应子 skill 诊断。触发词：日志诊断、日志分析、日志定位、故障定位、MindIE日志、PyMotor日志、大EP拉不起来、coordinator not ready。
将不合规的日志改写为符合 log-quality-standard 的版本。输入扫描报告，输出每条日志的修改前后对比（diff）和具体修改建议。触发词：重写日志、改写日志、日志整改、修复日志。