项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 7470
技术标签
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- 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/<name>/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/<name>/SKILL.md 是否已生成符号链接,并跑一次 scripts/validate-skills 无报错。
常见问题
Q:为什么要单独跑 sync-skills?
A:Codex 会扫描嵌套目录,可用整根链接;Claude Code 只加载 ~/.claude/skills/<name>/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/<name>/scripts/ 下作为辅助脚本。
核心亮点
- 脚本覆盖文件搜索、Git 操作等高频场景,直接提升智能体执行效率
- Shell 实现,轻量无重依赖,易于阅读和二次修改
- 作为作者多项目共享库,脚本经过真实使用打磨,实用性高
不足之处
- 文档/社区待观察
- 脚本主要面向作者自身项目,通用性和扩展性有待验证
适用场景
- 开发者为自己的 AI 智能体配置常用命令行工具链
- 集成到 CI/CD 流程中,让智能体自动执行代码维护任务
- 作为学习参考,了解如何为智能体设计高效的 Shell 脚本
替代项目
claude-code、shell-gpt、open-interpreter
上一篇:repoprompt-ce
下一篇:spacedock
同类项目推荐
Raven
开源
让 AI 代理记住一切,越用越聪明,自动完成深度研究。
The Harness of Harnesses • Super Agent: a trusted, persistent, self-evolving multi-···
jcodemunch-mcp
开源
翻代码省 95% 的钱,AI 随便查不心疼。
Symbol-level code retrieval for AI agents: fetch the function you need, not the whol···
DeepSeek-Bot
开源
组一队长期在线的 AI 机器人,让它们自己聊、自己干活
A team of long-lived bots for DeepSeek Harness, with main bots, bot-to-bot messages ···
loong
开源
用 Rust 从零搭自己的 AI 智能体,轻量可改
Lightweight, clear, and fully extensible AI agent infrastructure — learn easily, cu···
EvoCUA
开源
让AI学会操作电脑,自动搞定跨应用任务
EvoCUA: Evolving Computer Use Agent
KADATH
开源
让智能体像生物一样进化,自动迭代逼近最优解
Evolutionary multi-agent runtime that breeds, evaluates, and improves autonomous age···
flyai-skill
开源
给 AI Agent 装现成技能,少写工具代码
fly ai agent skill
autogen
开源
用代码编排多智能体,搞定复杂AI任务
A programming framework for agentic AI
claude-code-source-code
开源
扒开 Claude Code 的底裤,看 AI 智能体是怎么炼成的
Claude code source code
