/skill-create - 本地技能生成

分析儲存庫的 Git 歷史紀錄，以擷取程式碼開發模式並生成 SKILL.md 檔案，用來教導 Claude 熟悉您團隊的開發實踐。

使用方式

/skill-create                    # 分析目前的儲存庫
/skill-create --commits 100      # 分析最近 100 次提交 (Commits)
/skill-create --output ./skills  # 指定輸出目錄
/skill-create --instincts        # 同時為 continuous-learning-v2 生成直覺 (Instincts)

功能說明

解析 Git 歷史 - 分析提交、檔案變動與模式。
偵測開發模式 - 識別重複出現的工作流與慣例。
生成 SKILL.md - 建立有效的 Claude Code 技能檔案。
選擇性建立直覺 - 用於 continuous-learning-v2 系統。

分析步驟

步驟 1：獲取 Git 數據

# 獲取最近的提交及其檔案變動
git log --oneline -n ${COMMITS:-200} --name-only --pretty=format:"%H|%s|%ad" --date=short

# 按檔案統計提交頻率
git log --oneline -n 200 --name-only | grep -v "^$" | grep -v "^[a-f0-9]" | sort | uniq -c | sort -rn | head -20

# 獲取提交訊息模式
git log --oneline -n 200 | cut -d' ' -f2- | head -50

步驟 2：偵測模式

尋找以下類型的模式：

模式	偵測方法
提交慣例	對提交訊息進行 Regex 匹配 (feat:, fix:, chore:)
檔案關聯變動	總是同時被修改的檔案群組
工作流序列	重複出現的檔案修改模式
架構慣例	資料夾結構與命名規範
測試模式	測試檔案位置、命名、覆蓋率

步驟 3：生成 SKILL.md

輸出格式範例：

---
name: {repo-name}-patterns
description: 從 {repo-name} 擷取的開發模式
version: 1.0.0
source: local-git-analysis
analyzed_commits: {count}
---

# {Repo Name} 開發模式

## 提交慣例
{偵測到的提交訊息模式}

## 程式架構
{偵測到的資料夾結構與組織方式}

## 工作流
{偵測到的重複性檔案變動模式}

## 測試模式
{偵測到的測試慣例}

步驟 4：生成直覺 (若包含 --instincts)

用於 continuous-learning-v2 整合：

---
id: {repo}-commit-convention
trigger: "當撰寫提交訊息時"
confidence: 0.8
domain: git
source: local-repo-analysis
---

# 使用約定式提交 (Conventional Commits)

## 行動
在提交訊息前加上：feat:, fix:, chore:, docs:, test:, refactor:

## 證據
- 分析了 {n} 次提交
- {percentage}% 遵循約定式提交格式

輸出範例

在 TypeScript 專案中執行 /skill-create 可能會產出：

---
name: my-app-patterns
description: 來自 my-app 儲存庫的開發模式
version: 1.0.0
source: local-git-analysis
analyzed_commits: 150
---

# My App 開發模式

## 提交慣例

此專案使用 **約定式提交 (Conventional Commits)**：
- `feat:` - 新功能
- `fix:` - 錯誤修復
- `chore:` - 維護任務
- `docs:` - 文件更新

## 程式架構

src/ ├── components/ # React 元件 (PascalCase.tsx) ├── hooks/ # 自定義 Hooks (use*.ts) ├── utils/ # 工具函式 ├── types/ # TypeScript 型別定義 └── services/ # API 與外部服務


## 工作流

### 新增元件
1. 建立 `src/components/ComponentName.tsx`
2. 在 `src/components/__tests__/ComponentName.test.tsx` 加入測試
3. 從 `src/components/index.ts` 匯出

### 資料庫遷移
1. 修改 `src/db/schema.ts`
2. 執行 `pnpm db:generate`
3. 執行 `pnpm db:migrate`

## 測試模式

- 測試檔案：`__tests__/` 目錄或 `.test.ts` 字尾
- 覆蓋率目標：80% 以上
- 框架：Vitest

GitHub App 整合

針對進階需求 (1 萬次以上提交、團隊共享、自動 PR)，請使用 Skill Creator GitHub App：

安裝連結：github.com/apps/skill-creator
在任何 Issue 中留言 /skill-creator analyze
即可收到包含生成技能的 PR

4.5 KiB Raw Blame History Unescape Escape