菜单
MindIE-SD 仓库 Markdown 格式 lint 规则。当编写、修改或审查 Markdown 文件（README、文档、 变更日志等）、或 CI 门禁报出 markdownlint 违规时使用此 skill。 即使用户只提到"格式问题"或"MD040报错"而未说 markdownlint，也应触发。 通常由 dev-workflow 和 code-standards 在编码/审查阶段指引加载。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
MindIE-SD 代码部署与编译安装。已在昇腾设备上直接编译安装；本地开发机通过 SSH 推送到远端昇腾设备， 支持 Docker 容器内源码编译。当用户需要部署安装 MindIE-SD、更新远端容器内代码、 或管理多人共享 NPU 环境时使用此 skill。 即使用户只提到"把代码推到服务器"而未说 SSH 或昇腾，只要上下文涉及部署都应触发。 由 dev-workflow 的部署阶段触发。
在远端昇腾 NPU 设备上采集性能 profiling 数据，打包回传本地供 performance-analysis 使用。 统一采集流程：开启 Profiler → 运行推理 → 压缩 → 回传（部署由 ascend-deploy 完成）。 当用户需要采集模型 profiling 数据、开启 profiler 跑推理、或为性能分析准备数据时使用此 skill。 即使用户只提到"帮我采一下 profile"或"开 profiler 跑这个模型"，也应触发。 通常由 model-verification、ascend-deploy 或 performance-evaluation 的 NPU 路径路由触发。
端到端性能优化闭环，组合 profiling-collection、performance-analysis、performance-optimization 三个下层 skill 完成从 profiling 采集到方案实施的完整流程。 当用户需要完整优化模型推理性能、并确认优化效果时使用此 skill。 前置条件：模型已通过 ascend-deploy 部署至 NPU 设备且已验证可通过。 由 dev-workflow 的各阶段触发。
MindIE-SD Python 代码格式与 lint 规则。当编写、格式化、lint 检查或审查 MindIE-SD 项目的 Python 代码时使用此 skill。 即使用户只提到"提个MR"或"代码好像有 lint 问题"而未明确说格式化，也应触发。 通常由 dev-workflow 在编码阶段指引加载。
MindIE-SD 编译后端适配与分析。覆盖 Pattern 创建/注册/调试、Copy 算子消减、 四后端选择 (default / torchair_ge / npugraph_ex / aclgraph) 的全生命周期。 触发: "pattern", "compile", "Copy", "InplaceCopy", "fusion", "backend", "torchair_ge", "--npugraph", "register_replacement".
MindIE-SD 开发总入口。当用户进行 MindIE-SD 的任何开发工作时使用此 skill—— 包括但不限于写 pattern、改测试、部署到昇腾、跑 benchmark、性能分析、多卡并行、复盘归档。 即使用户未明确提到"开发流程"，只要涉及 MindIE-SD 代码改动都应触发。
| name | markdown-lint |
| description | MindIE-SD 仓库 Markdown 格式 lint 规则。当编写、修改或审查 Markdown 文件（README、文档、 变更日志等）、或 CI 门禁报出 markdownlint 违规时使用此 skill。 即使用户只提到"格式问题"或"MD040报错"而未说 markdownlint，也应触发。 通常由 dev-workflow 和 code-standards 在编码/审查阶段指引加载。 |
本 skill 汇总 MindIE-SD 仓库的 Markdown 格式 lint 规则，适用于 .md 文件的编写、修复与审查。
事实来源：
.pre-commit-config.yaml（markdownlint 钩子配置）markdownlint-cli v0.46.0 规则集所有围栏代码块（```）必须指定编程语言或内容类型。
正例：
```shell
npu-smi info -l
```python
def foo():
pass
**反例（触发 MD040）：**
```markdown
examples/dummy_run/ ├── model/ ├── wan_infer.py └── README.md
代码块语言选用指南：
| 内容类型 | 语言标记 |
|---|---|
| Python 代码 | python |
| Shell 命令 | shell 或 bash |
| 目录 / 文件树 | text |
| 终端输出 / 日志 | text |
| 纯文本 / 伪代码 | text |
| YAML 配置 | yaml |
| Markdown 示例 | markdown |
| JSON 数据 | json |
| 规则 | 说明 |
|---|---|
| MD009 | 禁止行尾空格（由 trailing-whitespace 钩子覆盖） |
| MD012 | 禁止连续多个空白行 |
| MD031 | 围栏代码块前后需有空行 |
| MD047 | 文件末尾需有换行符（由 end-of-file-fixer 钩子覆盖） |
# 检查单个文件
pre-commit run markdownlint --files path/to/file.md
# 检查所有文件（CI 模式）
pre-commit run markdownlint --all-files
markdownlint钩子在.pre-commit-config.yaml中配置为stages: [manual]，需显式触发。
对 commit 新增或修改的 .md 文件做独立检查，避免全量噪音：
git diff --name-only HEAD~1..HEAD -- '*.md' | xargs markdownlint -c .markdownlint.json
-c .markdownlint.json 配置文件而非 --disable 命令行参数--disable MDxxx 的数组传参可能不生效，导致规则未真正禁用<!-- 修改前 -->
examples/ ├── a.py └── b.py
<!-- 修改后 -->
```text
examples/
├── a.py
└── b.py
### 3.2 无明确代码语言的内容
```markdown
<!-- 修改前 -->
Warmup inference (1 step) ... [transformer] 7.1s Inference time: 7.1 s
<!-- 修改后 -->
```text
Warmup inference (1 step) ...
[transformer] 7.1s
Inference time: 7.1 s
---
## 4. 与 dev-workflow 的关系
本 skill 作为 `dev-workflow` 的补充模块，在以下时机触发：
- 新建或修改 `.md` 文件后，提交前
- CI 门禁报出 `markdownlint` 违规时
- 模板文件（PR/Issue）变更时
`dev-workflow` 的 Test-First 流程中，编码阶段需确保 Python 代码通过 Ruff 检查，同时确保 Markdown 文件通过 `markdownlint` 检查。
---
## 5. 批量修复注意事项
### 5.1 编码安全
PowerShell 5.1 下用 `Get-Content` / `Set-Content` 读写含中文的 UTF-8 文件会导致编码破坏（BOM 注入 + 字节重解释）。
**安全方式：**
- Python：`open(f, 'r', encoding='utf-8')` / `open(f, 'w', encoding='utf-8')`
- Node.js：`fs.readFileSync(f, 'utf-8')` / `fs.writeFileSync(f, content, 'utf-8')`
**避免：** PowerShell `Get-Content` / `Set-Content` / `Out-File` 直接读写 UTF-8 含中文文件。
### 5.2 MD040 修复模式
替换 `` ``` `` → `` ```text `` 时需覆盖两种变体：
- **顶格** `` ``` ``（行首无空白）
- **缩进** `` ``` ``、`` ``` `` 等（保留前导空白，缩进代码块）
### 5.3 修复后验证
1. 重跑 `markdownlint -c .markdownlint.json <files>` 确认 0 违规
2. `git diff` 检查只有预期替换行变化，无编码污染（BOM、乱码）
3. 确认中文等非 ASCII 字符未损坏
## 6. 维护与更新
当 `markdownlint-cli` 版本升级、`.pre-commit-config.yaml` 中 markdownlint 配置变更、
或新 MD 规则启用时，按 `dev-workflow` 的复盘流程更新本 skill。