skill-name/
├── SKILL.md          # 必要：指令與元資料
├── scripts/          # 選擇性：可執行腳本
├── references/       # 選擇性：參考文件
└── assets/           # 選擇性：範本、資源檔案

請幫我審查以下程式碼，注意：
1. 命名是否符合駝峰式
2. 是否有安全漏洞
3. 是否有效能問題
...

---
name: code-review
description: 審查 Java/Python 程式碼的品質、安全性與效能。當使用者提到程式碼審查、Code Review、PR Review 時使用此 Skill。
---

# 程式碼審查 Skill

## 審查流程
1. 命名規範檢查
2. 安全性掃描
3. 效能分析
...

anthropics/skills/
├── skills/                    # 範例 Skills
│   ├── creative/              # 創意類 Skills
│   ├── development/           # 開發類 Skills
│   ├── enterprise/            # 企業類 Skills
│   ├── docx/                  # Word 文件處理
│   ├── pdf/                   # PDF 處理
│   ├── pptx/                  # PowerPoint 處理
│   └── xlsx/                  # Excel 處理
├── spec/                      # Agent Skills 規格說明
├── template/                  # Skill 範本
└── README.md

skill-name/
├── SKILL.md              # 必要：指令與元資料
├── scripts/              # 選擇性：可執行腳本
│   └── process.py
├── references/           # 選擇性：參考文件
│   ├── REFERENCE.md
│   └── FORMS.md
└── assets/               # 選擇性：範本、資源
    └── template.docx

name: pdf-processing      # ✅
name: data-analysis       # ✅
name: code-review         # ✅
name: unit-test-gen       # ✅

name: PDF-Processing      # ❌ 包含大寫
name: -pdf                # ❌ 以連字號開頭
name: pdf-                # ❌ 以連字號結尾
name: pdf--processing     # ❌ 連續連字號
name: code review         # ❌ 包含空格

---
# === 必要欄位 ===
name: code-review
description: >
  審查 Java/Python/TypeScript 程式碼的品質、安全性與效能。
  當使用者提到程式碼審查、Code Review、PR Review 時使用此 Skill。

# === 選擇性欄位 ===
license: Apache-2.0
compatibility: Designed for Claude Code (or similar products)
metadata:
  author: your-org
  version: "1.0"
  category: development
allowed-tools: Bash(git:*) Read Write
---

# 程式碼審查 Skill

## 何時使用此 Skill
- 使用者要求審查程式碼
- PR Review 場景
- 程式碼品質檢查

## 審查步驟
1. 讀取程式碼檔案
2. 檢查命名規範
3. 識別安全漏洞
4. 分析效能問題
5. 產生審查報告

## 審查項目清單
- [ ] 命名是否符合規範
- [ ] 是否有未處理的例外
- [ ] 是否有 SQL Injection 風險
- [ ] 是否有硬編碼的密碼/金鑰

## 輸出格式
### 審查報告
- **嚴重度**：Critical / Major / Minor
- **位置**：檔案名稱:行號
- **說明**：問題描述
- **建議**：修正方式

# 1. 註冊 Skills Marketplace
/plugin marketplace add anthropics/skills

# 2. 安裝特定 Skill Plugin
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

請使用 PDF skill 從 contract.pdf 中提取表格資料

import anthropic

client = anthropic.Anthropic()

# 透過 API 使用 Skill
response = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    system="You have access to the code-review skill.",
    messages=[
        {"role": "user", "content": "請審查以下程式碼：..."}
    ]
)

---
name: requirement-document-generator
description: >
  將使用者需求或會議記錄轉換為結構化的需求文件（PRD/SRS）。
  當使用者提到「產生需求文件」、「撰寫 PRD」、「需求規格」時使用此 Skill。
---

# 需求文件產生 Skill

## 適用場景
- 將客戶訪談記錄轉為正式需求文件
- 從使用者故事產生詳細規格
- 產生 PRD（Product Requirements Document）
- 產生 SRS（Software Requirements Specification）

## 文件結構範本

### PRD 範本
1. **文件資訊**
   - 版本、日期、作者、審核者
2. **專案概述**
   - 背景、目標、範圍
3. **使用者角色**
   - 角色定義、權限矩陣
4. **功能需求**
   - 使用案例、驗收條件
5. **非功能需求**
   - 效能、安全性、可用性
6. **限制與假設**
7. **附錄**

## 產出流程
1. 分析輸入資料（會議記錄/使用者故事）
2. 識別 Stakeholders 與使用者角色
3. 提取功能需求並分類
4. 識別非功能需求
5. 套用範本產生文件
6. 產出待確認清單

## 品質檢查點
- [ ] 每個需求都有唯一編號
- [ ] 每個需求都可追溯至來源
- [ ] 驗收條件可測試、可量化
- [ ] 無模糊用語（避免「等等」、「應該」）

請根據以下會議記錄，產生一份 PRD 文件：

