Community程式設計與開發github.com

steipete/agent-scripts

AI 代理指令集合,用於 Peter 的本地工作區,包含技能、腳本與鉤子。

agent-scripts 是什麼?

此技能項目為開發者的 AI 代理(如 Codex、Claude Code)提供一套集中的指令、可重用工作流程技能、輕量級輔助腳本及本機防護鉤子。它透過「AGENTS.MD」強制執行共享硬規則,並在「skills/」目錄下組織按名稱路由的技能,每個技能都包含 YAML 前置資料、簡潔描述與操作型內容。平台支援包括:針對 Codex 建立整個根目錄的符號連結,針對 Claude Code 建立單層扁平技能連結,並自動處理命名衝突與損壞連結。此外,它還提供同步、驗證和提交腳本,讓開發者只需執行一條命令,就能在多個儲存庫之間保持規則一致,無需重複複製內容。

相容平台✓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 的新對話。

說明文件

Agent 腳本

用於 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.

相關技能