---
name: optimize-custom-skill
description: 当用户需要维护、审计或更新已有技能，修复过时路径、依赖、流程和验收说明时使用。
---

# 维护已有技能

先定位使技能不可靠的具体原因。文件很久没改只是线索，不等于能力已经失效。

1. 找到用户认可的内容正本，完整阅读 SKILL.md、脚本、引用和元数据。比较安装副本，保留用户修改。
2. 核实触发范围、写死的目录或机器、缺失文件、过时依赖和实际实现。当前 API、模型或分发规则需查官方资料。
3. 区分可继续使用、需要修复、应当归档的部分。大流程先确认阶段间的输入输出，避免只修改文案而遗漏脚本契约。
4. 保留稳定技能名。正文只放关键步骤；条件材料放 references，重复的确定性工作放 scripts。修改失效实现，避免继续引用缺失的外部工具。
5. 更新版本、依赖和验证记录；实际执行过才登记相应验证范围。内容复核、隔离测试、真实业务验收分别记录。
6. 说明原问题、最终改动、兼容影响和剩余限制。安装新版前比较副本并保留完整备份。

公开包需逐文件脱敏，包括脚本默认值、示例、引用和 Agent 元数据。经验沉淀和技能文本不扩展本轮授权。

维护仓库结构由用户选择；没有集中内容库时直接在确认的正本更新。若当前工作区已提供本站 catalog.json 和 scripts/skills.cjs，可按 [本站内容库约定](references/site-library.md) 更新登记与校验；这不是通用使用前提。