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。