APM

>Agent Skill

@majiayu000/license-header-adder

skilldevelopment

為新建立的原始碼檔案加上標準的開源授權條款標頭。適用於需要版權聲明的程式碼檔案建立情境。

pythontypescriptjavascriptgojava
apm::install
$apm install @majiayu000/license-header-adder
apm::skill.md
---
name: license-header-adder
description: 為新建立的原始碼檔案加上標準的開源授權條款標頭。適用於需要版權聲明的程式碼檔案建立情境。
---

# 授權條款標頭 Skill

這個 Skill 確保所有新建立的原始碼檔案都有正確的版權標頭。

## 指示說明

1. **讀取範本**:首先,讀取位於 `resources/HEADER_TEMPLATE.txt` 的標頭範本檔案內容。
2. **加入檔案開頭**:當建立新檔案時(例如 `.py``.java``.js``.ts``.go`),將範本內容加到目標檔案的最開頭。
3. **調整註解語法**
   - 對於 C 風格語言(Java、JS、TS、C++),保持 `/* ... */` 區塊格式。
   - 對於 Python、Shell 或 YAML,將區塊轉換為使用 `#` 註解。
   - 對於 HTML/XML,使用 `<!-- ... -->` 格式。

## 使用時機

- 當建立新的程式碼檔案時
- 當需要為現有檔案補上授權條款標頭時
- 當專案需要統一的版權聲明格式時

## 範例

### 範例 1:為 Java 檔案加上授權條款

**使用者指令**:為 MyService.java 加上授權條款標頭

**AI 執行步驟**

1. 讀取 `resources/HEADER_TEMPLATE.txt` 內容
2. 將內容以 `/* ... */` 格式加到 Java 檔案開頭

---

### 範例 2:為 Python 檔案加上授權條款

**使用者指令**:為 utils.py 加上授權條款標頭

**AI 執行步驟**

1. 讀取 `resources/HEADER_TEMPLATE.txt` 內容
2. 將每行轉換為 `#` 開頭的註解
3. 加到 Python 檔案開頭

---

## 注意事項

- 範本內容必須**完全照抄**,不可修改任何文字
- 法律文字不可有任何錯字或遺漏
- 根據目標檔案的程式語言調整註解格式