何时建Skill
- ✅ 任务首次成功完成，涉及5步以上（说明值得固化）
- ✅ 任务中遇到并解决了非显而易见的问题（需要记录pitfalls）
- ✅ 用户纠正了你的做法，新做法应该被记住（避免下次再错）
- ✅ 这个流程明确会重复出现
如何正确更新Skill（patch而非全量重写）
更新Skill应该只改变需要改变的部分，不要全量重写，因为全量重写容易丢失之前积累的pitfalls。
# ✅ 正确：patch方式更新
skill_manage(
action='patch',
name='stock-technical-analysis',
old_string='baostock需要login()',
new_string='baostock需要login()；login后要检查返回值error_code==0'
)
# ❌ 错误：用edit全量重写，容易丢掉已有的pitfalls何时废弃Skill
- ✅ 功能被合并到另一个更通用的Skill（使用absorbed_into参数）
- ✅ 使用的外部API已经停止服务
- ✅ 业务场景彻底消失，不会再用
- ❌ 不要因为"很久没用了"就删除 — 也许以后还会用
absorbed_into参数的正确用法
# 当stock-basic-analysis被合并进stock-daily-analysis时
skill_manage(
action='delete',
name='stock-basic-analysis',
absorbed_into='stock-daily-analysis' # 说明内容已合并到哪里
)
# 当真正废弃（没有合并目标）时
skill_manage(
action='delete',
name='old-deprecated-skill',
absorbed_into='' # 空字符串表示彻底废弃
)团队共享Skill的命名规范
- 格式：
领域-功能-动词，如stock-technical-analysis - 全小写，用连字符分隔，不用下划线
- 名称清晰表达功能，避免缩写
- 类别用
category字段组织，而不是放在名称里
目录组织建议
skills/
├── finance/ # 金融相关
│ ├── stock-technical-analysis/
│ └── stock-daily-analysis/
├── hermes/ # Hermes系统相关
│ ├── hermes-platform-integration/
│ └── hermes-custom-provider-setup/
└── productivity/ # 效率工具
├── ai-weekly-digest/
└── ai-learning-plan/Skill是活的文档，不是静态配置。遇到新问题就更新Pitfalls，遇到更好的做法就patch步骤。让Skill随着实践不断进化，才能真正节省未来的时间。