编写了一个技能，循环运行 codex /review，直到没有错误为止。注意：它不会修复系统架构，所以你仍然需要 BRAIN 作为主模型。https://t.co/0Z6iJnCqCX

steipete/agent-scripts

来源：https://github.com/steipete/agent-scripts

Agent 脚本

共享的代理指令、技能以及供 Peter 本地工作区使用的小型便携工具。本仓库是以下内容的规范存放位置：

• AGENTS.MD：用于 Codex/Claude 风格代理的共享硬性规则
• skills/：可复用的工作流技能，包括通过符号链接暴露的仓库自有技能
• scripts/：跨项目使用的低依赖辅助工具
• hooks/：本地护栏，如技能验证

技能

技能是主要的路由层。每个 skills/<技能名>/SKILL.md 包含 YAML front matter：

---
name: skill-name
description: "简短通用的触发短语。"
---

规则：

• 描述保持简短通用；优化路由，而非文档。
• 技能正文保持简洁和可操作性。
• 当工作流有重复命令时，优先使用 skills/<技能名>/scripts/ 下的辅助脚本。
• 编辑后验证：scripts/validate-skills。
• 在 front matter 中给 description 加引号。

全局发现通常指向此处：

• ~/.codex/skills -> ~/Projects/agent-scripts/skills
• ~/.claude/skills -> ~/Projects/agent-scripts/skills

共享技能作为真实文件夹存放在 skills/ 中。仓库自有技能保持在其仓库中的规范位置，并通过追踪的相对符号链接在此暴露，例如：

skills/discrawl -> ../../discrawl/.agents/skills/discrawl

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

代理指令

共享硬性规则存放在 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：

首先读取 ~/Projects/agent-scripts/AGENTS.MD（如果不存在则跳过）。

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

辅助工具

scripts/committer

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

scripts/validate-skills

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

scripts/docs-list.ts

• 遍历 docs/。
• 强制要求 summary 和 read_when front matter。
• 打印接入该工具仓库的新手指南摘要。

scripts/browser-tools.ts

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

同步

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

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

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