代理脚本
用于 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。