DenisSergeevitch/agents-best-practices
Provider-neutral Agent Skill for Codex, Claude Code, and agentic harness design.
解決的問題
本專案提供一個結構化的框架與一組最佳實務，用於建構「智能體 harness」——即包圍 AI 模型的執行環境，使其安全、可靠且適合生產環境。它解決了賦予智能體自主性以執行有用工作，與防止模型在現實系統中成為未經審計、不安全的操作者之間的矛盾。
如何運作
不依賴提示式安全機制，本專案定義了一個嚴謹的控制平面，其中模型僅提出操作建議，而應用程式程式碼（harness）負責驗證、授權與執行。它提供一個全面的參考文件庫，涵蓋以下內容：
- 智能體循環：管理重試、預算（時間、成本、令牌）與終止規則。
- 工具治理：使用窄範圍、類型化的工具以及基於風險的權限等級（例如，分離讀取、草稿與破壞性寫入）。
- 上下文管理：保留活躍狀態的檢索、記憶與自動壓縮策略。
- 高階架構：MVP 智能體、遞迴 harness 與預測性工具執行的藍圖。
- 環境適應：讓智能體在陌生環境中安全發現並綁定工具的方法。
適用對象
為各領域（包括程式碼撰寫、研究、支援、運維、銷售、金融與醫療）建構 AI 智能體的開發者與架構師，他們需要從簡單原型進階至生產安全系統。
亮點
- 供應商中立：適用於不同 LLM 供應商（如 OpenAI、Anthropic 等）。
- 基於風險的權限：強制區分自主讀取與需審批的寫入操作。
- 以 harness 為中心的理念：將安全性和可靠性責任從提示轉移至執行時程式碼。
- 全面的藍圖：包含 MVP 設計、現有 harness 審計以及實現長期目標的具體指南。
- 智能體技能整合：打包為與 Codex 和 Claude Code 兼容的可攜式「智能體技能」。
相關
- 專案
HoangNguyen0403/agent-skills-standardAgent Skills Standard (AGS) 是一個透過 NPM 分發的 CLI，讓團隊能將編碼標準、安全規則與 SDLC 工作流程範本發布為小型 Markdown「技能」。CLI（`ags init` / `ags sync`）建立 `.skillsrc` 設定檔，下載語言特定的技能套件（20 多個技術棧共 280 個技能），並撰寫分層路由（`AGENTS.md → _INDEX.md → SKILL.md`）。AI 編碼助手（Cursor、Claude Code、Copilot、Gemini 等）讀取此路由並僅載入與正在編輯的檔案相關的規則，節省約 85% 的提示 token。可選的 MCP 伺服器可強制執行鉤子、阻止密鑰洩漏編輯，並提供執行時審計日誌。此專案是真正的 AI 編碼助手實用工具，而非通用教學或清單。
- 專案
mohitagw15856/pm-claude-skillsPM Skills 是一個開源程式庫，包含 1 169 篇純文字 Markdown「代理技能」，可讓 Claude、ChatGPT、Gemini 等模型掌握具體、高階的專業與生活管理任務流程（例如：租約解碼、PRD 撰寫、薪資談判模擬）。這些技能為純文字 Markdown 檔案，內含框架、範本、檢查項目與反模式。可透過一行 `npx` 命令安裝，原生支援 Claude Code，或直接貼入其他代理的提示中。程式庫亦提供 npm/PyPI 套件、Docker 映像與整合（Telegram、Slack、Raycast、Obsidian、n8n）。網頁版 Playground 讓任何人無需安裝即可在瀏覽器中執行技能。
- 專案
shareAI-lab/learn-claude-code一個 17 課時的教學，教你如何為基於 LLM 的編碼代理（Claude）建構周圍的「框架」程式碼。它逐步說明如何加入工具、權限、上下文管理、記憶、任務排程、多代理協調以及目標驅動的終止機制，全部圍繞一個簡單的代理迴圈，讓模型自行決定何時呼叫工具。
- 專案
addyosmani/agent-skillsAgent Skills 是一個包含 25 個基於 Markdown 的工程工作流程（規格、計畫、建構、測試、審查、發佈等）的庫，可透過簡單 CLI 安裝至多種 AI 編碼代理中。它提供斜線命令、自動建構模式、專業角色和參考檢查清單，使 AI 生成的程式碼在整個開發生命週期中遵循資深工程師的最佳實踐。
- 專案
MoizIbnYousaf/ai-agent-skillsAI Agent Skills 是一款基於 npm 的 CLI/TUI 工具，內建了約 115 個經過精選的 AI 代理人「技能」（提示詞與程式碼組合），並按「架子」（前端、後端、行動端、工作流、代理人工程、行銷）進行分類。它讓您能夠瀏覽、搜尋、安裝，並管理本地的「自備副本」（house-copy）技能與僅含元數據的上游供應技能。您也可以透過 `init-library` 初始化個人庫、新增或編目上游技能、進行供應（vendor）操作、同步更新，並生成文件。它支援任何與 Agent-Skills 相容的代理人（Claude, Cursor, Gemini 等）以及多種安裝目標。對於想要擁有整潔、可搜尋的重複使用型 AI 代理人能力工具箱的開發者或團隊來說，這是理想之選。