用途:将 SLS project 或本地输入目录转换为结构化的 overview.md SOP 文档;用户提供 SLS project 名称、要求生成日志分析 SOP、从 index/dashboard 生成文档或提到 generate-sls-sop 时触发。
主要能力:支持两种输入方式——SLS Project 名称(通过 aliyun CLI 自动获取 index/dashboard 数据)和本地目录(直接读取已有数据)。输入目录的 logstore 目录需含必需的 index.json,以及可选的 dashboards、alerts、scheduled_sqls、saved_searches 等资源 JSON。工作流分阶段:Phase A 定位数据源、批量预处理与确认输出路径;Phase B 按 logstore 逐个执行字段说明生成、查询精选、模板归一化、可选查询验证、清理标注、片段渲染与组装输出;Phase C 全局更新索引;Phase D 可选审计。
必要用法:必须在 workspace 根目录执行,禁止 cd 到 skill 目录。使用 SLS project 名称输入时,需 aliyun CLI >= v3.0.308 并完成鉴权(可用 aliyun version 与 aliyun configure list 验证)。fetch 或 validate_queries 须在非沙箱环境运行。典型命令如 python3 scripts/update_status.py <project_dir> --resume-check、python3 scripts/prepare_project.py <project_dir>、python3 scripts/normalize_templates.py <logstore_dir>、python3 scripts/render_queries.py <logstore_dir>、python3 scripts/assemble_overview.py <logstore_dir> --name "..." --description "..."。
适用场景:为 SLS 日志仓库生成日志分析 SOP 文档,按 logstore 整理字段说明、精选查询、告警与仪表盘关联信息。
限制:当输入为 SLS project 名称时依赖 aliyun CLI 版本与鉴权配置;非沙箱环境要求;部分步骤(如参考文档提取、查询验证、审计)为条件或可选;本地目录需满足 index.json 与资源子目录结构要求;详细参数与规则以脚本 docstring 及 md 规则文件为准。