القائمة
为 Codex 仓库设计、审计或重构 AGENTS.md 层级；用于写/改/审计 AGENTS.md，不用于 CLAUDE.md 或 Cursor 规则。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف 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。