Menú
为 Codex 仓库设计、审计或重构 AGENTS.md 层级；用于写/改/审计 AGENTS.md，不用于 CLAUDE.md 或 Cursor 规则。
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
Use only when the user explicitly invokes this skill to map unresolved product, domain, repository, or delivery unknowns before choosing a path.
Use only when the user explicitly invokes this skill to create or resume a persistent file-based goal tracker across sessions.
Use only when the user explicitly invokes this skill to stress-test an existing plan or design through one load-bearing question at a time.
Use only when the user explicitly invokes this skill to evaluate a skill with representative cases, isolated runs, independent judging, and evidence-driven edits.
Use for a concrete defect or regression that needs reproduction, root-cause diagnosis, a fix, and regression validation. Do not trigger for routine localized edits or primarily performance-focused work.
Use when the requested feature genuinely spans at least two delivery layers such as frontend, backend, API, data, scripts, or tests. Do not expand a single-layer change into a full-stack workflow.
| name | core-codex-agents-md-builder |
| description | 为 Codex 仓库设计、审计或重构 AGENTS.md 层级；用于写/改/审计 AGENTS.md，不用于 CLAUDE.md 或 Cursor 规则。 |
| metadata | {"version":"0.4","updated":"2026-07-23"} |
不适用：CLAUDE.md / Cursor 规则 / 其他格式；仅询问"AGENTS.md 是什么"的解释类问题。
四件事讲清整个任务的前提：
AGENTS.override.md，同目录普通 AGENTS.md 会被替换，必须先暂停确认。完整加载模型、字节预算、override.md 处理、沙箱限制：见 references/loading-model.md。
只用三种，不要再细分。
| 目录类型 | 选哪个模板 | 是否必须创建 |
|---|---|---|
| 仓库根 | Root router | 是 |
| 应用、服务、共享库、有独立职责边界的业务模块 | Domain card | 有边界风险/不变量/专属验证时才创建 |
| infra / migrations / auth / payments / secrets / generated / vendor 等高风险或只读 | Guardrail card | 该目录存在且会被手动改时通常创建 |
| 纯组织层级目录、无独立规则、无专属验证 | 不创建 | 否 |
判定原则：只在有实际价值时创建。不要为了覆盖率给纯组织目录建空 AGENTS.md。
三类模板的完整结构和示例：见 references/card-templates.md。
识别六件事：技术栈、目录职责、已有 AGENTS.md/override.md、命令（test/lint/build/codegen/migration）、高风险目录、生成/只读目录。
Git 操作只允许只读命令：git status、git diff、git ls-files、git rev-parse、git log。
普通仓库探索允许使用只读文件命令，如 pwd、find、rg、sed、cat、head、wc。
完整探索清单（必查项 / 推荐命令 / 忽略目录 / 预算控制）：见 references/output-format.md 的探索清单段。
在对话里输出一份简短策略，不要创建 AGENTS_PLAN.md 或类似计划文件。
必须包含：
输出后直接进入 Step 3，不等用户确认。除非命中下方"暂停条件"。
必须包含：仓库目的、Codex 启动行为、目录地图（含 Local AGENTS.md 列和 Read when 列）、按需 cat 协议、关键命令复述、全局规则、Do not、Validation 标准。
按 references/instruction-types.md 区分 Principle、Rule、Convention、Procedure：
根文件只保留跨目录判断、可验证规则、全局约定和必要的流程入口，不把局部操作
流程伪装成全局原则。
目标长度 8–16 KiB，硬上限 25 KiB。
完整模板和必含元素：见 references/card-templates.md 的 Root router 段。
Domain card 或 Guardrail card，单文件 0.5–2 KiB。
只在第 3 节"判定"通过时写。无独立价值的目录不写。
用四类指令决定内容落点：Domain card 只写本模块特有 Principle/Rule/Convention/ Procedure；Guardrail card 优先写有触发条件和验证方式的 Rule，以及有完成/停止 条件的 Procedure。不要重复上级规则。
完整模板见 references/card-templates.md 的对应段。
自检清单和中文最终汇报格式：见 references/output-format.md 的自检 + 汇报段。
同时检查：
AGENTS.override.md，或判断需要创建 / 修改 override，停下来询问用户。git add / git commit / git reset / git checkout / git clean / git stash。只用 git status / git diff / git ls-files / git rev-parse / git log。package.json scripts、Makefile、pyproject.toml、CI 配置、官方文档中确认存在。不编造。不确定就写"不确定"并指回根命令。AGENTS.override.md，会屏蔽同目录普通 AGENTS.mdAGENTS.override.md其他情况一律继续执行，不要反复请示。
| 文件 | 何时读 |
|---|---|
references/loading-model.md | 开始前必读：Codex 加载模型、字节预算、override.md 处理、沙箱限制、与 README 的关系 |
references/card-templates.md | Step 3、4 写文件时：三类卡片完整模板、必含元素、禁止事项、最短形式示例 |
references/output-format.md | Step 1 探索时 + Step 5 汇报时：探索清单、推荐命令、忽略目录、自检项、中文最终汇报格式 |
references/instruction-types.md | Step 2–5：判断 Principle、Rule、Convention、Procedure 的落点和硬检查 |
按需读取，不要一次性全读。SKILL.md 本身的判断和约束足够覆盖大多数决策；只在写具体内容、收尾汇报、或对加载模型有疑问时才打开对应 references。