AI 技能AI 插件【免费下载链接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,445 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址https://gitcode.com/gh_mirrors/an/agentic-awesome-skills点击查看免费下载在 AASagentic-awesome-skills仓库的codex-delegate技能中编排者orchestrator把有界编码任务委派给独立的 OpenAI Codex CLI 实现者implementer再自行审查并提交。整个闭环的前提是一份高质量 brief——它是 Codex 唯一能看到的任务输入。本指南以 writing-the-brief.md 为骨架结合同技能下的 SKILL.md、dispatch-and-poll.md 与 review-and-land.md 展开。读完你将掌握Codex 的盲执行上下文模型、四块 XML 骨架的写法、按任务类型选配扩展块、真实门禁gate命令的发现方法以及一份可直接套用的完整 brief 示例。认识盲执行的 Codexbrief 就是全部上下文编写 brief 的第一个前提是理解 Codex 的执行环境。根据 writing-the-brief.md 的描述Codex 运行在一个全新的进程中没有你对话的记忆、没有你此前笔记的访问权、没有任何共享上下文——它只能看到你发送的文本以及它能从工作树working tree中读取的内容包括仓库自带的AGENTS.mdCodex 会自动读取它。由此推出一个核心结论如果某个约束没有写进 brief也不在仓库里可发现那对 Codex 而言它就不存在。文档明确指出委派失败最常见的原因就是 brief 假定了 Codex 并不拥有的上下文a brief that assumes context Codex doesnt have。因此在撰写时目标、当前状态、要改什么、不要碰什么、用什么命令验证都必须完整落进文本。这一定位也解释了为什么本技能把编排闭环设计成 brief → dispatch → poll → review → commit实现者只负责在隔离沙箱里打字验证与落地责任始终属于编排者。技能在 SKILL.md 的 Limitations 中明确写着 Relay never commits — it only returns structured result JSON; you review and land the commit即 relay 只返回结构化的result.json提交动作由编排者完成——brief 中的action_safety块正是为此服务的。有效的形状紧凑的分块 XML 结构Codex 对紧凑、块状结构的提示词响应最佳——使用 XML 标签而非长段落散文。文档给出的核心原则是陈述任务、定义完成的样子、规定默认行为方式以及列出真正要紧的少数约束只有当任务确实需要时才增加块不要为了仪式感堆砌空块dont ship empty ceremony。四块骨架覆盖绝大多数实现类任务文档提供了以下可直接复制的骨架模板task One or two sentences: the concrete job and where it lives. Then the specifics — current state, what to change, and explicitly what to leave untouched. The leave untouched list is what keeps Codex from wandering into unrelated refactors. /task verification_loop Run these before finishing and fix anything they surface, dont just report it: the projects real test command the projects real lint/format command the projects real build/typecheck command Confirm the working tree shows only the intended changes afterward. /verification_loop action_safety Keep changes scoped to the task. No unrelated refactors, renames, or cleanup unless required for correctness. Do NOT run git add or git commit — you cannot reliably write .git, and the orchestrator commits after reviewing. Leave the work uncommitted in the working tree. /action_safety structured_output_contract End with a report in this exact shape: 1. What changed and why 2. Files touched 3. Gate outcomes (paste the test/lint counts) 4. Anything you deviated on, left open, or want a decision on /structured_output_contract四个块各自的职责块解决什么问题关键要点task任务本体一两句话给出具体工作和位置再补充现状、改动点以及明确列出不要动的清单防止 Codex 游荡到无关重构verification_loop完成判据写出项目真实的 test / lint / build 命令并要求修复而非仅报告最后确认工作树只含预期改动action_safety行为边界严格限定改动范围禁止无关重构、重命名与清理禁止git add/git commit因为 Codex 无法可靠写入.git提交由编排者审查后完成structured_output_contract输出契约强制以固定四段式收尾报告改了什么及原因 / 触碰的文件 / 门禁结果粘贴计数/ 偏离、遗留与待决策项这个骨架之所以有效是因为它在 prompt 层面把做什么、怎样算完成、不许做什么、如何汇报四件事全部显式化杜绝了 Codex 对隐含约定的猜测。按任务画像选配的扩展块四块骨架覆盖大多数实现任务当任务画像不同时文档建议按需追加不是全部都要调试 / 开放式修复追加completeness_contract彻底解决不要在第一个貌似合理的修复处就停与missing_context_gating不要猜测缺失的仓库事实要么找到它们要么明确说明哪些未知。审查 / 诊断只读追加grounding_rules每个论断都必须有证据支撑并标注推断——配合--read-only运行使 Codex 无法编辑任何文件。研究 / 建议追加research_mode把观察到的事实、推断、悬而未决的问题分开呈现。从源码结构看这些扩展块对应着不同的委派模式--read-only在 relay 中即--sandbox read-only的快捷方式见 dispatch-and-poll.md适用于审查类任务而只读模式也被 SKILL.md 用于获取对抗性第二意见adversarial second opinion——列出双方立场请 Codex 逐点辩护或让步全程不触碰文件。发现真实门禁不要硬编码命令verification_loop只有在写入了项目实际命令时才有价值。文档给出的做法是先读仓库的CLAUDE.md/AGENTS.md/Makefile/package.json把真实的命令抄进去——make test、npm run lint、cargo test、pytest -q项目用什么就写什么。这是一个容易被低估的失败点brief 只写 run the tests 而不指名命令得到的往往是 Codex 的猜测——或者干脆跳过。门禁命令是编排者后续审查的验证基准这一点在 review-and-land.md 中被反复强调result.json里 Codex 自带的门禁通过声明只能视为主张而非证据编排者必须在工作树中亲自重跑这些 test / lint / build 命令并阅读输出。尊重仓库约定AGENTS.md 之外的关键禁令要复述Codex 会自动读取仓库的AGENTS.md因此其中的家规代码风格、禁止模式、提交约定天然生效。但文档特别提醒如果项目在代码中禁止某些东西——比如注释里的 spec/ticket ID、MVP/for now/phase N 这类过程语言、特定的测试约定以及仓库自己的约定所禁止的一切——把其中承重load-bearing的条款在 brief 里再复述一遍。原因是 Codex 的合规程度只取决于它眼前有什么只存在于 AGENTS.md 深处的规则不如 brief 内显式重申的规则可靠。注意这里有个顺序问题AGENTS.md 是自动生效的底线brief 复述是针对本次任务的强化。两者不冲突但复述应当只挑承重条款而不是把整个 AGENTS.md 抄进 brief——否则又违背了紧凑、无空仪式的原则。一个 brief 一个任务保持边界清晰文档对任务粒度给出了硬性要求每个 brief 只装一个单一、有界的任务。像 Review this, fix what you find, update the docs, and suggest a roadmap 这种多动词拼盘会产生一团混乱的 run应当拆分成多次独立派发。One brief → one Codex run → one commit 带来三个可验证的好处审查与回滚都干净——单个步骤可以独立回退后续任务可以安全地假设前一个任务已经落地brief 里可以写 the X added in the previous step exists每次审查都是诚实的——派发前工作树干净touchedFiles只会显示本次任务的改动而不是前面任务的堆积。这个串行、每任务一提交的纪律在 multi-task-queues.md 中被推广为队列运行的标准姿势按依赖顺序一次跑一个任务每个任务完成审查 门禁 提交后再派发下一个并把后续任务依赖的前置事实折进该任务的 briefCodex 对早先的 run 没有记忆任务 2 冒出的约束必须写进任务 5 的 brief 才有效。派发时冻结前提中途无法转向brief 发出后实现者会从 brief 的事实出发执行而运行中途不存在转向通道no steering channel mid-run。文档因此在派发前给出一个硬性动作审计事实块——ownership、目标分支、约束以及任何判断决策所依赖的要素。如果 run 进行中才发现某个前提是错误的正确的做法不是事后给输出打折而是停止该 run重新派发一份修正过的 brief对于可写write-capable的 run先检查工作树调和任何部分完成或受污染前提影响的编辑——决定保留还是回退——然后再重新派发。这与此技能的总体定位一致实现者在沙箱里产出编排者对工作树拥有最终解释权。事实上 dispatch-and-poll.md 进一步说明relay 把result.json与事件日志events.jsonl写入临时目录正是为了让待审查的仓库保持干净使touchedFiles报告只反映 Codex 自身的编辑。预期回复中的环境前缀噪音Codex 的最终消息可能在你要的报告之上携带环境噪音——比如仓库AGENTS.md注入的横幅、你配置的 MCP 工具或扩展追加的文本等。文档明确指出这些来自你自己的 Codex 配置不是 relay 的缺陷。应对手段正是structured_output_contract要求一个清晰分隔的报告区段这样无论外面包裹了什么你都能定位到真正的输出。这与 relay 的行为衔接良好——dispatch-and-poll.md 说明result.json的finalMessage字段承载的就是 Codex 的最终报告即你在structured_output_contract里要求的那份并且会完整打印在 stdout 的报告标记之间。完整工作示例退款幂等性修复文档末尾给出了一份可直接发送的完整 brief这里完整保留并附上每块的落地说明task In the payments service at services/billing/, the refund path double-charges when a refund is retried after a network timeout (the idempotency key isnt checked before re-submitting). Make the refund submission idempotent: check for an existing refund by idempotency key before creating a new one. Touch only services/billing/refund.py and its tests. Leave the charge path, the API routes, and the data models untouched. /task verification_loop Run and make green before finishing: pytest tests/billing/ -q ruff check services/billing/ Confirm git status shows only refund.py and its test file changed. /verification_loop action_safety Scope strictly to the refund idempotency fix. No unrelated refactors. Do NOT git add or commit; leave changes in the working tree for review. /action_safety structured_output_contract Report: (1) the root cause and your fix, (2) files touched, (3) pytest ruff outcomes with counts, (4) anything you left open or want decided. /structured_output_contract这份示例值得逐块拆解其设计意图task第一句给出问题场景与位置services/billing/退款路径、网络超时重试导致重复扣费、缺少幂等键检查第二句给出具体修复方向提交前按幂等键查重Touch only ... Leave ... untouched 两句把边界钉死明确排除了 charge 路径、API 路由与数据模型。verification_loop不是空话而是指名了pytest tests/billing/ -q与ruff check services/billing/两个真实命令并附带git status 只显示两个文件改动的完成判据——这正是发现真实门禁不要硬编码原则的落地。action_safety重申范围纪律与不提交禁令。structured_output_contract的四项输出与 review 阶段直接衔接根因与修复、触碰文件、门禁计数、遗留问题恰好是 review-and-land.md 中读 diff 对照 brief所需的全部信息。发送时使用 relay 助手见 dispatch-and-poll.md典型命令形如node skill-dir/scripts/relay.mjs --brief brief.txt --cd /path/to/repo其中skill-dir是codex-delegate技能的安装目录包含其SKILL.md的目录在 Claude Code 中即加载技能时打印的 Base directory for this skill。派发后审查结果、自行提交见 review-and-land.md。小结brief 是委派闭环的第一道质量关卡把本技能的全部材料连起来看brief 写作处在闭环的源头brief 的质量决定了 Codex 产出的上限也决定了编排者审查成本的下限。核心要点可以收敛为七条默认无上下文——Codex 是全新进程所有任务信息必须显式进 brief分块 XML 优于长散文——task/verification_loop/action_safety/structured_output_contract四块打底按任务类型追加扩展块门禁必须是真实的——从仓库的CLAUDE.md/AGENTS.md/Makefile/package.json里抄真实命令复述承重禁令——AGENTS.md 之外把最关键的约束在 brief 里再说一遍一任务一 brief——边界清晰审查与回滚干净派发即冻结前提——运行中无法转向错了就停、修、重派用输出契约对抗噪音——固定四段式报告保证从任何环境包裹中都能提取真结果。撰写本文所依据的完整资料均位于仓库内核心指南 writing-the-brief.md、技能总览 SKILL.md、派发与轮询 dispatch-and-poll.md、审查与落地 review-and-land.md、以及多任务队列 multi-task-queues.md。赞分享AI 技能AI 插件【免费下载链接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,445 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址https://gitcode.com/gh_mirrors/an/agentic-awesome-skills点击查看免费下载相关推荐Open Interpreter 提示词工程实战为编码 Agent 写出可安全执行的高质量 PromptOpen Interpreter 提示词工程实战为编码 Agent 写出可安全执行的高质量 Prompt 本文基于仓库 docs/prompting.md h人工智能大模型AI Agent代码智能体AI 应用CLI使用 Aider Delegate 技能以 Aider 为执行者、编排者把关提交的受控委派工作流使用 Aider Delegate 技能以 Aider 为执行者、编排者把关提交的受控委派工作流 Aider Delegate 是 agentic awesoAI 技能AI 插件编写有效的 Claude Delegate 任务简报Brief跨会话委派上下文传递的完整实践指南编写有效的 Claude Delegate 任务简报Brief跨会话委派上下文传递的完整实践指南 导读 在 Agentic Awesome SkillsAI 技能AI 插件上一篇Nunjucks分布式缓存Redis与Memcached集成下一篇Playwright自动化测试最佳实践15个技巧让你的测试脚本更稳定创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
