quick-fix

# Plugin 快速修正

當使用 test 開頭的 command、skill、agent 進行測試時，若使用者提出改善建議，立即定位並調整 `.claude` 目錄中對應的 md 檔案。

## 核心功能

- 快速識別當前測試的 plugin 和相關檔案
- 根據使用者回饋定位需要修改的 md 檔案
- 立即進行修正並驗證
- 提供修改前後的對比說明

## 執行步驟

### 1. 確認測試中的 Plugin

當使用者在測試過程中提出改善觀點時：

1. **識別目標 Plugin**
   - 從對話脈絡中確認正在測試的 plugin 名稱
   - 如果不明確，使用 AskUserQuestion 詢問：
     - 正在測試哪個 plugin？
     - 是測試 agent、command 還是 skill？
     - 具體是哪個檔案？

2. **定位目標檔案**
   - Agent: `plugins/{plugin-name}/agents/{agent-name}.md`
   - Command: `plugins/{plugin-name}/commands/{command-name}.md`
   - Skill: `plugins/{plugin-name}/skills/{skill-name}/SKILL.md`

### 2. 讀取並分析當前內容

1. **使用 Read tool 讀取目標檔案**
   ```
   Read: plugins/{plugin-name}/{type}/{name}/檔案.md
   ```

2. **分析使用者的改善觀點**
   - 理解使用者反映的問題點
   - 確認需要修改的具體區塊
   - 思考最佳的修改方式

3. **確認修改範圍**
   - 如果使用者的意見很明確，直接進行修改
   - 如果需要澄清，使用 AskUserQuestion 確認：
     - 具體要修改哪個章節？
     - 要新增內容還是修改現有內容？
     - 修改的幅度如何？

### 3. 執行修改

1. **使用 Edit tool 進行修改**
   - 精確定位需要修改的區塊
   - 使用 old_string 和 new_string 進行替換
   - 保持檔案格式的一致性（YAML Front Matter、Markdown 格式）

2. **注意事項**
   - 保持 YAML Front Matter 的完整性
   - 維持原有的文件結構
   - 確保修改後的內容符合 Markdown 格式
   - 檔案結尾保留一個空行

3. **多處修改**
   - 如果需要修改多處，一次性處理
   - 保持修改的邏輯一致性

### 4. 驗證與確認

1. **重新讀取檔案**
   - 使用 Read tool 確認修改結果
   - 檢查是否有格式錯誤

2. **向使用者說明修改內容**
   - 清楚說明修改了哪些部分
   - 解釋修改的理由和預期效果
   - 提供修改前後的對比（如果必要）

3. **詢問是否需要繼續測試**
   - 確認使用者是否滿意修改
   - 是否需要再次測試功能
   - 是否還有其他需要調整的地方

## 使用場景

### 適用情境

1. **測試 Agent 時**
   - Agent 的提示詞不夠明確
   - Agent 的執行步驟需要調整
   - Agent 的範例需要更新

2. **測試 Command 時**
   - Command 的說明不清楚
   - Command 的參數說明需要補充
   - Command 的執行邏輯需要修正

3. **測試 Skill 時**
   - Skill 的工作流程需要優化
   - Skill 的注意事項需要補充
   - Skill 的範例需要修正

### 典型工作流程

```
[使用者正在測試某個 skill]

User: 我發現這個 skill 的步驟 3 說明不夠清楚，
      應該要先執行 git status 再決定要用哪個策略。

Agent: 我會立即修正這個 skill 的 SKILL.md 檔案。

[使用 Read tool 讀取當前的 SKILL.md]
[使用 Edit tool 修改步驟 3 的內容]

Agent: 已修改 plugins/git/skills/resolving-conflict/SKILL.md:42
       - 在步驟 3 開頭新增「先執行 git status 確認狀態」的說明
       - 補充不同狀態下的處理策略