skills

個人 Agent Skills 集合，收錄一系列可供支援此規範的 AI Agent（如 Claude Code）使用的技能（skill），涵蓋 Git 提交流程、SDD 開發流程、文件共筆、簡報流程設計與提示工程等場景。

這是什麼

Agent Skills 是一種讓 Agent 在符合特定情境時，載入額外指示與知識的機制，並非 Claude 專屬——任何實作此規範的 Agent 都能使用。每個技能是一個資料夾，內含 SKILL.md（frontmatter 定義 name / description，本文則是給 Agent 的操作指示），可視需要附上 references/ 等輔助資源。

本儲存庫把個人常用的技能集中管理、版本控制，方便跨專案複用，也歡迎其他人參考或直接採用。

技能清單

技能	說明
commit	根據目前工作區變更，完成一次符合 Conventional Commits 的 Git 提交（不 push、不建 PR）。
commit-push	完成 Conventional Commits 提交並推送到遠端（不建 PR）。
commit-push-pr	完成提交、推送，並建立 Pull Request，適合交付完整分支變更。
doc-coauthoring	引導使用者以結構化流程共筆文件（技術規格、提案、決策文件等）：脈絡蒐集 → 逐節細修 → 讀者測試。
gemma4-prompt-engineer	依據 Gemma 4 官方文件與知識庫，協助撰寫、最佳化與診斷 Gemma 4 提示詞（含控制符號、思考模式、多模態順序、工具呼叫格式等）。
implementation-orchestrator	將工程需求（bug / feature / refactor 等）轉為完整的實作流程：脈絡蒐集、實作計畫、複雜度分派、任務簡報、QA 驗證與交付更新。
merge-branch	以受控流程將一個本地分支合併到另一個分支：檢查狀態、抓取遠端、分析分歧、合併、依雙方意圖解衝突、跑驗證、回報結果。僅限本地 Git 操作，不處理 PR，不主動 push。
presentation-flow-writer	陪同共筆「簡報流程檔」——一份交給簡報生成 AI 代理使用的結構化輸入文件，而非逐字稿或投影片文案本身。
simple-sdd	輕量 SDD（Spec-Driven Development）流程：動手寫程式前先講清楚要做什麼，經確認才實作，一次只做一小步並逐步回報。

如何使用

將本儲存庫的 skills/ 底下的技能資料夾複製（或以符號連結方式放置）到你所使用的 Agent 讀取技能的路徑下即可。以 Claude Code 為例，可放在個人層級的 ~/.claude/skills/，或專案層級的 .claude/skills/；其他支援 Agent Skills 規範的工具，請依其文件放到對應目錄。之後在對話中符合技能觸發情境時，Agent 會自動載入對應的 SKILL.md；部分工具（如 Claude Code）也支援用 /<skill-name> 直接指定呼叫。

除了手動複製，也可以使用 npx skills 這個 CLI 工具來管理技能：

# 列出本儲存庫提供哪些技能
npx skills add cdcd72/skills --list

# 互動式選擇要安裝的技能
npx skills add cdcd72/skills

# 安裝指定技能（可重複 --skill 安裝多個）
npx skills add cdcd72/skills --skill commit --skill simple-sdd

# 安裝本儲存庫所有技能
npx skills add cdcd72/skills --all

# 列出目前已安裝的技能
npx skills list

# 更新已安裝的技能（可指定名稱只更新單一技能）
npx skills update

# 移除已安裝的技能
npx skills remove

預設會安裝到偵測到的 Agent 設定目錄（如 .claude/skills/），也可用 -a <agent> 指定目標 Agent、用 -g 指定安裝到全域（使用者層級）路徑。詳細用法請參考官方文件。

如何新增一個技能

1. 複製 template/SKILL.md 作為起點，建立 skills/<skill-name>/SKILL.md。
2. 填寫 frontmatter：
   • name：技能的唯一識別名稱（kebab-case）。
   • description：一句話說明技能用途，以及 Agent 應該在什麼情境下使用它——這是 Agent 判斷是否載入此技能的依據，務必具體。
3. 在本文撰寫技能的操作指示（角色定位、適用時機、執行步驟等）。若有需要，可新增 references/ 資料夾存放範例、範本或知識庫等輔助資源。
4. 完整的技能格式規範請參考 Agent Skills Spec。

授權

MIT License