---
name: cantonese-command-parser
description: Parse and execute commands given in Cantonese. Use when user gives instructions or requests actions in Cantonese. Translates Cantonese commands to executable actions.
---

# 粵語指令解析技能 (Cantonese Command Parser Skill)

當用戶用粵語發出指令時，使用此技能解析並執行相應操作。

## 觸發條件

當用戶輸入包含以下粵語指令模式時啟用：
- 動作請求：「幫我...」、「我想...」、「可唔可以...」
- 直接指令：「開個...」、「寫個...」、「搵下...」
- 查詢請求：「...係乜嘢」、「點樣...」、「邊度有...」

## 指令模式識別

### 文件操作
| 粵語指令 | 意圖 | 對應操作 |
|----------|------|----------|
| 開個檔案 | 打開/創建文件 | Read / Write |
| 睇下個檔 | 查看文件 | Read |
| 改下個檔 | 編輯文件 | Edit |
| 刪咗佢 | 刪除文件 | Bash rm |
| 搵個檔案 | 查找文件 | Glob / Grep |
| 寫入去 | 寫入內容 | Write / Edit |

### 代碼操作
| 粵語指令 | 意圖 | 對應操作 |
|----------|------|----------|
| 寫段 code | 編寫代碼 | Write |
| 改下段 code | 修改代碼 | Edit |
| 跑下個程式 | 運行程序 | Bash |
| 裝個 package | 安裝依賴 | Bash npm/pip |
| 測試下 | 運行測試 | Bash test |
| debug 下 | 調試 | Read / Bash |

### 搜索查詢
| 粵語指令 | 意圖 | 對應操作 |
|----------|------|----------|
| 搵下 | 搜索 | Grep / Glob |
| 有冇... | 檢查存在 | Glob / Grep |
| 喺邊度 | 定位位置 | Glob / Grep |
| 查下 | 查詢信息 | WebSearch / WebFetch |

### 系統操作
| 粵語指令 | 意圖 | 對應操作 |
|----------|------|----------|
| 開個 terminal | 執行命令 | Bash |
| 裝嘢 | 安裝 | Bash |
| 行個 command | 運行命令 | Bash |
| 睇下 status | 查看狀態 | Bash / Read |

### Git 操作
| 粵語指令 | 意圖 | 對應操作 |
|----------|------|----------|
| commit 咗佢 | 提交 | Bash git commit |
| push 上去 | 推送 | Bash git push |
| pull 返嚟 | 拉取 | Bash git pull |
| 開個 branch | 創建分支 | Bash git branch |
| merge 埋佢 | 合併 | Bash git merge |

## 常見指令句式

### 請求幫助
```
「幫我 [動作] [對象]」
例：幫我寫個 function → 請求編寫函數

「我想 [動作] [對象]」
例：我想睇下個 log → 請求查看日誌

「可唔可以 [動作]」
例：可唔可以 run 下 tests → 請求運行測試
```

### 直接指令
```
「[動作] 下 [對象]」
例：睇下個 file → 查看文件

「[動作] 咗 [對象]」
例：刪咗個 temp folder → 刪除臨時文件夾

「將 [對象] [動作]」
例：將個 bug fix 咗 → 修復 bug
```

### 查詢
```
「[對象] 係乜嘢」
例：呢個 error 係乜嘢 → 詢問錯誤含義

「點樣 [動作]」
例：點樣 deploy → 詢問如何部署

「[對象] 喺邊度」
例：config file 喺邊度 → 查找配置文件位置
```

## 解析流程

1. **識別指令類型**: 判斷是文件操作、代碼操作、搜索還是系統操作
2. **提取對象**: 識別操作的目標（文件名、代碼片段、搜索詞等）
3. **確認參數**: 如有需要，詢問缺失的參數
4. **執行操作**: 調用相應的工具執行任務
5. **粵語回應**: 用粵語報告結果

## 輸出格式

解析完成後：

```
【指令解析】
原文: [用戶原始指令]
類型: [操作類型]
動作: [具體動作]
對象: [操作目標]
參數: [額外參數]

執行: [調用的工具和參數]
```

## 示例

用戶輸入：「幫我搵下邊度用咗 deprecated API」

解析結果：
```
【指令解析】
原文: 幫我搵下邊度用咗 deprecated API
類型: 搜索查詢
動作: 搜索
對象: deprecated API 的使用位置
參數: 無

執行: Grep 工具搜索 "deprecated" 或相關模式
```

回應：「冇問題，我幫你搵下...」然後執行搜索並報告結果。


---
Source attribution: NewJerseyStyle
Original project: https://github.com/NewJerseyStyle/cant-agent/blob/5fe10fb4237864f2a03825252b522bc32eb853dd/skills/cantonese-command-parser/SKILL.md
License: MIT
License information: https://opensource.org/license/mit
Original upstream instructions; downloaded from Dave AI.

## Upstream license notice

MIT License

Copyright (c) 2026 David H.

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.



# Dave AI resource metadata

Creator / publisher: NewJerseyStyle
Original project: https://github.com/NewJerseyStyle/cant-agent/blob/5fe10fb4237864f2a03825252b522bc32eb853dd/skills/cantonese-command-parser/SKILL.md
Attribution basis: Recovered original package and original project license at a pinned revision

Fields of work: Sales, Customer Support
Roles: Customer Success Manager, Support Agent, Technical Support
Specialties: API
Tools: Command Line Tools
Country applicability: Country not specified
Classification basis: Source catalog labels
Instruction SHA-256: 3518c6cecf126efa5e4d1752498cd2ea9db7fb8377425bbb541e7767cb4b0190
Metadata reviewed: 2026-10-27
This metadata supersedes earlier Dave AI catalog attribution. Original instruction and supporting files are preserved.