菜单
日志问题定位技能组框架。定义了一组基于日志进行问题定位的 skill 的组织方式、通用结构和命名规范。每个具体问题（如缩P保D、建链失败）有独立的诊断 skill。触发词：日志定位、日志诊断、log diagnosis、问题定位、故障定位。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| 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实例建链失败 | 已创建 |
从代码仓提取指定特性的关键日志，生成「日志定位指南」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）和具体修改建议。触发词：重写日志、改写日志、日志整改、修复日志。