【會議記錄】
- 客戶希望在網銀 App 新增「定期定額投資」功能
- 使用者可以設定每月固定日期扣款
- 扣款金額範圍：1,000 ~ 100,000 元
- 需要支援多個投資標的同時進行
- 要有扣款失敗的通知機制

# 產品需求文件（PRD）

## 1. 文件資訊
| 項目 | 內容 |
|------|------|
| 版本 | 1.0 |
| 日期 | 2026-01-08 |
| 功能名稱 | 定期定額投資 |

## 2. 功能需求

### FR-001：設定定期定額計畫
- **描述**：使用者可建立定期定額投資計畫
- **驗收條件**：
  - AC-001-1：可選擇每月扣款日期（1-28 日）
  - AC-001-2：金額輸入範圍限制 1,000 ~ 100,000 元
  - AC-001-3：支援同時設定多個投資標的
...

---
name: code-review
description: >
  審查 Java/Python/TypeScript 程式碼的品質、安全性、效能與可維護性。
  當使用者提到「程式碼審查」、「Code Review」、「PR Review」、「重構建議」時使用此 Skill。
compatibility: Requires access to source code files
---

# 程式碼審查 Skill

## 審查維度

### 1. 命名規範
- 類別名稱：PascalCase
- 方法/變數：camelCase
- 常數：UPPER_SNAKE_CASE
- 是否具有描述性

### 2. 安全性檢查
- SQL Injection
- XSS（Cross-Site Scripting）
- 硬編碼敏感資訊（密碼、API Key）
- 不安全的反序列化
- 路徑遍歷漏洞

### 3. 效能問題
- N+1 查詢
- 迴圈內的資料庫操作
- 不必要的物件建立
- 未關閉的資源（Connection、Stream）

### 4. 可維護性
- 方法長度（建議 < 30 行）
- 類別長度（建議 < 300 行）
- 圈複雜度（建議 < 10）
- 重複程式碼

## 審查報告格式

審查報告應包含以下結構：

**報告範本**：

| 區塊 | 內容 |
|------|------|
| **摘要** | 審查檔案數、各嚴重度問題數量 |
| **Critical 問題** | 位置、問題描述、修正建議 |
| **Major 問題** | 位置、問題描述、修正建議 |
| **Minor 問題** | 位置、問題描述、修正建議 |

**輸出範例**：

## 重構建議原則
1. 每次只做一種重構
2. 重構前確保有測試覆蓋
3. 遵循 SOLID 原則
4. 保持向後相容（如為 API）

請審查以下程式碼：

public class UserService {
    public User getUser(String id) {
        String sql = "SELECT * FROM users WHERE id = '" + id + "'";
        Connection conn = DriverManager.getConnection(url, "admin", "password123");
        // ... 執行查詢
    }
}

## 程式碼審查報告

### 摘要
- 發現問題數：Critical: 2, Major: 1, Minor: 0

### 🔴 Critical

| 位置 | 問題 | 建議 |
|------|------|------|
| UserService.java:3 | **SQL Injection 漏洞** - 直接拼接使用者輸入 | 改用 PreparedStatement：`"SELECT * FROM users WHERE id = ?"` |
| UserService.java:4 | **硬編碼密碼** - 資料庫密碼直接寫在程式碼中 | 改用環境變數或設定檔（加密儲存） |

### 🟡 Major

| 位置 | 問題 | 建議 |
|------|------|------|
| UserService.java:4 | **資源未關閉** - Connection 未使用 try-with-resources | 使用 `try (Connection conn = ...) { }` |

---
name: test-case-generator
description: >
  為 Java/Python/TypeScript 程式碼產生單元測試案例。
  當使用者提到「產生測試」、「寫測試」、「Unit Test」、「測試案例」時使用此 Skill。
compatibility: Designed for projects using JUnit 5, pytest, or Jest
---

# 測試案例產生 Skill

## 支援的測試框架
| 語言 | 框架 | 版本 |
|------|------|------|
| Java | JUnit 5 | 5.x |
| Python | pytest | 7.x |
| TypeScript | Jest | 29.x |

## 測試設計原則

### AAA 模式
```java
@Test
void shouldReturnUserWhenIdExists() {
    // Arrange（準備）
    String userId = "user-123";
    User expectedUser = new User(userId, "John");
    when(userRepository.findById(userId)).thenReturn(Optional.of(expectedUser));
    
    // Act（執行）
    User actualUser = userService.getUser(userId);
    
    // Assert（驗證）
    assertEquals(expectedUser, actualUser);
}

package com.example.service;

import org.junit.jupiter.api.*;
import org.junit.jupiter.api.extension.ExtendWith;
import org.mockito.*;
import org.mockito.junit.jupiter.MockitoExtension;
import static org.junit.jupiter.api.Assertions.*;
import static org.mockito.Mockito.*;

@ExtendWith(MockitoExtension.class)
@DisplayName("UserService 測試")
class UserServiceTest {

    @Mock
    private UserRepository userRepository;
    
    @InjectMocks
    private UserService userService;
    
    @Nested
    @DisplayName("getUser 方法")
    class GetUserTests {
        
        @Test
        @DisplayName("當使用者存在時，應回傳使用者")
        void shouldReturnUserWhenUserExists() {
            // Arrange
            // Act
            // Assert
        }
        
        @Test
        @DisplayName("當使用者不存在時，應拋出例外")
        void shouldThrowExceptionWhenUserNotFound() {
            // Arrange
            // Act & Assert
        }
    }
}

#### 實際使用示意

**使用者 Prompt**：

**Agent 輸出**：
```java
package com.example;

