Menu
日志问题定位技能组框架。定义了一组基于日志进行问题定位的 skill 的组织方式、通用结构和命名规范。每个具体问题（如缩P保D、建链失败）有独立的诊断 skill。触发词：日志定位、日志诊断、log diagnosis、问题定位、故障定位。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
从代码仓提取指定特性的关键日志，生成「日志定位指南」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）和具体修改建议。触发词：重写日志、改写日志、日志整改、修复日志。
| name | log-diagnosis-framework |
| description | 日志问题定位技能组框架。定义了一组基于日志进行问题定位的 skill 的组织方式、通用结构和命名规范。每个具体问题（如缩P保D、建链失败）有独立的诊断 skill。触发词：日志定位、日志诊断、log diagnosis、问题定位、故障定位。 |
本框架定义了一组基于日志进行问题定位的 skill 的组织方式和通用结构。每个具体问题类型有独立的诊断 skill，本文件是框架说明，不直接执行诊断。
log-analyzer-skill 负责从代码仓库提取日志并生成结构化文档（日志表格、流程图、故障模式库），是"整理"能力。 log-diagnosis 系列 skill 负责拿着日志做问题定位，是"诊断"能力。
两者关系：
| 命名格式 | 说明 | 示例 |
|---|---|---|
log-diagnosis-{problem-id} | 每个问题类型一个 skill | log-diagnosis-shrink-p-reserve-d |
log-diagnosis-framework | 本框架文件 | - |
problem-id 使用小写英文短横线连接，语义化描述问题。
每个 log-diagnosis-{problem-id} 的 SKILL.md 必须包含以下章节：
---
name: log-diagnosis-{problem-id}
description: 一句话描述该 skill 解决什么问题。触发词：xxx、yyy。
parent: log-diagnosis-framework
---
列出标志该问题开始的关键日志，格式：
| 入口日志 | 组件 | 含义 | grep 命令 |
|---|---|---|---|
| 日志内容模板 | 组件名 | 含义 | grep "pattern" /path/to/log |
用户遇到问题时，先按入口日志确认问题类型，然后加载对应的 diagnosis skill。
基于日志的分支判断，用决策树描述排查路径：
[入口日志]
├── 分支A（条件1）→ 检查项1 → 结论A1 / 继续分支
├── 分支B（条件2）→ 检查项2 → 结论B1 / 继续分支
└── 分支C（条件3）→ 检查项3 → 结论C1 / 继续分支
每个分支的判断依据是实际日志中是否出现某条日志，不是猜测。
按步骤拆分，每个步骤：必须是可执行的检查、有明确的预期结果、异常时有跳转路径。
每个 skill 诊断完成后，必须按以下格式输出结论：
## [问题类型] 诊断报告
### 诊断结论
**方向**: xxx
**根因**: [一句话描述根因]
### 证据链
| # | 日志位置 | 日志内容 | 推导结论 |
|---|----------|----------|----------|
| 1 | 行xxx | `日志内容` | 从这条日志能推导出的结论 |
| 2 | 行xxx | `日志内容` | ... |
| ... | ... | ... | ... |
### 根因分析
[2-3句话分析：这些证据为什么指向这个根因]
### 下一步行动
| 优先级 | 方向 | 具体操作 | 可信度 |
|--------|------|----------|--------|
| P0 | 验证根因 | [检查命令或配置] | 高/中/低 |
| P1 | 继续排查 | [如果可信度不够，还需要查什么] | 中/低 |
### 修复建议
[如果根因确定，给出具体修复步骤或配置修改建议。如果根因不确定，给出最可能的修复方向。]
关键要求：
针对最常见的问题，提供"日志现象 → 根因 → 修复"的快速映射：
| 日志现象 | 根因 | 修复方法 | 优先级 |
|---|---|---|---|
| xxx | yyy | zzz | P0/P1/P2 |
| 关联问题 | 关联方向 | 对应 Skill |
|---|---|---|
| 问题名 | 上游/下游/并发 | log-diagnosis-xxx |
当用户报告问题时：
skill_view(name="log-diagnosis-xxx") 加载| 维度 | log-analyzer | log-diagnosis |
|---|---|---|
| 目标 | 整理日志、建基线 | 定位问题、找根因 |
| 输入 | 代码仓库 + 可选实际日志 | 实际环境日志 + analyzer 产出的基线 |
| 输出 | CSV表格 + MD流程图 + 故障模式库 | 根因定位 + 修复建议 |
| 使用时机 | 功能开发/文档阶段 | 故障发生/排查阶段 |
| 前置依赖 | 无 | log-analyzer 产出（可选但推荐） |
log-analyzer-skill 的第八步（生成故障模式库）完成后，可以同步生成一个 log-diagnosis skill 骨架，预填入口日志和诊断决策树。
所有 log-diagnosis skills 放在 ~/projects/doc/skills/archive/cursor/log-diagnosis-{problem-id}/ 目录下。
每个 skill 目录结构：
log-diagnosis-{problem-id}/
├── SKILL.md # 主文件
├── references/
│ ├── diagnosis-tree.md # 详细诊断决策树（可展开）
│ └── related-fault-modes.csv # 关联的故障模式库子集
└── scripts/
└── quick-diagnose.sh # 一键诊断脚本（可选）
| Skill 名称 | 问题描述 | 状态 |
|---|---|---|
| log-diagnosis-shrink-p-reserve-d | 缩P保D流程异常 | 已创建 |
| log-diagnosis-pd-link-establishment | PD实例建链失败 | 已创建 |