agent-scripts

给AI智能体一套现成脚本，让命令行操作更顺手

agent-scripts 是一个为 AI 智能体（如 Claude、GPT 等）提供共享脚本的仓库，主要用 Shell 编写。它解决的是智能体在命令行环境中执行复杂任务时缺乏标准工具和脚本的问题，通过提供一系列可复用的脚本，让智能体能更高效地完成文件操作、代码搜索、环境配置等常见任务。核心能力包括：为智能体提供统一的命令接口，简化与文件系统、Git 仓库、开发环境的交互；脚本设计轻量、依赖少，易于集成到各种 AI 工作流中；同时作为作者多个项目间的公共基础设施，保证了脚本的实用性和稳定性。项目本身是成长中的开源工具，适合希望增强智能体自主操作能力的开发者。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 6641

维护状态活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队steipete

所属国家

官网地址https://steipete.me

GitHubhttps://github.com/steipete/agent-scripts

定价模式free

价格说明开源项目，MIT许可证，完全免费，无付费版本。

访问状态

是否开源是

开源协议MIT

主要语言Shell

技术栈/模型ai-agents

GitHub 星标★ 6641

30天Star增速

HF 下载量

上线时间2025-11-08 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

macOS 等类 Unix 环境（README 以 Mac 为例）
已安装 git，可克隆 GitHub 仓库
Shell 环境，可直接执行仓库内 scripts/ 下的脚本
克隆位置建议为 ~/Projects/agent-scripts，与默认符号链接路径一致

安装与启动步骤

1克隆仓库

把仓库克隆到 ~/Projects/agent-scripts，README 中的符号链接默认指向该路径，换路径需自行调整。
```
git clone https://github.com/steipete/agent-scripts.git ~/Projects/agent-scripts
```
2进入仓库目录

后续的同步与校验脚本都需在仓库根目录下执行。
```
cd ~/Projects/agent-scripts
```
3查看共享硬规则

AGENTS.MD 存放 Codex/Claude 风格智能体共用的硬性规则，建议先阅读再改脚本。
```
cat AGENTS.MD
```
4同步 skills 链接

运行 scripts/sync-skills，为 Codex 生成整根目录链接，为 Claude Code 生成一级扁平链接；幂等，可反复执行。
```
scripts/sync-skills
```
5校验 skills

每次编辑 skills 后用 scripts/validate-skills 校验 front matter 与结构是否合规。
```
scripts/validate-skills
```
6编写 SKILL.md

每个 skills//SKILL.md 顶部需写 YAML front matter，description 要加引号且保持简短通用，便于路由。
```
---
name: skill-name
description: "Short generic trigger phrase."
---
```

关键配置

配置项	必填	说明	示例
`name`	是	SKILL.md front matter 中的技能名称	`skill-name`
`description`	是	简短通用的触发描述，用于路由而非文档，需加引号	`"Short generic trigger phrase."`

如何确认成功

同步后检查 ~/.codex/skills/agent-scripts 与 ~/.claude/skills//SKILL.md 是否已生成符号链接，并跑一次 scripts/validate-skills 无报错。

常见问题

Q：为什么要单独跑 sync-skills？

A：Codex 会扫描嵌套目录，可用整根链接；Claude Code 只加载 ~/.claude/skills//SKILL.md 一层，需要扁平化的逐技能链接，所以要单独生成。

Q：sync-skills 会重复创建链接吗？

A：不会。README 说明该脚本是幂等的，克隆后或新增技能后每次都可以放心重跑。

Q：Claude Code 能识别分类子目录吗？

A：不能。README 注明只扫描一层且不扫描分类子目录，但会跟随每个技能的符号链接。

Q：修改技能后需要做什么？

A：先跑 scripts/validate-skills 校验，再跑 scripts/sync-skills 让改动同步到各智能体的技能目录。

注意事项

README 只给出 skills 同步与校验脚本，未提供包管理安装命令，本教程不涉及依赖安装。
克隆路径须与符号链接目标 ~/Projects/agent-scripts/skills 对齐，否则同步结果不可用。
description 必须用引号包裹，描述保持简短通用，正文保持精简、偏操作性。
工作流有可重复命令时，优先放到 skills//scripts/ 下作为辅助脚本。

核心亮点

脚本覆盖文件搜索、Git 操作等高频场景，直接提升智能体执行效率
Shell 实现，轻量无重依赖，易于阅读和二次修改
作为作者多项目共享库，脚本经过真实使用打磨，实用性高

不足之处

文档/社区待观察
脚本主要面向作者自身项目，通用性和扩展性有待验证

适用场景

开发者为自己的 AI 智能体配置常用命令行工具链
集成到 CI/CD 流程中，让智能体自动执行代码维护任务
作为学习参考，了解如何为智能体设计高效的 Shell 脚本

替代项目

claude-code、shell-gpt、open-interpreter

项目介绍

agent-scripts 是智能体领域的开源项目，由 steipete 开发，2025 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（6,641）位列前 7%，在智能体分类的 2,499 个项目里位列前 7%。

近 44 天，它的 GitHub 星标从 6,520 增加到 6,641，净增 121。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。MIT许可证，完全免费，无付费版本。

它主要面向的使用场景是：开发者为自己的AI智能体配置常用命令行工具链。同类可对比的替代方案包括 claude-code、shell-gpt、open-interpreter。

上一篇：repoprompt-ce

下一篇：spacedock