复用资产库使用规则（给 AI 助手）¶

目标：每次实验/排障的产出沉淀为可直接复用的资产，下次遇到同类问题"先查这里、零起步排查"。目录：F:\EricLiu\Docs\Reusable\　创建日期：2026-11-11

使用规则（AI 必须遵守）¶

用前先查：做实验或排障前，先查 INDEX.md（按标签 grep），有现成资产直接复用并告知用户来源；命中后不用再从零排查。
用后必炼：解决一个新问题/完成一个实验后，至少提炼 1 项资产入库（四类任选，见下）；没提炼视为实验未收尾。
入库要验证：脚本/配置必须在实际环境跑通过；SOP 必须含真实报错原文；清单必须来自实际流程。
登记索引：入库后立即在 INDEX.md 追加一行（标签、状态、名称、路径、适用场景与条件、适用版本、来源实验、日期、命中次数=0）。
去重：入库前查 INDEX 是否已有同类资产，有则更新原条目（标注修订日期）而不是新建重复文件。
反哺：同一问题被 2 个以上实验命中 → 提议把解法写进对应技术 README 的排障速查节。

资产生命周期（防止复用库变成"过期经验库"）¶

待验证(草稿) → 已验证(可用) → 常用(命中≥3，名称前加★) → 已过时(归档保留)
                ↑______阶段出关复核（配合 Roadmap 回炉机制）______|

状态字段：INDEX.md 每条资产必须标状态——已验证（可直接套用）/ 待验证（提炼了但没跑通，只作参考，不得直接套用）/ 已过时（不删除，注明失效原因）。
适用版本必填：注明适用的工具版本（如"kind v0.33 / K8s 1.37"）。套用前 AI 先对比该技术分册 README 的版本基线，版本不一致不得直接套用，需先小范围验证。
适用条件必填：写清什么场景能用、什么场景不能用（如"仅适用 Hyper-V 内部交换机 NAT 环境，云上不适用"），防止错误套用。
阶段出关复核：每阶段结束抽查本阶段来源的资产——跑不通的标"已过时"并注明原因，不删除（留作历史参考）。
命中统计：每次实际复用命中，INDEX 命中次数 +1；命中 ≥3 升"常用"；连续 90 天零命中且非基础类资产 → 季度大扫除时归档。

标签受控词表（禁止自造同义标签，新增标签先在此登记）¶

类别	允许的标签
动作	`#排障` `#部署` `#巡检` `#备份` `#重建` `#优化`
技术	`#linux` `#shell` `#git` `#vagrant` `#docker` `#k8s` `#nginx` `#ansible` `#terraform` `#监控`
对象	`#vm` `#容器` `#pod` `#网络` `#端口` `#存储` `#镜像` `#服务` `#证书` `#权限`

命名规则：动作类和技术类至少各带 1 个；全小写；不确定选哪个就选最接近的并在"适用场景"里写清楚。

四类资产定义¶

类别	目录	入库标准	示例
脚本	`scripts\`	可直接运行、带 usage 注释、已在实验中跑通	巡检脚本、批量清理、环境重建
配置	`configs\`	实际部署验证过的模板，含参数注释	Vagrantfile、K8s YAML、docker-compose、nginx conf
SOP	`playbooks\`	症状 → 排查步骤（带命令）→ 判定 → 解法，含真实报错原文	Pod CrashLoop 排查、端口占用定位、磁盘满处置
清单	`checklists\`	按顺序勾选的 checklist，来自真实流程	部署前检查、阶段出关自测、上线回滚预案

SOP 模板（playbooks*.md）¶

# SOP：症状一句话标题
标签：#排障 #xxx　来源：E0X　日期：YYYY-MM-DD

## 症状
- 现象 + 真实报错原文（完整粘贴）

## 排查步骤（按顺序，每步有判定）
1. `命令` —— 看什么、什么结果说明什么
2. ...

## 解法
（验证过的处理步骤）

## 验证
（怎么确认已修复）

INDEX.md 条目格式¶

标签	状态	名称	路径	适用场景与条件	适用版本	来源实验	日期	命中
#排障 #linux #端口	已验证	端口占用三步定位	playbooks/port-occupied.md	服务起不来先查这个；仅 Linux VM 内	Ubuntu 22.04+	E01-2	2026-11-11	0