# 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 还是继续调整