| name | skill-evolution |
| version | 2.3.0 |
| description | Skill 自动进化管理器（STOM v2.1 新增 CI 门禁版）。 6 Phase 审计：扫描 → 分析 → 进化 → CI Gate → 修复 → 健康评分。 内置 skill-ci-validate.py 强制门禁（P0 阻断），三纯净原则检查， 6 维度健康度评分。触发词自进化 + 踩坑经验积累是标配。 详细审计流程/CI 规则/健康评分公式/报告模板移至 references/detailed-audit-flows.md。
|
| references | ["references/detailed-audit-flows.md"] |
| tags | ["skill进化","skill升级","优化skill","审计skill","skill自进化","触发词优化","技能升级","技能进化","skill管理","更新触发词","CI门禁","skill健康检查","三纯净"] |
| triggers | ["skill 进化","skill 升级","优化 skill","审计 skill","skill 自进化","触发词优化","技能升级","技能进化","帮我优化技能","skill 管理","更新触发词","检查 skill","skill health","技能健康检查","skill CI","CI扫描","三纯净","跨平台兼容"] |
| complexity | ⭐⭐⭐ |
| tools | ["Read","Write","Edit","list_dir","Bash","Agent","Skill"] |
| allowed-tools | Read, Write, Edit, Skill, Agent, Bash |
Skill Evolution - 技能自动进化管理器（STOM v2.1）
🎯 定位
周期性健康审计所有 Skill：CI 门禁（三纯净 + 工具声明）、触发词覆盖、踩坑经验、Token 效率、版本治理。
详细参考（CI 规则详解/消化引擎完整示例/注册表同步图/依赖检查矩阵/健康度评分公式/报告模板/进化模块标准模板）→ references/detailed-audit-flows.md
📋 审计流程（6 Phase）
| Phase | 核心动作 | 产出 |
|---|
| 1 Scan | 遍历 skills/ 目录 → 读所有 SKILL.md 建清单 | 名称/版本/行数/触发词数/工具声明 |
| 2 Analyze | 读工作日志 → 提取盲区/踩坑/偏好 | 进化建议清单 |
| 3 Evolve | 执行 6 类改进（见下表） | 已修改的 Skill 文件 |
| 3.5 CI Gate | python skill-ci-validate.py | CI 通过/失败 JSON 报告 |
| 3.6 Fix | 修复 CI P0/P1 问题 → 重新扫描 | P0 清零 |
| 4 Health | 6 维度加权评分 → 健康等级 | 每个 Skill 的健康分 |
| 5 Report | 生成完整审计报告 | Markdown 进化报告 |
Phase 3.5 是强制门禁：P0 存在 → 阻断 → 修复后才能继续 Phase 4。
Phase 3 · 6 种改进动作（v2.3 新增 CI 项）
| # | 动作 | 来源 | 条件 |
|---|
| ① | 补触发词 | 原文三纯净 | 发现盲区，每次 ≤5 个，通用化 |
| ② | 补踩坑经验 | STOM 原有 | 日志中 ≥2 次重试模式 |
| ③ | 添加进化模块 | STOM 原有 | 缺触发词自进化 + 踩坑区 |
| ④ | 修复平台污染 | 原文三纯净 | CI P0: platform_syntax_pollution |
| ⑤ | 补 allowed-tools | 原文保守策略 | CI P0: undeclared_tool_usage |
| ⑥ | 替换绝对路径 | 原文三纯净 | CI P0: absolute_path_hardcoded |
CI 检查项参考（skill-ci-validate.py）
| 级别 | 检查项 | 说明 |
|---|
| P0 | platform_syntax_pollution | 正文含 @人名、/cmd、!bash 等平台语法 |
| P0 | undeclared_tool_usage | 正文工具名未在 allowed-tools 声明 |
| P0 | absolute_path_hardcoded | 正文含 C:\、/Users/ 等绝对路径 |
| P0 | yaml_parse_error | YAML frontmatter 解析失败 |
| P0 | deprecated_skill | description 含 [DEPRECATED] |
| P1 | missing_required_field | 缺少 name/description/version |
| P1 | description_too_short | description < 50 字符 |
| P1 | name_mismatch | 目录名与 frontmatter.name 不一致 |
| P2 | missing_version | 缺 version 字段 |
| P2 | missing_triggers | 缺 triggers 数组 |
| P2 | description_negative_tone | description 含消极表述 |
| P3 | stale_skill | >30 天未更新 |
Phase 4 · 健康度评分速查（v2.3，6 维度）
5→6 维度，新增「CI 通过」：
| 维度 | 权重 | 得分规则 |
|---|
| 版本同步 | 15% | 一致=100 / 不一致=0 |
| 触发词覆盖 | 20% | min(count×10,100)，盲区-20 |
| 踩坑经验 | 10% | 无=30 / 有=60 / 整合=80 / ≥5=100 |
| CI 通过 | 25% | P0存在=0 / P1存在=50 / P2存在=80 / 全通过=100 |
| Token 效率 | 15% | ≤250行=100 / 251-350=80 / >350=40 |
| 活跃度 | 15% | 使用=100 / 更新=80 / 无=40 |
等级： ≥80🟢 | 60-79🟡 | 40-59🟠 | <40🔴
⚙️ 核心规则
- 只追加不覆盖 — 不删现有触发词或经验
- CI Gate 强制 — P0 必须清零才能通过审计
- 通用化表述 — 新触发词可复用，不过于具体
- 去重检查 — 语义不重复才添加
- 透明变更 — 每次进化生成报告
- 尊重原结构 — 只丰富元数据，不改核心工作流
🔍 Search Before Building
| Layer | 动作 |
|---|
| L1 | grep 工作记忆中最近的进化记录和上次报告 |
| L2 | 检查已有进化报告模板 + 可复用模式 |
| L3 | 先运行 CI scan，拿到问题清单再定义优先级 |
🚨 Escalation
| 触发条件 | 处理 |
|---|
| Skill 文件损坏 | STOP，跳过 |
| 安全漏洞（硬编码凭证） | STOP，报告 |
| CI P0 无法修复 | STOP，报告原因，标记需人工处理 |
| 涉及自身修改 | STOP，改手动 |
| 3 次进化均失败 | STOP，报告原因 |
🔗 联动
上游：周期审计(每周) / 用户要求 / 发现问题
下游：self-improvement(踩坑) / skill-creator(新建) / memory-consolidation / MEMORY.md
审计优先级：P0 CI问题 > Token超标 > 触发词不足 > 其他
🔄 触发词自进化
用户表述未激活本 Skill 时：分析关键表述 → 抽象通用触发词 → 追加到 frontmatter triggers → 去重。
📚 踩坑经验
AI 自动积累，请勿手动删除。格式：- 场景：经验要点（≥2 次尝试才记录）
- 踩坑即时追加：不等审计，≥2 次重试成功后会话结束时直接追加
- Skill 候选识别：应在 self-improvement 中加入候选识别，降低创建门槛
- 三纯净原则：平台语法污染最常见，CI scan P0 中最多
- CI Gate 先于 Token 优化：先保证跨平台兼容，再追求瘦身
