Agent Scripts — 共享代理指令与技能
面向 Codex 和 Claude Code 的共享代理规则、可复用技能与轻量辅助脚本。
- Star 数
- ★ 7.5k
- 最近更新
- 12 天前
- License
- MIT
- 主语言
- Shell
- FA 评分
- 55/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用Codex · Claude Code
- 费用
- 免费,无需付费服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 使用 Codex 或 Claude Code 的开发者希望统一不同仓库的代理规则,采用指针式 AGENTS.MD 引用共享文件。
- 不适合
- Windows 或 Linux 用户:仓库面向 macOS,需手动调整
- 希望开箱即用的团队:依赖 ~/Projects/agent-scripts 等绝对路径
- 不使用 Codex 或 Claude Code 的开发者:技能镜像与规则专为这两者设计
- 官网
- steipete.me ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-10-30最新版本 0.12.0(2026-07-17)近 7 天每天 +5.3 ★
- 源码审查
- 55/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
Agent Scripts 是 Peter 个人工作区的规范仓库,集中管理共享的代理指令、可复用技能和便携式辅助脚本。仓库包含 AGENTS.MD(硬性规则)、skills/(按 SKILL.md 路由的工作流)、scripts/(无依赖依赖的辅助),以及 hooks/(本地防护)。核心机制通过 scripts/sync-skills 构建跨机器的技能镜像,支持 Codex 和 Claude Code 的发现,并维护指向共享 AGENTS.MD 的符号链接。同时提供 scripts/validate-skills 校验技能元数据,以及 browser-tools.ts 等独立工具。主要面向希望以一致方式配置本地开发代理的开发者。
仓库包含共享的 AGENTS.MD 硬性规则,通过符号链接安装到 ~/.codex/AGENTS.md、~/.claude/CLAUDE.md 和 ~/.claude/AGENTS.md。scripts/sync-skills 脚本为 Codex 创建整个根的技能链接(~/.codex/skills/agent-scripts 等),为 Claude Code 创建扁平的单技能链接(~/.claude/skills/<name>/SKILL.md),并处理名称冲突和修剪失效链接。scripts/validate-skills 检查每个 skills/*/SKILL.md 的 YAML front matter 及必填的 name 和 description 字段,可配置为 git 钩子。scripts/docs-list.ts 遍历 docs/ 并强制要求 summary 和 read_when 字段。scripts/browser-tools.ts 提供 Chrome DevTools 辅助,支持 start --profile、nav <url>、eval '<js>' 等命令。
- 使用 Codex 或 Claude Code 的开发者希望统一不同仓库的代理规则,采用指针式 AGENTS.MD 引用共享文件。
- 在多个工作站之间同步技能和指令,通过运行 scripts/sync-skills 自动创建符号链接。
- 希望为技能添加本地校验,在编辑后通过 git 钩子运行 validate-skills。
- 需要自动化浏览器操作(如导航、执行 JS、截图)的开发人员,使用 browser-tools.ts 脚本。
- 管理包含子模块的仓库,确保每个子仓库都正确引用共享代理指令。
- 技能作者希望创建新的可复用技能,遵循 SKILL.md 的 YAML front matter 规范并放入 skills/ 目录。
如何安装或部署这个 Agent?
克隆仓库:
git clone https://github.com/steipete/agent-scripts依赖:需要 macOS(因为 sync 脚本设计为 Mac 上运行)、git、可选 Bun(用于编译 browser-tools.ts)。初始化:运行 scripts/sync-skills 创建全局符号链接。配置 git 钩子:git config core.hooksPath hooks
如何使用这个 Agent?
确保你的项目引用共享指令:在 AGENTS.MD 中写入 READ ~/Projects/agent-scripts/AGENTS.MD BEFORE ANYTHING (skip if missing)。在 skills/ 下添加新技能,包含正确的 SKILL.md 格式,编辑后运行 scripts/validate-skills 校验。运行 scripts/sync-skills 同步技能和指令。对于 browser-tools.ts,可运行 bun build scripts/browser-tools.ts --compile --target bun --outfile bin/browser-tools 生成二进制,然后使用 start --profile、nav <url> 等命令。
这个 Agent 有哪些优点和局限?
- 明确的技能路由机制,通过 SKILL.md 的 YAML front matter 实现,描述简短,便于匹配。
- 脚本幂等且避免覆盖真实文件,安全地创建和管理符号链接。
- 提供独立的 browser-tools.ts,可基于 Chrome DevTools 进行浏览器自动化,无需额外依赖。
- 通过 validate-skills 和 docs-list.ts 提供验证工具,确保技能和文档质量。
- 主要针对 macOS 设计,在 Windows/Linux 上可能需要调整。
- 与 Codex 和 Claude Code 的特定行为耦合,可能随版本变化而不稳定。
- 依赖符号链接和特定路径(如 ~/Projects/agent-scripts),迁移到其他位置需要修改。
- 技能和规则是针对个人工作区(Peter 的),通用性有限,下游需要自定义。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Agent Scripts — 共享代理指令与技能 当前 | 55 · 缺口较多 | 命令行工具免费 | ★ 7.5k | 12 天前 | Shell | Codex · Claude Code |
| Better Harness | 76 · 存在缺口 | Agent 插件 / 技能免费 | ★ 2.4k | 4 天前 | JavaScript | Codex · Claude Code |
| Sovereign Skills 开发工作流套件 | 68 · 存在缺口 | Agent 插件 / 技能免费 | ★ 158 | 7 天前 | Python | Codex · Claude Code |
| VibeSkills — 智能技能编排器 | 64 · 存在缺口 | Agent 插件 / 技能免费 + 模型费 | ★ 3.8k | 2 天前 | Python | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
README 与技能说明了本地数据来源、同步链接的影响及部分防护;agent-transcript 明确禁止上传原始日志并要求检查裁剪结果,Beeper 技能提示数据库含私人消息。同步修复有 dry-run、白名单、身份重检和已完成操作报告,故数据处理与回滚有一定依据。扣分点:普通同步会创建、修剪链接;浏览器技能描述访问真实 Chrome 标签页,默认新配对共享所有符合条件的标签页;这些操作的确认门槛未统一规定,且依赖清单没有版本锁定或安全审计证据。署名与个人工作区说明了来源线索,但发布者身份未验证,不能据此确认身份。
README、AGENTS.MD、CI 和 release workflow 对技能校验、脚本语法、多个合成测试及发布检查相互支持;README 也记载特定修复的非原子性和检测范围。扣分点:仓库涵盖多种个人工作流,所给材料并非完整文件集,不能证明每项技能均有同等验证;依赖可用性与版本约束证据有限。
技能名称和描述提供了用途线索,示例覆盖本地消息搜索、浏览器控制、状态查询及多仓库技能同步;浏览器技能也标出 relay 与远程 Gateway 的边界。扣分点:内容主要面向维护者个人 macOS 工作区,若干命令硬编码 /Users/steipete 路径或依赖特定本地工具;对通用用户和非 macOS 环境的适配说明有限。
README 按技能、指令、辅助脚本、同步和发布组织内容,并提供安装/同步步骤、命名规则、例子及若干限制;LICENSE 明确为 MIT 并给出完整许可文本。扣分点:材料未显示常规版本变更日志,维护责任主要通过个人工作区和发布说明间接表达,缺少明确的维护承诺或支持渠道。
技能与轻量脚本把重复流程整理为可复用步骤,并给出状态输出字段、错误处理和使用示例,预期可改善特定仓库工作流。扣分点:这是个人用途的广泛工具与指令集合,部分场景依赖专属环境;材料没有量化节省或成本数据,通用收益及维护成本难以确认。
多项 README 说明可对应到具体技能、脚本和 CI 工作流;CI 列出合成测试,技能也对失败、不可用遥测和非原子修复作出明确描述。扣分点:本审查仅依据提供的静态材料,且样本不完整;README 中的运行表现与浏览器兼容声明不能在此独立复现,故不把它们当作已验证事实。
- 新浏览器配对默认共享所有符合条件的标签页;使用前应核对扩展配对与标签页共享模式。
- 部分技能绑定 Peter 的本地 macOS 路径或私人数据源;移植前需检查路径、权限和数据边界。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
0.12.0 Agent Scripts 0.12.0
发布说明摘录
Highlights - Turned maintainer-orchestrator into a long-running control plane for autonomous queue triage, proof-driven changes, dependency maintenance, and release proposals across Peter's repositories. - Added fleet maintenance, safe repository synchronization, package ownership audits, and Xcode fleet management for Peter's Macs. - Replaced the old Codex review path with isolated structured autoreview and added Claude Code-only codex-first delegation for implementation-heavy work. …在 GitHub 查看 ↗
常见问题
是否支持除 Codex 和 Claude Code 之外的其他代理?
在 Windows 上能否使用?
如何添加自己的技能?
同步脚本是否会覆盖我现有的配置?
Agent Scripts — 共享代理指令与技能 官网是什么?
Agent Scripts — 共享代理指令与技能 免费吗?
Agent Scripts — 共享代理指令与技能 开源吗?
Agent Scripts — 共享代理指令与技能 安全吗?
Agent Scripts — 共享代理指令与技能 还在维护吗?
Agent Scripts — 共享代理指令与技能 是谁开发的?
谢谢反馈,我们会据此改进页面。