Community编程与开发github.com

steipete/agent-scripts

共享代理指令、技能和便携式辅助脚本,用于 Peter 的本地工作空间。

agent-scripts 是什么?

这是一个为 AI 代理(如 Codex、Claude Code)设计的技能和辅助脚本仓库,由 `steipete/agent-scripts` 维护。它作为共享的硬规则(`AGENTS.MD`)、可复用的工作流技能(`skills/` 目录下的 SKILL.md)、轻量级依赖的辅助脚本(`scripts/`)和本地防护钩子(`hooks/`)的中央仓库。 该仓库的核心功能是通过 `scripts/sync-skills` 脚本实现跨平台(Codex 和 Claude Code)的技能发现和同步,支持技能文件通过符号链接跨多个仓库共享,并处理名称冲突。它特别强调描述简短、操作性强,并优先使用辅助脚本处理重复性工作流命令。 除了技能路由层,它还提供了多个实用辅助脚本,如 `committer`(强制非空提交信息并进行技能验证)、`validate-skills`(验证所有 SKILL.md 的 YAML 前置元数据)和 `browser-tools.ts`(Chrome DevTools 自动化工具,支持配置文件、导航、截图、控制台、网络请求和搜索等命令)。 对于下游仓库,它推荐使用指针式 `AGENTS.MD`(`READ ...` 指令),而非直接复制共享规则,并强调保持脚本的依赖无关性和可移植性。

兼容平台✓Claude Code✓Codex CLI~Cursor
npx skills add steipete/agent-scripts

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

代理脚本

用于 Peter 本地工作空间的共享代理指令、技能和小型便携式辅助工具。

此仓库是以下内容的规范位置:

  • AGENTS.MD:用于 Codex/Claude 风格代理的共享硬规则
  • skills/:可重用工作流技能,包括通过符号链接暴露的仓库自有技能
  • scripts/:跨项目使用的轻量级依赖辅助脚本
  • hooks/:本地防护钩子,如技能验证

技能

技能是主要的路由层。每个 skills/<name>/SKILL.md 包含 YAML 前置元数据:

---
name: skill-name
description: "短泛型触发短语。"
---

规则:

  • 保持描述简短且泛型;优先考虑路由,而非文档。
  • 保持技能主体简洁且可操作。
  • 当工作流有重复命令时,优先使用 skills/<name>/scripts/ 下的辅助脚本。
  • 编辑后运行:scripts/validate-skills。
  • 在前置元数据中为 description 加引号。

全局发现由 scripts/sync-skills 构建(幂等;克隆或添加技能后在每台 Mac 上运行):

  • Codex 扫描嵌套目录,因此获得整根链接:~/.codex/skills/agent-scripts -> ~/Projects/agent-scripts/skills,~/.codex/skills/manager -> ~/Projects/manager/skills。
  • Claude Code 仅加载 ~/.claude/skills/<name>/SKILL.md(恰好一层深度;按条目跟随符号链接,不扫描类别子文件夹——已在 2.1.197 上验证)。它获得一个扁平化的每技能链接镜像,涵盖两个仓库以及特定机器的 ~/.codex/skills/<name> 额外内容。
  • 名称冲突时,优先级为 agent-scripts > manager > codex-local;脚本打印跳过的重复项并修剪损坏/过时的管理链接。

共享的个人技能以真实文件夹形式存在于 skills/ 中。公共的 OpenClaw 共享技能位于 ../agent-skills 中,并通过跟踪的相对符号链接在此暴露。仓库自有技能保留在其各自仓库的规范位置,并同样在此暴露,例如:

skills/autoreview -> ../../agent-skills/skills/autoreview
skills/discrawl -> ../../discrawl/.agents/skills/discrawl

当前符号链接的仓库自有技能包括 birdclaw、discrawl、gog、imsg、slacrawl、wacli 和 wacrawl。

代理指令

共享硬规则位于 AGENTS.MD 中。

全局设置(也由 scripts/sync-skills 维护;Claude Code 仅读取 CLAUDE.md,因此链接到共享的 AGENTS.MD):

  • ~/.codex/AGENTS.md -> ~/Projects/agent-scripts/AGENTS.MD
  • ~/.claude/CLAUDE.md -> ~/Projects/agent-scripts/AGENTS.MD
  • ~/.claude/AGENTS.md -> ~/Projects/agent-scripts/AGENTS.MD

下游仓库应使用指针式 AGENTS.MD:

READ ~/Projects/agent-scripts/AGENTS.MD BEFORE ANYTHING (skip if missing).

仓库特定规则放在该指针下方。不要将共享块复制到下游仓库中。

辅助工具

scripts/committer

  • 仅暂存列出的文件。
  • 强制非空提交信息。
  • 在提交前运行技能验证。

scripts/sync-skills

  • 构建每台机器的技能镜像:Codex 整根链接、Claude 扁平每技能链接、共享的 AGENTS.MD 指针。
  • 幂等;仅打印更改,修剪损坏/过时的管理链接,从不破坏真实文件。

scripts/validate-skills

  • 检查每个 skills/*/SKILL.md。
  • 验证 YAML 前置元数据以及必需的 name 和 description。
  • 通过 git config core.hooksPath hooks 启用为本地钩子。

scripts/docs-list.ts

  • 遍历 docs/。
  • 强制要求 summary 和 read_when 前置元数据。
  • 为接入的仓库打印入职摘要。

scripts/browser-tools.ts

  • 独立的 Chrome DevTools 辅助工具。
  • 常用命令:start --profile、nav <url>、eval '<js>'、screenshot、console、network、search --content "<query>"、content <url>、inspect、kill --all --force。
  • 使用 bun build scripts/browser-tools.ts --compile --target bun --outfile bin/browser-tools 构建可选二进制文件。

同步

将此仓库视为共享代理规则和便携辅助脚本的规范来源。

同步下游仓库时:

  • 先在此处拉取最新版本。
  • 确保每个目标仓库以指针式 AGENTS.MD 开头。
  • 在指针下方保留仓库本地规则。
  • 仅当辅助脚本旨在保持字节完全一致时,才双向复制辅助脚本更改。
  • 保持脚本无依赖且便携;不要使用仓库特定的导入或路径别名。

对于子模块,在每个子仓库内重复指针检查,推送这些更改,然后在父仓库中更新子模块 SHA。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

相关技能