steipete/agent-scripts

解决的问题

该项目提供了一个集中式系统，用于管理AI代理（特别针对Codex和Claude Code定制）的共享指令、可复用技能和便携式辅助脚本。它消除了在多个本地工作区和仓库之间手动复制规则和技能的需要，确保代理行为在不同项目中保持一致。

工作原理

该系统使用共享文件和符号链接的组合来分发指令和技能：

• 共享指令： 中央AGENTS.MD文件包含全局硬性规则。其他仓库通过指针式AGENTS.MD指向此文件，以避免重复。
• 技能路由： 技能在SKILL.md文件中定义，带有用于路由的YAML前置元数据。同步脚本（scripts/sync-skills）为不同代理创建必要的镜像：Codex的整根链接和Claude Code的扁平逐技能链接。
• 便携式辅助工具： 依赖较少的脚本存储在scripts/和hooks/中，以提供常见功能和代理护栏，例如技能验证。

适用人群

在多个本地项目中使用Claude Code或Codex等AI代理，并希望集中管理代理技能和指令“知识库”的开发人员。

亮点

• 多代理支持： 专门处理Codex和Claude Code所需的不同目录结构。
• 幂等同步： sync-skills脚本会修剪过时的链接，并避免覆盖真实文件。
• 技能验证： 包含validate-skills脚本，用作git钩子以确保技能定义正确。
• 浏览器工具： 包含一个独立的Chrome DevTools辅助工具，用于代理驱动的浏览器自动化。