Agent Scripts — 共享代理指令与技能

面向 Codex 和 Claude Code 的共享代理规则、可复用技能与轻量辅助脚本。

Star 数
★ 7.5k
最近更新
12 天前
License
MIT
主语言
Shell

30 秒速览

运行形态
命令行工具Agent 插件 / 技能
可在哪里用
平台专用Codex · Claude Code
费用
免费,无需付费服务
上手难度
中 · 需要几步配置
开始前需要
Bun(可选)git符号链接Shell / 命令行本地文件系统
典型场景
使用 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 ★

这个 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>' 等命令。

  1. 使用 Codex 或 Claude Code 的开发者希望统一不同仓库的代理规则,采用指针式 AGENTS.MD 引用共享文件。
  2. 在多个工作站之间同步技能和指令,通过运行 scripts/sync-skills 自动创建符号链接。
  3. 希望为技能添加本地校验,在编辑后通过 git 钩子运行 validate-skills。
  4. 需要自动化浏览器操作(如导航、执行 JS、截图)的开发人员,使用 browser-tools.ts 脚本。
  5. 管理包含子模块的仓库,确保每个子仓库都正确引用共享代理指令。
  6. 技能作者希望创建新的可复用技能,遵循 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?

FollowAgents 源码审查 · FARS-2.1
缺口较多
55/ 100 五分制 2.8 / 5
信任安全 13/29
可靠稳定 8/14
适用触发 10/18
规范维护 12/18
有效结果 7/13
证据核验 5/8
查看各维度的扣分理由
信任安全13 / 29 · 2.2/5

README 与技能说明了本地数据来源、同步链接的影响及部分防护;agent-transcript 明确禁止上传原始日志并要求检查裁剪结果,Beeper 技能提示数据库含私人消息。同步修复有 dry-run、白名单、身份重检和已完成操作报告,故数据处理与回滚有一定依据。扣分点:普通同步会创建、修剪链接;浏览器技能描述访问真实 Chrome 标签页,默认新配对共享所有符合条件的标签页;这些操作的确认门槛未统一规定,且依赖清单没有版本锁定或安全审计证据。署名与个人工作区说明了来源线索,但发布者身份未验证,不能据此确认身份。

可靠稳定8 / 14 · 2.9/5

README、AGENTS.MD、CI 和 release workflow 对技能校验、脚本语法、多个合成测试及发布检查相互支持;README 也记载特定修复的非原子性和检测范围。扣分点:仓库涵盖多种个人工作流,所给材料并非完整文件集,不能证明每项技能均有同等验证;依赖可用性与版本约束证据有限。

适用触发10 / 18 · 2.8/5

技能名称和描述提供了用途线索,示例覆盖本地消息搜索、浏览器控制、状态查询及多仓库技能同步;浏览器技能也标出 relay 与远程 Gateway 的边界。扣分点:内容主要面向维护者个人 macOS 工作区,若干命令硬编码 /Users/steipete 路径或依赖特定本地工具;对通用用户和非 macOS 环境的适配说明有限。

规范维护12 / 18 · 3.3/5

README 按技能、指令、辅助脚本、同步和发布组织内容,并提供安装/同步步骤、命名规则、例子及若干限制;LICENSE 明确为 MIT 并给出完整许可文本。扣分点:材料未显示常规版本变更日志,维护责任主要通过个人工作区和发布说明间接表达,缺少明确的维护承诺或支持渠道。

有效结果7 / 13 · 2.7/5

技能与轻量脚本把重复流程整理为可复用步骤,并给出状态输出字段、错误处理和使用示例,预期可改善特定仓库工作流。扣分点:这是个人用途的广泛工具与指令集合,部分场景依赖专属环境;材料没有量化节省或成本数据,通用收益及维护成本难以确认。

证据核验5 / 8 · 3.1/5

多项 README 说明可对应到具体技能、脚本和 CI 工作流;CI 列出合成测试,技能也对失败、不可用遥测和非原子修复作出明确描述。扣分点:本审查仅依据提供的静态材料,且样本不完整;README 中的运行表现与浏览器兼容声明不能在此独立复现,故不把它们当作已验证事实。

风险与缓解建议
  • 新浏览器配对默认共享所有符合条件的标签页;使用前应核对扩展配对与标签页共享模式。
  • 部分技能绑定 Peter 的本地 macOS 路径或私人数据源;移植前需检查路径、权限和数据边界。
证据充分度:低 评估于 2026年11月8日 审查版本 d210c0a77c8f
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/agent-scripts.svg?lang=zh)](https://followagents.com/zh/agents/agent-scripts)
<a href="https://followagents.com/zh/agents/agent-scripts"><img src="https://followagents.com/badge/agent-scripts.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. 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 之外的其他代理?
目前明确支持 Codex 和 Claude Code,其他代理可能需要手动配置,但核心规则和技能可移植。
在 Windows 上能否使用?
脚本是专为 Mac 设计的,Windows 上符号链接和路径可能不同,需要额外调整。
如何添加自己的技能?
创建 skills/<name>/SKILL.md,包含 YAML front matter,然后运行 validate-skills 和 sync-skills 来注册。
同步脚本是否会覆盖我现有的配置?
不会,sync-skills 不会覆盖真实文件,只会创建缺失的链接并修剪失效链接。
Agent Scripts — 共享代理指令与技能 官网是什么?
Agent Scripts — 共享代理指令与技能 的 GitHub 仓库填写的官网是 https://steipete.me。这个链接由仓库作者设置;源码在 GitHub(steipete/agent-scripts)。
Agent Scripts — 共享代理指令与技能 免费吗?
免费。Agent Scripts — 共享代理指令与技能 可以免费使用,不需要付费服务。
Agent Scripts — 共享代理指令与技能 开源吗?
开源。源码在 GitHub(steipete/agent-scripts),许可证是 MIT。
Agent Scripts — 共享代理指令与技能 安全吗?
FollowAgents 的 FARS 评审(2026年11月8日)给 Agent Scripts — 共享代理指令与技能 的“信任与安全”打了 13/29 分。评审检查的 8 项安全措施没有完全缺失的。
Agent Scripts — 共享代理指令与技能 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-10-30,在最近 30 天内。最新版本是 0.12.0(2026-07-17)。
Agent Scripts — 共享代理指令与技能 是谁开发的?
Agent Scripts — 共享代理指令与技能 由 GitHub 账号 steipete 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。