import org.junit.jupiter.api.*;
import static org.junit.jupiter.api.Assertions.*;

@DisplayName("Calculator 測試")
class CalculatorTest {

    private Calculator calculator;

    @BeforeEach
    void setUp() {
        calculator = new Calculator();
    }

    @Nested
    @DisplayName("add 方法")
    class AddTests {

        @Test
        @DisplayName("正數相加應回傳正確結果")
        void shouldReturnSumWhenAddingPositiveNumbers() {
            // Arrange
            int a = 5, b = 3;
            
            // Act
            int result = calculator.add(a, b);
            
            // Assert
            assertEquals(8, result);
        }

        @Test
        @DisplayName("負數相加應回傳正確結果")
        void shouldReturnSumWhenAddingNegativeNumbers() {
            assertEquals(-8, calculator.add(-5, -3));
        }

        @Test
        @DisplayName("加零應回傳原數")
        void shouldReturnSameNumberWhenAddingZero() {
            assertEquals(5, calculator.add(5, 0));
            assertEquals(0, calculator.add(0, 0));
        }
    }

    @Nested
    @DisplayName("divide 方法")
    class DivideTests {

        @Test
        @DisplayName("正常除法應回傳正確結果")
        void shouldReturnQuotientWhenDividingValidNumbers() {
            assertEquals(2, calculator.divide(6, 3));
        }

        @Test
        @DisplayName("除以零應拋出 IllegalArgumentException")
        void shouldThrowExceptionWhenDividingByZero() {
            // Act & Assert
            IllegalArgumentException exception = assertThrows(
                IllegalArgumentException.class,
                () -> calculator.divide(10, 0)
            );
            assertEquals("除數不能為零", exception.getMessage());
        }

        @Test
        @DisplayName("整數除法應回傳整數結果（無條件捨去）")
        void shouldReturnTruncatedResultForIntegerDivision() {
            assertEquals(3, calculator.divide(10, 3));
        }
    }
}

# 不好的設計 - 職責過多
name: everything-developer
description: 處理所有開發任務，包括需求分析、設計、編碼、測試、部署、監控...

# 不好的設計 - 過於瑣碎
name: add-semicolon
description: 在程式碼結尾加上分號

name: code-review
description: >
  審查程式碼的品質、安全性與效能。
  包含命名規範、安全漏洞、效能問題、可維護性等面向的檢查。

# 錯誤 - 這是一次性任務，不是可重用的 Skill
name: fix-bug-123
description: 修復 Issue #123 的空指標例外問題
---

1. 開啟 UserService.java
2. 在第 42 行加入 null 檢查
3. 提交變更

name: null-safety-check
description: >
  檢查 Java 程式碼中的空指標風險，並提供修正建議。
---

## 檢查項目
1. 方法參數是否有 null 檢查
2. 外部 API 回傳值是否有處理 null
3. 集合操作前是否確認非空

## 修正模式
- 使用 Optional
- 使用 Objects.requireNonNull
- 使用 @NonNull 註解

description: >
  [做什麼] 審查程式碼的品質、安全性與效能。
  [何時用] 當使用者提到「程式碼審查」、「Code Review」、「PR Review」時使用。
  [支援什麼] 支援 Java、Python、TypeScript 語言。

| 嚴重度 | 位置 | 問題 | 建議 |
|--------|------|------|------|
| 🔴 Critical | {檔案:行號} | {問題描述} | {修正建議} |

company-skills/
├── README.md                    # 總覽說明
├── CONTRIBUTING.md              # 貢獻指南
├── development/                 # 開發類 Skills
│   ├── code-review/
│   ├── test-generator/
│   └── refactoring/
├── documentation/               # 文件類 Skills
│   ├── api-doc/
│   └── requirement-doc/
├── compliance/                  # 合規類 Skills（銀行業重要）
│   ├── security-audit/
│   └── data-masking/
└── templates/                   # Skill 範本
    └── skill-template/

metadata:
  author: your-team
  version: "1.2.0"
  changelog: |
    1.2.0 - 新增 TypeScript 支援
    1.1.0 - 改善安全性檢查
    1.0.0 - 初始版本