sickn33/agentic-awesome-skills

AAS Core – 智能體酷技能（AAS）

是什麼

• 一個程式庫與命令列工具，讓大型語言模型代理（例如 OpenAI Codex、Anthropic Claude）搜尋本地目錄中的 2,115 個以上可重複使用的「技能」劇本，挑選專案所需的精確技能 ID，並產生一個機器可讀的清單（aas-stack.json），記錄這些選擇。
• 核心元件為唯讀：它驗證所選技能的 ID 與結構，但不進行排序、推薦或執行。獨立的 CLI 可預覽不可變的計畫，並可選擇性地將技能寫入本地目錄。

為何重要

• 代理在對程式碼庫採取行動時，通常需要具體的指示（例如 "腦力激盪"、"系統性除錯"）。AAS 提供一個穩定、可檢視的真相來源，讓同一組指示可被審查、版本控制，並在後續重現。
• 所有目錄檔案皆為純文字（SKILL.md），因此無需執行任何程式碼即可檢視，保持工作流程安全且離線。

核心概念

概念	作用
目錄	包含 SKILL.md 檔案的目錄，每個檔案描述一個可重複使用的指令集。
MCP（模型-控制平面）	一個本地、唯讀的服務，公開 search_skills、get_skill、compose_stack 等指令，供 LLM 呼叫。
代理擁有組合	LLM（Codex 或 Claude）決定使用哪些技能 ID；AAS 僅驗證清單。
aas-stack.json	記錄目標專案所選技能 ID 的 JSON 清單。
選擇證據	可選的側車檔案（aas-selection-evidence.json），記錄每個技能被選擇的原因。
CLI	aas stack validate 檢查清單；aas stack plan 建立唯讀計畫；aas stack install-preview 可乾運行直接安裝器。
工作台	僅瀏覽器的 UI，載入清單與計畫供人工審查；從不寫入檔案系統。

典型工作流程

1. 設定本地 MCP（預覽指南說明如何啟動）。
2. 讓 LLM（Codex/Claude）檢查你的倉儲，並使用 MCP 搜尋相關技能。
3. 模型回傳技能 ID 清單（例如 brainstorming、systematic-debugging）。
4. MCP 執行 compose_stack 以驗證這些 ID 是否存在且符合結構限制（最多 128 個技能）。
5. 客戶端或 aas CLI 寫入 aas-stack.json（並可選寫入證據檔案）。
6. 執行 aas stack validate 以再次檢查清單，然後執行 aas stack plan 以查看目標的不可變計畫。
7. （可選）使用直接安裝器（npx agentic-awesome-skills … --dry-run）預覽將選定的技能目錄複製到 ~/.agents/skills。
8. 人工批准後，重複安裝命令不帶 --dry-run 以實際部署技能。

安裝與入口點

• npm 套件：npm exec --yes --ignore-scripts --package=agentic-awesome-skills@<version> -- agentic-awesome-skills …
• npx 快捷方式：npx agentic-awesome-skills --skills <逗號分隔清單> --dry-run（預覽）或 --antigravity 用於 Antigravity 風格目標。
• GitHub CLI（預覽）：gh skill preview … / gh skill install … 用於單一技能。
• 安裝器執行倉儲的淺層部分克隆，驗證提交哈希與 npm 套件元資料一致，並僅複製請求的技能目錄。

專用外掛

• 倉儲附帶預先打包的外掛套件（例如 Web App Builder、Security Engineer、DevOps & Cloud），將特定領域的相關技能分組。
• 外掛以 Claude-Code 與 Codex 相容格式產生，並公開標準的 Agent Plugins 1.0 清單。

安全與限制

• AAS 不執行任何技能程式碼；僅複製檔案。
• 核心不認證語意適用性——LLM 的選擇可能仍不適合你的環境。
• 某些技能被標記為 關鍵 或 攻擊性；安裝器會列印風險摘要，並要求顯式同意（--all）才能拉取完整目錄。
• 應用/恢復功能標記為 實驗性，在支援的預覽中已停用。

何時使用

• 你擁有 LLM 驅動的開發流程，希望獲得一個可重現、可審計的指令清單，供模型執行。
• 你需要在任何檔案寫入前審查模型選擇的內容（合規、安全或團隊審查情境）。
• 你希望在專案或團隊成員之間分享一個經過篩選的技能集，而不依賴遠端服務。

何時不適合

• 如果你只需要對 skills/ 目錄進行簡單的關鍵字搜尋，AAS 會增加額外的驗證與清單處理，可能非必要。
• 需要自動執行技能的專案（例如 CI/CD 執行器）必須自行建構執行器；AAS 僅提供靜態指示。

進一步了解

• 使用者指南：docs/users/aas-core.md（信任邊界、MCP 設定、CLI 生命週期）。
• 工作流程與案例研究：docs/users/workflows.md。
• 安全與審計：docs/users/security-and-antivirus.md。
• 外掛目錄：plugins/ 目錄及托管的首頁 https://sickn33.github.io/agentic-awesome-skills/plugins。

---

總結：AAS Core 是一個預覽階段的本地執行工具包，允許 AI 代理從一個大型、可檢視的可重複使用指令「技能」庫中選擇，並將這些選擇記錄在可重現的清單中。它面向希望在保留完全審計性與控制權的同時，利用 LLM 驅動自動化能力的團隊。