技能有效性管理器

能力简介

扫描已装技能的使用情况，识别从未使用和长期闲置的技能，生成清理建议清单。用户确认后安全备份并删除，支持有效期管理和误删恢复。

核心能力：
- 🔍 诊断扫描：扫描skills目录，分析使用情况，生成清理建议清单
- 🗑️ 清理执行：备份→删除→验证→记录，支持恢复
- 🏷️ 有效期管理：为技能打标签（长期/3个月/短期），到期提醒
- ♻️ 误删恢复：30天内可恢复，备份自动管理
- 🛡️ 安全机制：自身豁免、强制备份、用户确认后才删除

核心FAQ

Q1：扫描会删除技能吗？
不会。扫描只读取信息和分析使用情况，不做任何删除操作。删除必须用户确认后才执行。

Q2：删除后能恢复吗？
可以。删除前自动备份到.skills_backup/目录，30天内说"恢复XX技能"即可恢复。超过30天备份自动清理，需从SkillHub重新安装。

Q3：使用频率判断准吗？
综合判断：文件修改时间 + 工作区痕迹（daily notes/md文件中是否提到过该技能名）+ 有效期标签。判断结果展示给用户可自行调整。

> ⚠️ 局限性提醒：当前不依赖平台调用日志API（多数平台未开放），只能通过文件痕迹推断。可能出现"实际用过但没留下文件痕迹"被误判为"从未使用"。对不确定的技能建议选"观察"而非直接清理。

Q4：有效期标签必须打吗？
不强制。不打标签的技能默认按3个月处理。到期提醒"还在用吗？"，在用续3个月，不用进清理清单。

Q5：系统级安装的技能能删吗？
不能。如AgentMore的lark-*系列是系统级安装的（在.agents/skills/目录），脚本会标注"系统级·不可删"，但不影响其他技能的扫描和清理。

Q6：能跳过自身吗？
可以。scan_skills.py扫描时自动跳过skill-health-manager目录，不会把自己列入清理清单。

Q7：备份占空间吗？
备份是技能目录的完整拷贝。如果技能目录大（含示例文件等），备份会占一定空间。30天后自动清理。如需提前清理备份，删除.skills_backup/下对应日期目录即可。

Q8：周期触发多久一次？
上次扫描/清理后≥30天，AI会主动提示"距离上次清理已XX天，要不要做个技能健康检查？"

Q9：其他平台的用户能用吗？
能。SKILL.md的触发词和扫描逻辑是通用的。平台适配部分用条件分支——AgentMore可自动备份删除，其他平台降级为"仅建议"模式，告知用户手动删除。

Q10：这个技能本身会占很多资源吗？
不会。纯Python标准库实现，无外部依赖，完全离线运行。只在被触发时执行，不常驻后台。

触发词清单

执行流程

反模式清单（禁止做的事）

脚本调用方式

# 对话触发（推荐）
"帮我清理没用的技能"
"系统变慢了，做个技能健康检查"

# 命令行调用
python3 scripts/scan_skills.py --workspace /home/z/my-project
python3 scripts/scan_skills.py --workspace /home/z/my-project --json
python3 scripts/cleanup_skills.py --skills "skill1,skill2" --workspace /home/z/my-project
python3 scripts/cleanup_skills.py --restore "技能名" --workspace /home/z/my-project
python3 scripts/cleanup_skills.py --list-backups --workspace /home/z/my-project
python3 scripts/manage_labels.py --skill 技能名 --validity long --workspace /home/z/my-project
python3 scripts/manage_labels.py --list --workspace /home/z/my-project

平台适配

• AgentMore：完整执行（扫描→备份→删除→恢复）
• Coze/Dify/其他：仅扫描+建议，告知"请在平台设置界面手动卸载"
• 未识别平台：仅扫描+建议，告知局限

详细平台兼容说明见 references/platform_compat.md

错误处理

感谢"小熊肖恩"对本技能包的技术贡献