Files
ClawSkills/claw-skills/workflows/improve-skills.md

1.2 KiB
Raw Blame History

improve-skills

当发现现有 skill 或 workflow 存在以下问题时使用:

  • 有误导或歧义
  • 没有覆盖到你的使用情景
  • 效果不理想

原则

改进比 work-around 更好。发现问题时及时修正,避免后续其他人踩同样的坑。

流程

1. 识别问题

  • 记录哪个 skill 的哪个部分有问题
  • 具体描述:哪里误导、哪里缺失、哪里效果差
  • 记录触发场景:什么情况下发现这个问题

2. 评估影响范围

  • 这个问题会影响多少人?
  • 是 skill 设计问题还是描述/文档问题?
  • 修复复杂度如何?

3. 确定改进方案

  • 文档问题 → 改 SKILL.md 或相关描述
  • 逻辑缺陷 → 修改脚本或 skill 逻辑
  • 覆盖缺失 → 新增流程或脚本
  • 流程不顺 → 重新设计 workflow

4. 执行改进

  • 在本地或分支上修改
  • 更新 SKILL.md如果改了描述
  • 如果改动较大,先在本地测试

5. 提交

  • 按 promote-improvements 流程提交到自己的分支
  • commit message 说明改进内容
  • 附上问题描述和解决思路(便于 hang review

6. 通知 hang

  • 完成后告知 hang说明改了什么、为什么改
  • 让 hang 决定是 merge 还是继续调整