用途：把真实运行反馈转化为对既有技能的结构性净改进，可新增、修改、合并、删除、弃用，或决定不改动。适用于 Codex、Claude Code、OpenCode、OpenClaw、Hermes 等能读取 SKILL.md 及可选 references/、scripts/、evals/、agents/ 的本地智能体宿主。
主要能力：锁定目标技能名称与路径；锁定证据范围（对话、日志、截图、产物、diff、测试、源文档或用户反馈）；先读目标技能再提改动；对信号分类（流程缺口、验证缺口、来源漂移、平台漂移、用户偏好、候选想法、事故、路由缺口、内容膨胀）；设计案例集（事故、候选规则、回归、边界、可选留出挑战）；通过泛化门槛，避免把一次性事故固化为长期规则；映射路由影响，把可机器校验的事实移到工具、测试、schema、diff、校验器或文件；选择净改进形态（no_change、maintenance_note_only、prune_or_consolidate、local_refactor、cross_reference_refactor、major_refactor、deprecate_or_replace_source）。
使用方式：始终以 plan_only 启动，产出具体升级计划后停止；只有用户明确指向当前计划的批准（如“approve plan A”“apply the plan above”）才进入 apply_after_approval。仅说“upgrade it”“directly edit it”“don't ask me”“go ahead”或最初提出改进请求，均不构成批准。应用前读取 SKILL.md、相关 references/、scripts/、evals/ 及可选 agent 元数据，保留无关用户改动，尽量留存 diff 或快照，只改当前已批准计划内的文件。
验证：运行 <python> <skill-dir>/scripts/validate_upgrade_artifacts.py --skill <skill-dir>，检查包结构、可移植 Agent Skills frontmatter 字段集、引用路径、JSON 形状、Python 语法、常见私有路径泄露及必需的批准用语；再运行目标技能自身校验器与最小相关技术检查，如 python -m py_compile、python -m json.tool，必要时做触发、路由与边界回归。跳过或失败时不得声称升级完成。
限制：不写入凭据、浏览器会话、私有账户数据、无关个人路径或隐藏提示；不随发布包附带内部维护日志；留出挑战仅用于应用后验证；结构校验不运行 eval 用例，也不证明行为确有改进；各宿主可能有不同语法或更窄字段集，其官方校验器仍具权威性。最终需报告目标技能与路径、计划或已应用状态、实际使用的证据来源、实际改动文件、实际运行的验证命令及结果、被删除或否决的想法及原因、剩余风险或后续检查。