面向 AI 编程代理的跨仓库可复用脚本、技能模块与共享 guardrail 指令集合，充当多项目规范与工具的规范镜像。
agent-scripts 是由 Peter Steinberger 维护的跨仓库 AI 编程代理辅助工具与规范集合，以 MIT 协议开源，主要使用 Python、TypeScript、JavaScript 和 Shell 编写，当前尚无正式版本标签。
核心设计：规范镜像模式#
项目采用"规范镜像"（canonical mirror）模式，通过 AGENTS.MD 指针机制实现单一事实源的多仓库行为规范共享。下游仓库仅需在 AGENTS.MD 顶部写入 READ ~/Projects/agent-scripts/AGENTS.MD BEFORE ANYTHING 即可引用完整规则，无需复制。规范覆盖范围包括提交规范（Conventional Commits：feat/fix/refactor/build/ci/chore/docs/style/perf/test）、代码风格、PR 流程、CI 处理、安全策略及 Git 操作边界。Git 安全采用分层策略：默认仅允许 git status/diff/log（只读）；推送需用户明确请求；reset --hard、clean 等破坏性操作需用户显式同意。模型偏好记录了 Anthropic Opus 4.5/Sonnet 4.5、OpenAI GPT-5.2、xAI Grok-4.1 Fast、Google Gemini 3 Flash 等最新模型。
CLI 工具集#
- committer（
scripts/committer）：Bash 提交辅助脚本，精确暂存指定文件，强制非空提交消息。 - docs-list（
scripts/docs-list.ts）：遍历docs/目录，校验 front-matter（summary、read_when），输出文档摘要列表。 - browser-tools（
scripts/browser-tools.ts）：独立 Chrome DevTools 辅助工具，灵感来自 Mario Zechner 的 "What if you don't need MCP?" 文章，支持启动/检查 Chrome、导航、执行 JS、截图、搜索内容、检查元素、终止进程等。
技能模块（Skills）#
skills/ 目录包含 20+ 个可复用 agent 技能模块，部分由 @Dimillian 贡献：
| 类别 | 技能示例 |
|---|---|
| Apple 平台开发 | swift-concurrency-expert, swiftui-liquid-glass, swiftui-performance-audit, swiftui-view-refactor, instruments-profiling, native-app-performance |
| AI / 图像 | openai-image-gen, oracle |
| Web / 前端 | frontend-design, create-cli |
| 搜索 / 转换 | brave-search, markdown-converter, video-transcript-downloader |
| 运维 / 工具 | 1password, domain-dns-ops, discord-clawd, openclaw-relay, sonos-debug, xurl, speaking |
实现要点#
- 零依赖自包含原则：所有脚本不使用 tsconfig path aliases、不依赖共享源码目录，可在任意项目中独立运行。
- Bun 编译为独立二进制：TypeScript 脚本通过
bun build --compile编译为平台原生二进制，bin/目录不纳入版本控制。 - 同步策略：任何对共享脚本的修改需先同步回本仓库，再双向同步到所有下游仓库，保持字节一致。
安装与使用#
git clone https://github.com/steipete/agent-scripts.git
在目标仓库 AGENTS.MD 顶部添加指针引用，然后使用 Bun 编译 CLI 工具：
bun build scripts/docs-list.ts --compile --outfile bin/docs-list
bun build scripts/browser-tools.ts --compile --target bun --outfile bin/browser-tools
外部工具参考#
tools.md 记录了作者环境中可用的工具目录（bird、sonoscli、peekaboo、clawdis、oracle、mcporter 等），仅作参考不含实现。
待确认信息#
- 与 OpenAI Codex / Claude Code 的关系为约定式配合，无正式集成 SDK。
- skills 模块的 agent 发现与加载机制未明确说明。
- Bun 编译的最低版本要求未明确。