50 lines
1.2 KiB
Markdown
50 lines
1.2 KiB
Markdown
# 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 还是继续调整
|