@steipete: 如果你运行这个工作流，让 Fable 把 codex 作为主力工具。https://github.com/steipete/agent-scripts/blob/main/sk…

如果你运行此工作流，请让 Fable 成为 codex 的主力工具。https://github.com/steipete/agent-scripts/blob/main/skills/codex-first/SKILL.md… — # steipete/agent-scripts 来源：https://github.com/steipete/agent-scripts # Agent Scripts 供 Peter 本地工作区使用的共享 agent 指令、技能和小型便携辅助工具。 本仓库是以下内容的权威位置： - AGENTS.MD：Codex/Claude 风格 agent 的共享硬性规则 - skills/：可重用的工作流技能，包括通过符号链接暴露的仓库自有技能 - scripts/：跨项目使用的依赖精简辅助工具 - hooks/：本地护栏，例如技能验证 ## 技能 技能是主要的路由层。每个 skills/<技能名称>/SKILL.md 都包含 YAML 前置元数据： yaml --- name: skill-name description: "简短通用的触发短语。" --- 规则： - 描述保持简短通用；优先考虑路由而非文档。 - 技能主体保持简洁且可操作。 - 当工作流有重复性命令时，优先使用 skills/<技能名称>/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/<技能名称>/SKILL.md（恰好一层深度；会跟随每个条目的符号链接，但不会扫描类别子文件夹——已在 2.1.197 版本上验证）。它会获得一个扁平的每技能链接镜像，涵盖两个仓库以及机器本地的 ~/.codex/skills/ 额外内容。 - 名称冲突的解决顺序：agent-scripts > manager > codex-local；该脚本会打印跳过的重复项，并清理损坏/过时的托管链接。 共享的个人技能作为真实文件夹存放在 skills/ 中。公共的 OpenClaw 共享技能存放在 ../agent-skills 中，并通过跟踪的相对符号链接在此暴露。仓库自有技能在其自己的仓库中保持权威，并以相同方式在此暴露，例如： text skills/autoreview -> ../../agent-skills/skills/autoreview skills/discrawl -> ../../discrawl/.agents/skills/discrawl 当前符号链接的仓库自有技能包括 birdclaw、discrawl、gog、imsg、slacrawl、wacli 和 wacrawl。 ## Agent 指令 共享硬性规则存放在 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： text 在任何操作之前阅读 ~/Projects/agent-scripts/AGENTS.MD（如果缺失则跳过）。 仓库特定的规则放在该指针下方。不要将共享块复制到下游仓库中。 ## 辅助工具 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 ""、content <path>、inspect、kill --all --force。 - 使用 bun build scripts/browser-tools.ts --compile --target bun --outfile bin/browser-tools 构建可选的二进制文件。 ## 同步 将此仓库视为共享 agent 规则和便携辅助脚本的权威来源。同步下游仓库时： - 首先在此拉取最新内容。 - 确保每个目标仓库以指针样式的 AGENTS.MD 开头。 - 保留指针下方的仓库本地规则。 - 仅在辅助脚本需要保持字节一致时，才双向复制辅助工具的更改。 - 保持脚本无依赖且便于移植；不包含仓库特定的导入或路径别名。 对于子模块，在每个子仓库内重复指针检查，推送这些更改，然后在父仓库中更新子模块的 SHA。 > ClaudeDevs (@ClaudeDevs): > 以下是我们在 Fable 5 中经常使用的几个模式： > > 将 Fable 5 用作“顾问”。 > > 执行器（Sonnet 5）调用 Fable 5 寻求指导。 > > 大部分 token 按较低的执行器费率计费。