steipete/agent-scripts

解決的問題

本專案提供了一個集中式系統，用於管理 AI 代理（特別針對 Codex 和 Claude Code 量身定制）的共享指令、可重用技能和可攜式輔助腳本。它消除了在多個本地工作區和儲存庫之間手動複製規則和技能的需求，確保代理行為在不同專案中保持一致。

運作方式

該系統使用共享檔案和符號連結的組合來分發指令和技能：

• 共享指令： 中央 AGENTS.MD 檔案包含全域硬性規則。其他儲存庫透過指標式 AGENTS.MD 指向此檔案，以避免重複。
• 技能路由： 技能在 SKILL.md 檔案中定義，帶有用於路由的 YAML front matter。同步腳本（scripts/sync-skills）為不同代理建立必要的鏡像：Codex 的整根連結和 Claude Code 的扁平逐技能連結。
• 可攜式輔助工具： 依賴較少的腳本儲存在 scripts/ 和 hooks/ 中，以提供常見功能和代理護欄，例如技能驗證。

適用對象

在多個本地專案中使用 Claude Code 或 Codex 等 AI 代理，並希望集中管理代理技能和指令「知識庫」的開發人員。

亮點

• 多代理支援： 專門處理 Codex 和 Claude Code 所需的不同目錄結構。
• 冪等同步： sync-skills 腳本會修剪過時的連結，並避免覆蓋真實檔案。
• 技能驗證： 包含 validate-skills 腳本，用作 git hook 以確保技能定義正確。
• 瀏覽器工具： 包含一個獨立的 Chrome DevTools 輔助工具，用於代理驅動的瀏覽器自動化。