技能介绍

解决什么问题

skill-check 能给出体检报告和处方单，但产出的是一份改进清单。清单本身不会动文件：缺依赖、功能重叠、frontmatter 字段不全、体积过大这些问题，仍然要人工逐条打开文件、判断怎么改、改完再验证。更麻烦的是，SkillHub 不会自动更新已安装的技能，config.json 里没声明 update_url 的技能只能跳过。结果是「知道该改什么」和「真的改完并确认没改坏」之间，隔着大量重复劳动。

核心能力与关键步骤

本技能补齐「确认 → 动手改 → 升级 → 复盘」的执行闭环。它把改进拆成八块可组合的积木，运行入口是几个 Python 脚本：

run_check.py 复用 skill-check 的产物（audit_latest.json / eco_report.json / upgrade_report.json），未安装时降级为内置 bundled_check 八维检查，流程不中断
plan_improvements.py 生成三层施工蓝图（L1 积木块级、L2 八维评分级、L3 兜底清单），蓝图带 phase / depends_on / order / opinion
render_blueprint.py 把蓝图可视化，暗色主题、红涨绿跌，先在浏览器里看图纸再动手
execute_improvements.py 施工管理器：按蓝图顺序执行，每项先备份到 state/backups/，再做定向验证，失败立即回滚
evaluate.py 重跑体检算 before/after Δ，并记录 improvement_history.json 供蒸馏校准
upgrade_manager.py 负责维护模式，封装 skillhub upgrade --check-only / --dir / --slug

写操作必须过两轮确认：先图纸会审（选改哪些、对蓝图提意见），再施工许可（确认最终施工单）。v0.1.0 还加了程序化门禁，confirm_blueprint.py 推进 confirmation_state.json 状态机，execute_improvements.py 施工前调用 check_permit()，未授权直接拒绝写文件。

适用边界与注意点

它只管已有技能的改进、升级、复盘和下线，不创建新技能（用 skill-creator）、不调试运行时行为（只改静态文件）、不替代纯体检（只想要报告时仍用 skill-check）。默认单次施工范围是强推项 ≤5 加用户指定项，避免全量空转。改了非自建技能会提示可能被下次 upgrade 覆盖。对 Desktop / Downloads 等个人目录的 rm -rf 类命令一律禁止。